# worldmonitor: bảng điều khiển tin tức và tình hình thế giới — hướng dẫn cài đặt và dùng

> World Monitor (koala73/worldmonitor) là bảng điều khiển mã nguồn mở, gom tin tức toàn cầu, bản đồ 3D, thị trường tài chính và các chỉ số rủi ro địa chính trị vào một giao diện. Bạn có thể dùng bản web có sẵn, chạy thử trong terminal bằng npx hoặc tự dựng bằng Docker. Cài bản terminal chỉ cần một lệnh, tự dựng cả hệ thống thì cần thêm Docker hoặc Node.js 24.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-10-25 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/worldmonitor-bang-dieu-khien-tin-tuc-tinh-hinh-the-gioi

World Monitor là một bảng điều khiển «nhìn toàn cảnh thế giới» theo thời gian thực. Nó gom tin tức từ nhiều nguồn, bản đồ, giá thị trường, xung đột, chuyến bay quân sự, an ninh mạng, khí hậu vào cùng một màn hình. Tin tức còn được AI tóm tắt thành bản tin ngắn. Repo này là mã nguồn của chính trang worldmonitor.app, viết chủ yếu bằng TypeScript, hiện có khoảng 90.557 sao và 14.047 fork trên GitHub.

Nếu bạn làm kinh doanh xuất nhập khẩu, đầu tư, logistics, năng lượng, hoặc đơn giản là hay phải theo dõi tin quốc tế để ra quyết định, công cụ này giúp bạn khỏi mở hàng chục tab. Lập trình viên cũng dùng được: repo có CLI, SDK (Python, Ruby, Go), REST API và cả MCP server để cho các trợ lý AI gọi dữ liệu.

Điểm đáng giá nhất là bạn có nhiều đường vào, từ dễ đến khó. Dễ nhất là mở web. Tiếp theo là chạy `npx worldmonitor` để xem bảng điều khiển ngay trong terminal, không cần API key. Muốn tự làm chủ thì có script cài một dòng bằng Docker. Bài này đi qua từng cách.

```repo
- repo | koala73/worldmonitor
- kind | Ứng dụng
- desc | World Monitor là bảng điều khiển thời gian thực gom tin tức, bản đồ, thị trường và rủi ro địa chính trị vào một màn hình; chạy web, terminal, Docker hoặc MCP.
- stars | 91k
- lang | TypeScript
- license | AGPL-3.0
```

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

README liệt kê khá nhiều tính năng. Mình chọn những ý có ích nhất cho người dùng thường:

- **Tin tức tuyển chọn, AI tóm tắt.** Tin được chia theo nhóm toàn cầu và khu vực, rồi tổng hợp thành bản tin ngắn. Bạn đọc nhanh hơn thay vì lướt từng trang.
- **Hai kiểu bản đồ.** Có quả địa cầu 3D (globe.gl) và bản đồ phẳng WebGL (deck.gl), dùng chung một danh mục lớp dữ liệu. Bạn bật hoặc tắt lớp nào cần xem.
- **Tương quan chéo giữa các luồng tín hiệu.** Công cụ đối chiếu tín hiệu quân sự, kinh tế, thiên tai và leo thang căng thẳng để thấy chỗ nào đang «nóng» cùng lúc.
- **Chỉ số bất ổn quốc gia (CII).** README mô tả điểm số, mức độ và biến động xấp xỉ 24 giờ cho 31 quốc gia nhóm Tier-1. Đây là cách nhìn nhanh về rủi ro.
- **Radar tài chính.** Sàn chứng khoán, hàng hoá, tiền số và một chỉ số tổng hợp thị trường.
- **AI chạy cục bộ.** README nói bạn có thể chạy toàn bộ với Ollama, không cần API key.
- **Nhiều biến thể từ một mã nguồn.** Gồm world, tech, finance, commodity, happy và energy. Bạn chọn bản hợp ngành mình.
- **Ứng dụng desktop (Tauri 2)** cho Windows, macOS và Linux, cùng giao diện đa ngôn ngữ có hỗ trợ chữ viết từ phải sang trái.

