# worldmonitor: bảng điều khiển tin tức và địa chính trị thời gian thực — hướng dẫn cài đặt và dùng

> World Monitor (repo koala73/worldmonitor) là bảng điều khiển tình báo toàn cầu mã nguồn mở. Nó gom tin tức, bản đồ, thị trường tài chính, xung đột, an ninh mạng và hạ tầng vào một giao diện, có AI tóm tắt. Bạn có thể dùng ngay trên web, chạy bằng một lệnh trong terminal, hoặc tự dựng bằng Docker. Cài không khó nếu bạn làm theo đúng từng bước.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-09-23 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/worldmonitor-bang-dieu-khien-tin-tuc-dia-chinh-tri-thoi-gian-thuc

World Monitor là một bảng điều khiển "nắm tình hình thế giới" mã nguồn mở. Nó gom tin tức, bản đồ, thị trường tài chính, xung đột, bay quân sự, an ninh mạng, khí hậu và hạ tầng vào một giao diện duy nhất, rồi dùng AI tóm tắt thành bản tin ngắn. Repo hiện có khoảng 90.500 sao và 14.000 fork trên GitHub, viết chủ yếu bằng TypeScript.

Bạn nên xem qua nếu công việc của bạn phụ thuộc vào biến động bên ngoài. Ví dụ: chủ doanh nghiệp xuất nhập khẩu, người theo dõi giá hàng hoá và năng lượng, nhân viên phân tích rủi ro, hay lập trình viên muốn lấy dữ liệu này đưa vào script hoặc trợ lý AI. Thay vì mở hàng chục tab báo và biểu đồ, bạn nhìn một màn hình.

Điểm đáng giá nhất là nó có nhiều cách dùng: web, ứng dụng desktop, bảng điều khiển ngay trong terminal (không cần API key), CLI, SDK và cả MCP server cho trợ lý AI. Bạn có thể bắt đầu bằng một lệnh `npx` chỉ mất vài phút, chưa cần cài gì nặng.

```repo
- repo | koala73/worldmonitor
- kind | Ứng dụng
- desc | World Monitor gom tin tức, bản đồ, thị trường, xung đột và hạ tầng toàn cầu vào một bảng điều khiển thời gian thực, có AI tóm tắt, chạy web, desktop hoặc terminal.
- stars | 91k
- lang | TypeScript
- license | AGPL-3.0
```

## World Monitor làm được gì

Dưới đây là các tính năng chính theo tư liệu của repo, kèm lợi ích thực tế.

- **Tin tức chọn lọc, AI tóm tắt.** Nhiều nguồn tin toàn cầu và theo khu vực được gom lại, AI viết thành bản tóm tắt. Bạn đọc nhanh thay vì đọc từng bài.
- **Hai kiểu bản đồ.** Có quả địa cầu 3D (globe.gl) và bản đồ phẳng WebGL (deck.gl), dùng chung danh mục lớp dữ liệu. Bạn chọn kiểu nào dễ nhìn hơn.
- **Đối chiếu nhiều luồng tín hiệu.** Repo ghép các tín hiệu quân sự, kinh tế, thiên tai và leo thang căng thẳng để thấy khi nào nhiều thứ cùng xảy ra một lúc.
- **Country Instability Index (CII).** Chỉ số bất ổn theo quốc gia, hiện có điểm số, mức xếp hạng và biến động xấp xỉ 24 giờ cho 31 quốc gia nhóm Tier-1.
- **Radar tài chính.** Sàn chứng khoán, hàng hoá, tiền số và một chỉ số thị trường tổng hợp.
- **AI chạy cục bộ.** README nói bạn có thể chạy toàn bộ bằng Ollama mà không cần API key. Hữu ích nếu bạn không muốn gửi dữ liệu ra dịch vụ AI bên ngoài.
- **Nhiều biến thể từ một mã nguồn.** Có bản world, tech, finance, commodity, happy và energy. Bạn chọn bản hợp ngành của mình.
- **Ứng dụng desktop (Tauri 2).** Có cho macOS, Windows và Linux. Một bản cài dùng cho mọi biến thể, đổi biến thể ngay trong app.
- **Giao diện đa ngôn ngữ**, có nguồn tin bằng ngôn ngữ gốc và hỗ trợ chữ viết từ phải sang trái.
- **Truy cập bằng lập trình.** MCP server, REST API, CLI và SDK (Python, Ruby, Go) cho ai muốn tự động hoá.