Hiểu đơn giản: đây là phòng theo dõi tình hình thu nhỏ, và bạn không phải tự đi gom từng nguồn.

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

Tuỳ cách dùng, yêu cầu khác nhau. Mình tách theo từng đường để bạn khỏi chuẩn bị thừa.

- **Dùng bản web:** chỉ cần trình duyệt. README chưa nói yêu cầu cấu hình riêng.
- **Bảng điều khiển trong terminal (`npx worldmonitor`):** cần có Node.js và npm để chạy `npx`. README ghi rõ không cần API key. README không nêu phiên bản Node riêng cho gói này.
- **Tự dựng bằng Docker (script một dòng):** cần có Docker, vì script dựng cả dashboard, Redis, AIS relay và dữ liệu công khai đã nạp sẵn. API key là tuỳ chọn.
- **Chạy để phát triển (hot-reload):** cần **Node.js 24**, đúng phiên bản ghi trong file `.nvmrc`. README cảnh báo các gói của hệ điều hành thường cũ hơn. Debian 12 và Raspberry Pi OS đi kèm Node.js 18, và khi đó `npm install` sẽ dừng với lỗi `Invalid comparator: file:vendor/braces`. Bạn có thể cài Node 24 bằng nvm hoặc tải từ nodejs.org. Cần thêm Git để tải mã nguồn.
- **API key:** ứng dụng chạy được mà không cần biến môi trường nào. Một số nguồn dữ liệu riêng cần khoá, ví dụ file `.env.example` có các biến như `OPENROUTER_API_KEY`, `FINNHUB_API_KEY`, `FRED_API_KEY`, `EIA_API_KEY`. Bạn chỉ cần điền khi muốn dùng đúng tính năng đó.
- **Gọi MCP server hoặc CLI có xác thực:** cần khoá API. README nói có thể lấy tại trang worldmonitor.app/pro.

README không nói gì về yêu cầu GPU hay RAM tối thiểu, nên mình không đưa ra con số nào.

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

```steps
- Chọn cách dùng | Web, terminal, Docker hoặc chạy dev, tuỳ nhu cầu
- Thử nhanh bằng npx | Chạy bảng điều khiển trong terminal, không cần key
- Tự dựng bằng Docker | Một dòng lệnh cài cả hệ thống
- Hoặc chạy bản dev | Clone repo, npm install, npm run dev
- Chọn biến thể | Chạy bản tech, finance, commodity, happy hoặc energy
```

### Chọn cách dùng phù hợp

Nếu chỉ muốn xem, bạn mở worldmonitor.app là xong, không cần cài gì. Các bước dưới đây dành cho ai muốn chạy trên máy mình. Người mới nên thử bước terminal trước vì nó nhẹ nhất.

### Thử nhanh bảng điều khiển trong terminal

Mở terminal (Windows: PowerShell hoặc Windows Terminal; macOS/Linux: Terminal) rồi gõ:

```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 đồ thế giới, 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. README nói có hỗ trợ chuột và nhiều giao diện màu, và không cần API key.

Bạn cũng có thể cài thành lệnh dùng lâu dài. README ghi hai cách:

```bash
npm install -g worldmonitor
brew install worldmonitor
```

Lệnh đầu dùng npm, lệnh sau dùng Homebrew (macOS/Linux). Chọn một trong hai. Sau khi cài, README cho biết có lệnh `worldmonitor` và bí danh ngắn `wm`.

### Tự dựng cả hệ thống bằng Docker

Đây là cách cài một dòng mà README gọi là «One-line install». Bạn cần Docker đã chạy sẵn, rồi gõ:

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

Theo README, script này sẽ:

- Tải mã nguồn về thư mục `./worldmonitor` (hoặc dùng lại bản bạn đã clone).
- Tạo các khoá bí mật cần thiết.
- Khởi động cả hệ thống và nạp dữ liệu.

Xong thì mở http://localhost:3000. README nói có các tuỳ chọn `--dir`, `--port`, `--no-seed`, `--no-build`, đặt sau `bash -s --`, và bạn có thể xem thêm bằng `scripts/install.sh --help`. Chi tiết chạy thật, gỡ cài đặt nằm trong file SELF_HOSTING.md của repo.

Trên Windows, lệnh `curl ... | bash` cần môi trường có bash, ví dụ Git Bash hoặc WSL. README không hướng dẫn riêng cho PowerShell, nên bạn xem SELF_HOSTING.md nếu vướng.

```note
Lệnh curl ... | bash chạy thẳng một script tải từ mạng. Trước khi chạy, bạn nên mở địa chỉ script trong trình duyệt đọc qua, hoặc dùng cách clone repo bên dưới rồi đọc scripts/install.sh. Đừng chạy trên máy chứa dữ liệu quan trọng nếu chưa hiểu nó làm gì.
```

### Hoặc chạy bản phát triển (hot-reload)

Cách này hợp với người muốn xem hoặc sửa mã. Trước hết kiểm tra Node.js bằng `node -v`; cần bản 24. Sau đó:

```bash
git clone https://github.com/koala73/worldmonitor.git
cd worldmonitor
npm install
npm run dev
```

Giải thích:

- `git clone` tải mã nguồn về máy.
- `cd worldmonitor` đi vào thư mục vừa tải. Nhiều người quên bước này rồi chạy `npm install` ở sai chỗ.
- `npm install` cài thư viện phụ thuộc, có thể mất vài phút.
- `npm run dev` bật máy chủ phát triển.

Mở http://localhost:3000. Muốn đổi cổng, README nói đặt `DEV_PORT` trong file `.env.local`. Ứng dụng chạy được khi không có biến môi trường nào.

### Chọn biến thể theo ngành

Mỗi biến thể có một lệnh riêng, chạy trong cùng thư mục repo:

```bash
npm run dev:tech       # tech.worldmonitor.app
npm run dev:finance    # finance.worldmonitor.app
npm run dev:commodity  # commodity.worldmonitor.app
npm run dev:happy      # happy.worldmonitor.app
npm run dev:energy     # energy.worldmonitor.app
```

Bản `happy` là một biến thể riêng của dự án. README không mô tả kỹ nội dung của nó, nên bạn thử để biết.

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

Tuỳ cách cài, bạn kiểm tra như sau:

- **Bản Docker hoặc bản dev:** mở http://localhost:3000. Nếu thấy giao diện bảng điều khiển với bản đồ và các panel là thành công. Nếu dùng `--port`, hoặc `DEV_PORT` để đổi cổng, hãy mở đúng cổng đó.
- **Bản terminal:** chạy `npx worldmonitor` thấy bảng điều khiển hiện lên trong terminal là xong.
- **Kiểm tra CLI:** README đưa một lệnh liệt kê mọi công cụ MCP, không cần key:

```bash
npx worldmonitor tools
```

Nếu lệnh trả về danh sách công cụ, nghĩa là Node, npm và kết nối mạng của bạn đều ổn.

Với bản dev, bạn còn có thể kiểm tra mã bằng hai lệnh README ghi ở phần đóng góp:

```bash
npm run typecheck
npm run build:full
```

Lệnh đầu kiểm tra kiểu dữ liệu, lệnh sau dựng bản production. Người chỉ dùng thì không cần chạy hai lệnh này.

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

### Chủ doanh nghiệp xuất nhập khẩu theo dõi hàng hoá

Bạn nhập nông sản hoặc xuất hàng đi nước ngoài, giá cả và tin địa chính trị ảnh hưởng thẳng vào đơn hàng. Thay vì mở nhiều trang, bạn chạy biến thể hàng hoá:

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

Mở http://localhost:3000, bạn có giá hàng hoá cạnh tin tức và bản đồ. Mỗi sáng bạn lướt một màn hình để nắm khu vực nào đang có biến động. Kết quả là bạn có một chỗ duy nhất để nhìn tình hình trước khi họp hoặc chốt đơn.

> Đừng cố đọc hết tin thế giới. Hãy để một màn hình nhặt ra chỗ nào đang nóng.
>
> — Ông T

### Nhân viên văn phòng muốn xem tình hình nhanh, không cài phức tạp

Bạn không rành kỹ thuật, chỉ cần nắm tin trong ngày. Bạn mở worldmonitor.app trên trình duyệt. Muốn thử bản terminal thì chạy:

```bash
npx worldmonitor
```

Bạn dùng chuột để chọn panel, đổi giao diện màu theo ý thích. Kết quả: vài phút là có cái nhìn tổng quan về tin tức, thị trường và xung đột, không cần tài khoản hay key.

### Lập trình viên tra rủi ro quốc gia từ dòng lệnh

Bạn đang viết một báo cáo hoặc công cụ nội bộ và cần dữ liệu rủi ro theo quốc gia. Sau khi cài CLI bằng `npm install -g worldmonitor`, README đưa ví dụ:

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

`IR` là mã quốc gia trong ví dụ của README, `wm_xxx` là chỗ bạn thay bằng khoá API của mình. Kết quả là dữ liệu rủi ro in ngay trong terminal, tiện để ghép vào script. Nếu bạn dùng Python, README nói có gói `worldmonitor-sdk`; Ruby và Go cũng có SDK tương ứng. Cách gọi chi tiết xem tài liệu SDK của dự án vì README chưa ghi.

### Dev cho trợ lý AI đọc dữ liệu qua MCP

Bạn dùng một trợ lý AI hỗ trợ MCP và muốn nó tự tra tin tức, rủi ro. README ghi địa chỉ MCP server là `https://worldmonitor.app/mcp` (Streamable HTTP). Việc xem danh sách công cụ (`tools/list`) là công khai. Còn gọi công cụ (`tools/call`) cần khoá API qua header `X-WorldMonitor-Key` hoặc đăng nhập OAuth. Kết quả là trợ lý của bạn có thể lấy dữ liệu từ World Monitor thay vì bạn tự copy tay. Cách khai báo MCP trong từng ứng dụng khác nhau, README chưa ghi, bạn xem trang MCP Overview của dự án.

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