## Cần chuẩn bị gì

Tuỳ cách dùng, bạn cần chuẩn bị khác nhau. Mình tách ra cho dễ chọn:

- **Chỉ xem thử:** một trình duyệt là đủ. README ghi bản web ở worldmonitor.app. Bạn không phải cài gì.
- **Bảng điều khiển trong terminal hoặc CLI:** cần Node.js và npm để chạy `npx`. README ghi bảng điều khiển terminal "không cần API key".
- **Tự dựng bản đầy đủ bằng Docker:** cần Docker. Lệnh cài một dòng sẽ tải mã, tạo các khoá bí mật cần thiết, khởi động hệ thống và nạp dữ liệu. API key là tuỳ chọn.
- **Chạy chế độ phát triển (hot-reload):** README yêu cầu **Node.js 24**, đúng phiên bản ghi trong file `.nvmrc`. Bản Node có sẵn trong gói hệ điều hành thường cũ hơn. README nêu ví dụ Debian 12 và Raspberry Pi OS đi kèm Node.js 18, và `npm install` sẽ dừng với lỗi `Invalid comparator: file:vendor/braces`. Cách xử lý là cài Node.js 24 bằng nvm hoặc tải từ nodejs.org.
- **Hệ điều hành:** bản desktop có cho Windows, macOS (Apple Silicon và Intel) và Linux (AppImage x64 và ARM64).
- **API key:** ứng dụng chạy được khi không có biến môi trường nào. Một số nguồn dữ liệu riêng cần khoá, ví dụ trong file `.env.example` có `FINNHUB_API_KEY`, `FRED_API_KEY`, `EIA_API_KEY`, `OPENROUTER_API_KEY`. Muốn dùng MCP hoặc CLI có xác thực thì cần API key của World Monitor (README chỉ trang lấy key ở mục pro trên website dự án).
- **Phần cứng:** tư liệu không nêu yêu cầu cụ thể (không nói cần GPU hay RAM bao nhiêu).

## Cài đặt từng bước

Mình đưa ra hai đường: cách một dòng bằng Docker (đủ bộ) và cách chạy chế độ phát triển. Nếu chỉ muốn thử nhanh, đọc bước thử bằng `npx` ở phần sau.

```steps
- Chọn cách chạy | Docker một dòng nếu muốn tự dựng đủ bộ, hoặc chế độ phát triển nếu bạn là dev
- Cài một dòng (Docker) | Chạy lệnh curl để tự tải mã, tạo khoá, khởi động và nạp dữ liệu
- Hoặc tải mã về | git clone repo rồi cd vào thư mục worldmonitor
- Cài thư viện và chạy | npm install rồi npm run dev (cần Node.js 24)
- Mở trình duyệt | Vào localhost:3000 để xem bảng điều khiển
```

### Cách 1: Cài một dòng bằng Docker

Đây là cách dựng cả hệ thống: bảng điều khiển, Redis, bộ chuyển tiếp dữ liệu tàu thuyền (AIS relay) và dữ liệu công khai đã được nạp sẵn. Bạn mở terminal (PowerShell hoặc Git Bash trên Windows, Terminal trên macOS/Linux) và chạy:

```bash
curl -fsSL https://www.worldmonitor.app/install.sh | bash
```

Lệnh này tải một script cài đặt về rồi chạy ngay. Theo README, nó sẽ clone vào thư mục `./worldmonitor` (hoặc dùng lại thư mục bạn đã có), tạo các khoá bí mật cần thiết, khởi động hệ thống và nạp dữ liệu. Xong thì mở localhost:3000.

README còn nêu các tuỳ chọn `--dir`, `--port`, `--no-seed`, `--no-build`, đặt sau `bash -s --`. Muốn xem chi tiết, đọc `scripts/install.sh --help` trong repo. Chi tiết dùng cho môi trường thật và cách gỡ cài nằm trong file `SELF_HOSTING.md`.

Chỗ người mới hay vấp: lệnh `bash` không có sẵn trên Windows thuần. Bạn nên chạy trong Git Bash hoặc WSL, và máy phải có Docker đang bật trước khi chạy.