### npm install báo Invalid comparator: file:vendor/braces

Đây là lỗi chính README nhắc tới. Nguyên nhân là Node.js quá cũ (Debian 12 và Raspberry Pi OS đi kèm Node 18). Cách xử lý: cài Node.js 24 bằng nvm, vào thư mục repo rồi chạy `nvm install` để nó đọc `.nvmrc`, hoặc tải bản Node.js từ nodejs.org. Sau đó chạy lại `npm install`.

### Mở localhost:3000 không thấy gì

Thường do chưa chạy xong, cổng đã bị chương trình khác dùng, hoặc bạn đã đổi cổng. Hãy xem terminal còn đang chạy không và có báo lỗi không. Với bản dev, bạn đặt `DEV_PORT` trong `.env.local` để đổi cổng; với script Docker thì dùng tuỳ chọn `--port`.

### Một số panel trống hoặc thiếu dữ liệu

README nói một số nguồn dữ liệu cần thông tin đăng nhập riêng. Bạn mở file `.env.example`, tìm biến tương ứng (ví dụ `FINNHUB_API_KEY` cho dữ liệu thị trường) rồi điền khoá của mình. Đừng đưa khoá vào mã nguồn hay đẩy lên GitHub.

### Lệnh curl ... | bash không chạy trên Windows

PowerShell thường không chạy được dòng lệnh kiểu bash này. Hãy dùng Git Bash hoặc WSL, hoặc chọn cách clone repo rồi `npm run dev`. Nếu cần chạy Docker bằng tay, xem SELF_HOSTING.md.

### Gọi MCP hoặc CLI bị từ chối

Xem công cụ thì được, nhưng gọi công cụ cần khoá. Hãy kiểm tra bạn đã có khoá API (lấy ở worldmonitor.app/pro theo README) và truyền đúng header `X-WorldMonitor-Key`, hoặc đúng cờ `--api-key` với CLI. Đừng dán khoá vào chỗ công khai.

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