### Cách 2: Chạy chế độ phát triển

Cách này hợp với lập trình viên muốn xem mã hoặc sửa. Đầu tiên tải mã về và vào thư mục:

```bash
git clone https://github.com/koala73/worldmonitor.git
cd worldmonitor
```

`git clone` tải toàn bộ repo về máy, `cd worldmonitor` đưa terminal vào thư mục vừa tạo. Mọi lệnh sau phải chạy trong thư mục này.

Trước khi cài, kiểm tra phiên bản Node. Nếu bạn dùng nvm, lệnh `nvm install` chạy bên trong thư mục sẽ tự đọc `.nvmrc` và cài đúng bản 24. Sau đó:

```bash
npm install
npm run dev
```

`npm install` tải các thư viện phụ thuộc, `npm run dev` bật máy chủ Vite có tự nạp lại khi bạn sửa mã. Mở localhost:3000 trong trình duyệt. Muốn đổi cổng, đặt `DEV_PORT` trong file `.env.local`.

Bạn cũng có thể chạy riêng từng biến thể:

```bash
npm run dev:tech
npm run dev:finance
npm run dev:commodity
npm run dev:happy
npm run dev:energy
```

Mỗi lệnh ứng với một biến thể (công nghệ, tài chính, hàng hoá, tin vui, năng lượng).

### Cách 3: Dùng thử ngay bằng terminal, không cần cài

Nếu bạn chỉ muốn thấy nó chạy, README cho phép chạy thẳng bảng điều khiển trong terminal:

```bash
npx worldmonitor
```

Chạy không kèm tham số trong terminal sẽ mở bảng điều khiển với bản đồ, tin tức, thị trường, xung đột, chuyến bay quân sự, an ninh mạng, khí hậu, thị trường dự đoán và truyền hình trực tiếp. Có hỗ trợ chuột và giao diện nhiều màu. README ghi không cần API key.

Nếu muốn có lệnh dùng thường xuyên, README cho hai cách cài:

```bash
npm install -g worldmonitor
# hoặc
brew install worldmonitor
```

Sau khi cài, lệnh là `worldmonitor` (có bí danh `wm`).

```note
API key (ví dụ khoá bắt đầu bằng wm_) và các key trong .env.example là bí mật. Đừng dán vào ảnh chụp màn hình, đừng đưa lên GitHub. Đặt key vào file .env.local (file cục bộ) thay vì ghi thẳng trong mã. Nếu dùng dịch vụ AI qua mạng như OpenRouter, hãy kiểm tra giới hạn chi phí trong tài khoản của bạn.
```

## Kiểm tra đã chạy được chưa

Tuỳ cách bạn cài, dấu hiệu thành công khác nhau:

- **Docker hoặc `npm run dev`:** mở localhost:3000 và thấy giao diện bảng điều khiển hiện ra với bản đồ và các ô thông tin. README nói ứng dụng chạy được ngay cả khi chưa đặt biến môi trường nào, nên nếu một số ô trống dữ liệu thì thường là do thiếu key tuỳ chọn, chưa hẳn là hỏng.
- **Terminal dashboard:** chạy `npx worldmonitor` và thấy bản đồ cùng các khu vực tin tức, thị trường hiện trong terminal.
- **CLI hoặc MCP:** chạy lệnh dưới đây. README ghi lệnh này liệt kê mọi công cụ MCP và không cần key:

```bash
npx worldmonitor tools
```

Nếu danh sách công cụ hiện ra, kết nối mạng và gói đã hoạt động. Nếu bạn là dev muốn kiểm tra mã, README còn có `npm run typecheck` (kiểm tra kiểu) và `npm run build:full` (build bản sản xuất).

## Dùng vào việc thật

### Chủ doanh nghiệp nhập khẩu theo dõi hàng hoá và năng lượng

Bạn nhập nguyên liệu từ nước ngoài và giá phụ thuộc dầu, nông sản, cước vận tải. Thay vì mở nhiều trang, bạn chạy biến thể dành cho hàng hoá trên máy của mình:

```bash
npm run dev:commodity
```

Bạn mở localhost:3000 và thấy radar tài chính với hàng hoá, chứng khoán, tiền số cùng tin tức liên quan, có AI tóm tắt. Muốn thiên về năng lượng thì dùng `npm run dev:energy`. Đây là cách nhìn nhanh buổi sáng trước khi họp, chứ không phải khuyến nghị đầu tư.

> Một màn hình thay cho hàng chục tab: bạn nhìn thế giới đang động ở đâu rồi mới quyết định.
>
> — Ông T

### Nhân viên văn phòng muốn xem nhanh mà không cài nặng

Bạn làm phân tích hoặc quản lý rủi ro, không rành lập trình. Bạn chỉ cần Node.js có sẵn và một lệnh:

```bash
npx worldmonitor
```

Bảng điều khiển hiện ngay trong terminal với bản đồ, tin tức, thị trường, xung đột và an ninh mạng. Không cần API key nên bạn thử ngay được. Nếu thích dùng thường xuyên, cài bản toàn cục bằng `npm install -g worldmonitor` rồi gõ `wm`.

### Lập trình viên lấy dữ liệu rủi ro quốc gia vào script

Bạn đang làm một báo cáo nội bộ và cần điểm rủi ro theo quốc gia. Cài CLI rồi gọi bằng API key của bạn. Ví dụ trong README:

```bash
worldmonitor risk IR --api-key wm_xxx
```

Thay `wm_xxx` bằng key thật của bạn. Kết quả là dữ liệu rủi ro cho quốc gia có mã `IR` do chính CLI trả về. Nếu bạn viết bằng Python, README nói có thư viện `worldmonitor-sdk` (cũng có bản Ruby và Go) với cùng chức năng như CLI. Hãy đọc trang hướng dẫn SDK trên website dự án để biết cách gọi cụ thể.

### Người làm với trợ lý AI nối dữ liệu qua MCP

Bạn dùng một trợ lý AI hỗ trợ MCP và muốn nó hỏi trực tiếp dữ liệu World Monitor. README cho biết có máy chủ MCP tại địa chỉ `https://worldmonitor.app/mcp` (Streamable HTTP). Việc liệt kê công cụ (`tools/list`) là công khai, còn gọi công cụ (`tools/call`) cần header `X-WorldMonitor-Key` hoặc đăng nhập OAuth. Bạn có thể xem trước danh sách công cụ bằng `npx worldmonitor tools`, rồi cấu hình trợ lý của bạn theo trang MCP Overview trên website dự án. Mình không có thêm thông tin chi tiết hơn về từng công cụ trong tư liệu này.

## Lỗi hay gặp và cách xử lý

- **`npm install` dừng với lỗi `Invalid comparator: file:vendor/braces`.** Đây là lỗi README nêu rõ: máy bạn đang dùng Node.js quá cũ (ví dụ Node 18 trên Debian 12 hay Raspberry Pi OS). Cài Node.js 24 bằng nvm (`nvm install` trong thư mục repo) hoặc tải từ nodejs.org, rồi chạy lại.
- **Gõ lệnh curl ... | bash trên Windows báo lỗi.** Windows thuần không có `bash` kiểu Linux. Hãy chạy trong Git Bash hoặc WSL, và bảo đảm Docker đã bật.
- **Mở localhost:3000 không thấy gì.** Kiểm tra terminal còn đang chạy `npm run dev` hay Docker chưa khởi động xong. Nếu cổng 3000 đã bị chương trình khác dùng, đổi cổng bằng `DEV_PORT` trong `.env.local` (chế độ dev) hoặc cờ `--port` (cài một dòng).
- **Một số ô trống hoặc thiếu dữ liệu.** README ghi một số nguồn dữ liệu cần key riêng. Mở `.env.example` xem danh sách biến cần có, điền vào `.env.local` đúng tên biến. Đừng đoán tên biến.
- **Gọi MCP hoặc CLI báo lỗi xác thực.** Lệnh liệt kê công cụ là công khai, nhưng gọi công cụ cần key. Kiểm tra bạn đã truyền đúng header `X-WorldMonitor-Key` hoặc `--api-key`.

## Có nên dùng không

**Điểm mạnh.** Phạm vi rộng, từ tin tức tới thị trường, hạ tầng và an ninh mạng, gom vào một chỗ. Có nhiều cách dùng: web, desktop, terminal, CLI, SDK, MCP. Thử rất nhanh bằng `npx worldmonitor` không cần key. Bạn có thể tự dựng bằng Docker, và README nói có thể chạy AI cục bộ qua Ollama. Repo có nhiều người dùng và còn được cập nhật trong vài tháng gần đây.