**Điểm mạnh.** Có nhiều đường vào: web, terminal, desktop, Docker, CLI, SDK, MCP. Bản terminal cài dễ và không cần key. Dự án còn được cập nhật trong 3 tháng gần đây, README có bảng nêu rõ bề mặt nào đang ổn định, và có sẵn biến thể theo ngành. Chạy AI cục bộ bằng Ollama cũng là điểm cộng nếu bạn lo dữ liệu.

**Giới hạn.** Muốn tự dựng đầy đủ thì phải biết dùng Docker hoặc Node.js 24, không hẳn nhẹ nhàng với người mới. Một số nguồn dữ liệu cần khóa riêng, và gọi MCP/CLI cần khoá API. Chỉ số như CII là mô hình tính của dự án; bạn nên coi là tham khảo, không phải kết luận cuối cùng khi ra quyết định lớn. README cũng không nói rõ mức tài nguyên máy cần cho bản tự dựng.

**Giấy phép.** Mã nguồn dùng AGPL-3.0-only. README nói tự dựng, dùng cá nhân hay nghiên cứu đều được. Dùng thương mại hoặc làm dịch vụ cũng được nếu bạn tuân thủ các nghĩa vụ của AGPL, như chia sẻ mã nguồn khi cần. Muốn dùng mã kín hoặc dùng thương hiệu chính thức thì cần xin phép riêng. Nếu định làm sản phẩm bán ra, bạn nên đọc kỹ LICENSE.

**Khi nào chọn cách khác.** Nếu chỉ cần đọc tin thuần tuý, một trình đọc RSS đơn giản là đủ. Nếu cần dữ liệu có cam kết dịch vụ ở mức doanh nghiệp, hãy hỏi trực tiếp tác giả về giấy phép thương mại thay vì tự dựng. Còn nếu bạn muốn một bức tranh tổng thể về tin tức, thị trường và rủi ro trong cùng một nơi, World Monitor rất đáng thử, và cách `npx worldmonitor` gần như không tốn gì.

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

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

Mã nguồn dùng giấy phép AGPL-3.0-only, bạn có thể tự cài và chạy. Bảng điều khiển terminal ghi rõ không cần API key. Một số tính năng như gọi MCP có xác thực cần khoá API, README chưa nêu giá cụ thể.

### Cần GPU hoặc máy mạnh không?

README không nêu yêu cầu GPU hay cấu hình phần cứng tối thiểu. Có nhắc tới việc chạy AI cục bộ bằng Ollama, nhưng không nói rõ máy cần mạnh cỡ nào, nên hiện chưa có thông tin chính xác.

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

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

### Cần phiên bản Node.js nào để chạy từ mã nguồn?

Cần Node.js 24, đúng phiên bản ghi trong file .nvmrc. Node cũ hơn (ví dụ bản 18 trên Debian 12) có thể làm npm install báo lỗi Invalid comparator. Bạn có thể cài Node 24 bằng nvm hoặc từ nodejs.org.

### Có bắt buộc phải có API key không?

Không. README nói ứng dụng chạy được mà không cần biến môi trường nào, và các khoá trong .env.example là tuỳ chọn cho từng nguồn dữ liệu. Riêng việc gọi công cụ MCP hoặc dùng CLI có xác thực thì cần khoá.

### Có dùng với trợ lý AI được không?

Được. Dự án có MCP server tại địa chỉ https://worldmonitor.app/mcp, có CLI, REST API và SDK cho Python, Ruby, Go. Xem danh sách công cụ là công khai, còn gọi công cụ cần khoá API hoặc OAuth.

### Dữ liệu của mình có an toàn không?

README không nêu chi tiết về quyền riêng tư của bản web. Nếu bạn lo ngại, có thể tự dựng trên máy mình và chạy AI cục bộ bằng Ollama như README mô tả. Repo cũng có file SECURITY.md hướng dẫn báo cáo lỗ hổng.