**Giới hạn.** Đây là công cụ khá lớn, dựng đủ bộ cần Docker hoặc Node.js 24 nên không còn "cài trong một phút" với người mới. Dữ liệu và độ đúng của tin tức phụ thuộc nguồn bên ngoài, vì vậy đừng xem chỉ số hay bản tóm tắt AI là sự thật tuyệt đối. Một số nguồn cần API key riêng, và một số tính năng dùng qua MCP hoặc CLI cần key của dự án.

**Giấy phép.** Mã nguồn theo AGPL-3.0-only. README nói dùng cá nhân, nghiên cứu, tự dựng hay dùng thương mại đều được nếu tuân thủ điều khoản AGPL (chia sẻ mã nguồn khi cần). Nếu công ty bạn muốn giữ mã nguồn đóng hoặc dùng thương hiệu chính thức, README nói cần xin phép riêng. Hãy đọc file LICENSE trước khi đưa vào sản phẩm.

**Khi nào chọn cách khác.** Nếu bạn chỉ cần một nguồn tin đơn giản, hay một ứng dụng đọc RSS, công cụ này hơi thừa. Nếu bạn cần dữ liệu đã được kiểm chứng cho quyết định tài chính nghiêm túc, hãy đối chiếu với nguồn chính thức. Còn nếu bạn muốn một góc nhìn tổng quan, tự động hoá hoặc nối với trợ lý AI, đây là một lựa chọn đáng thử.

## Câu hỏi thường gặp

### World Monitor có miễn phí không?

Mã nguồn mở theo giấy phép AGPL-3.0-only nên bạn tự dựng và chạy được. README ghi bảng điều khiển terminal không cần API key và ứng dụng chạy được khi chưa đặt biến môi trường nào. Một số tính năng cần key riêng, và README chỉ trang lấy key của dự án. Tư liệu không nói rõ giá.

### Có cần GPU để chạy không?

Tư liệu không nêu yêu cầu GPU hay cấu hình phần cứng. README chỉ nói bạn có thể chạy AI cục bộ bằng Ollama mà không cần API key. Nếu muốn biết máy cần mạnh cỡ nào cho Ollama, bạn nên xem tài liệu của Ollama.

### Chạy được trên Windows không?

Có. README ghi có bản ứng dụng desktop cho Windows, macOS và Linux. Lệnh cài một dòng dùng bash, nên trên Windows bạn nên dùng Git Bash hoặc WSL và bật Docker. Bảng điều khiển terminal chạy bằng npx nên cần Node.js.

### Cần phiên bản Node.js nào?

Để chạy chế độ phát triển, README yêu cầu Node.js 24, đúng bản ghi trong file .nvmrc. Bản Node cũ như 18 sẽ làm npm install dừng với lỗi Invalid comparator. Cách xử lý là cài Node 24 bằng nvm hoặc từ nodejs.org.

### Dữ liệu của tôi có an toàn không?

Tư liệu không có thông tin chi tiết về cách xử lý dữ liệu người dùng. README chỉ nói bạn có thể tự dựng trên máy mình và chạy AI cục bộ bằng Ollama. Nếu lo ngại, hãy đọc SECURITY.md và SELF_HOSTING.md trong repo, và giữ kín mọi API key.

### Khác gì việc đọc tin trên các trang báo bình thường?

World Monitor gom nhiều nguồn, tin tức, thị trường, hạ tầng, xung đột, bản đồ vào một bảng điều khiển và có AI tóm tắt. Nó cũng cho truy cập bằng lập trình qua CLI, SDK, REST API và MCP. Tư liệu không so sánh trực tiếp với một công cụ cụ thể nào khác.

### Dùng thương mại được không?

README ghi dùng thương mại hoặc SaaS được theo AGPL-3.0-only nếu bạn tuân thủ nghĩa vụ của giấy phép, ví dụ chia sẻ mã nguồn khi cần. Dùng mã nguồn đóng hoặc thương hiệu chính thức thì cần xin phép riêng. Bạn nên đọc file LICENSE trước.
