Kết nối OpenClaw vào LobeHub qua MCP - Biến LobeHub thành trung tâm điều khiển AI đa năng

OpenClaw là một AI Assistant mã nguồn mở chạy self-hosted, có khả năng gửi tin nhắn qua WhatsApp/Telegram/Discord/Slack, duyệt web, thực thi lệnh terminal, đặt lịch tự động, điều khiển thiết bị từ xa... tất cả thông qua một Gateway duy nhất.

LobeHub là một nền tảng AI Chat UI mã nguồn mở, hỗ trợ chuẩn MCP (Model Context Protocol) — cho phép kết nối với các công cụ bên ngoài.

Bài viết này hướng dẫn bạn kết nối OpenClaw Gateway vào LobeHub qua MCP, để bạn có thể sử dụng toàn bộ sức mạnh của OpenClaw ngay trong giao diện chat của LobeHub.

Tại sao nên dùng LobeHub + OpenClaw thay vì Group Chat Telegram/Discord?

Nếu bạn đang chạy nhiều Agent OpenClaw và cho chúng vào chung một group Telegram hay Discord, bạn sẽ gặp những hạn chế sau:

Vấn đề của Group Chat

Lợi thế của LobeHub + MCP

Tóm lại: LobeHub là "bảng điều khiển" — OpenClaw là "tay chân". Telegram/Discord chỉ nên là kênh nhận kết quả cuối cùng, không phải nơi bạn điều khiển agent.

Kiến trúc tổng quan

LobeHub (Docker)                    Máy chạy OpenClaw
┌──────────────────┐               ┌──────────────────────────────────┐
│                  │               │                                  │
│  Chat UI         │  HTTP POST    │  Supergateway (:8808/mcp)        │
│  (MCP Client)    │──────────────▶│       │                          │
│                  │               │       │ Stdio (JSON-RPC)         │
│                  │               │       ▼                          │
│                  │               │  openclaw-mcp-server (node)      │
│                  │               │       │                          │
│                  │               │       │ HTTP REST API            │
│                  │               │       ▼                          │
│                  │               │  OpenClaw Gateway (:18789)       │
│                  │               │       │                          │
│                  │               │       ├─▶ WhatsApp               │
│                  │               │       ├─▶ Telegram               │
│                  │               │       ├─▶ Discord                │
│                  │               │       ├─▶ Browser                │
│                  │               │       ├─▶ Cron Jobs              │
│                  │               │       └─▶ ...                    │
└──────────────────┘               └──────────────────────────────────┘

Tại sao cần Supergateway?

LobeHub chạy trong Docker không thể gọi lệnh trên máy host, nên không dùng được MCP kiểu Stdio. Supergateway bọc MCP Server thành HTTP endpoint chuẩn Streamable HTTP để LobeHub Docker kết nối được.

Nếu LobeHub cài Desktop (không Docker): Bạn không cần Supergateway, xem mục "Cấu hình thay thế" ở cuối bài.

Yêu cầu

Phần 1: Cài đặt trên máy chạy OpenClaw

1.1 Clone và build openclaw-mcp-server

cd ~
git clone https://github.com/Helms-AI/openclaw-mcp-server.git
cd openclaw-mcp-server
npm install
npm run build

1.2 Tạo systemd service

Tạo service file để Supergateway tự khởi động cùng hệ thống:

sudo nano /etc/systemd/system/openclaw-mcp.service

Dán nội dung sau:

[Unit]
Description=OpenClaw MCP Bridge (Supergateway)
After=network.target

[Service]
Type=simple
User=duynghien
Environment=OPENCLAW_GATEWAY_URL=http://127.0.0.1:18789
Environment=OPENCLAW_GATEWAY_TOKEN=TOKEN_CỦA_BẠN
Environment=PATH=/home/duynghien/.nvm/versions/node/v24.13.0/bin:/usr/local/bin:/usr/bin:/bin
Environment=HOME=/home/duynghien
ExecStart=/home/duynghien/.nvm/versions/node/v24.13.0/bin/npx -y supergateway \
  --stdio "node /home/duynghien/openclaw-mcp-server/dist/index.js" \
  --port 8808 \
  --outputTransport streamableHttp \
  --cors
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

⚠️ Sửa lại cho đúng với máy bạn:

• User= → username của bạn
• Environment=PATH= → chạy which node để lấy đường dẫn chính xác
• ExecStart= → đường dẫn npx (chạy which npx)
• --stdio "node /home/.../dist/index.js" → đường dẫn tuyệt đối đến file đã build
• TOKEN_CỦA_BẠN → token Gateway thật

1.3 Kích hoạt và chạy

sudo systemctl daemon-reload
sudo systemctl enable openclaw-mcp.service
sudo systemctl start openclaw-mcp.service
sudo systemctl status openclaw-mcp.service

Khi thấy Active: active (running) là thành công. Từ giờ mỗi khi máy khởi động lại, service này tự chạy.

1.4 Các lệnh quản lý

# Xem log realtime
sudo journalctl -u openclaw-mcp.service -f

# Khởi động lại
sudo systemctl restart openclaw-mcp.service

# Dừng
sudo systemctl stop openclaw-mcp.service

Phần 2: Cấu hình trên LobeHub

Vào Settings → MCP Plugin → Add Server, chọn kiểu Streamable HTTP, hoặc import file JSON:

{
  "mcpServers": {
    "OpenClaw": {
      "url": "http://<IP_MÁY_OPENCLAW>:8808/mcp"
    }
  }
}

Thay <IP_MÁY_OPENCLAW> bằng IP thật (ví dụ 192.168.1.111).

Sau đó vào Agent Settings → Plugins/MCP và tick chọn OpenClaw để kích hoạt.

Phần 3: Các công cụ có sẵn sau khi kết nối

Phần 4: Một vài use case mọi người tham khảo nhé

Use case 1: Trợ lý thông báo đa kênh

Prompt: "Gửi tin nhắn đến nhóm Telegram 'Dev Team' nội dung: 'Deploy v2.1 hoàn tất' và đồng thời gửi vào channel #releases trên Discord"

LobeHub gọi openclaw_message_send hai lần với hai kênh khác nhau — bạn không cần mở Telegram hay Discord.

Use case 2: Đặt lịch nhắc nhở tự động

Prompt: "Mỗi sáng thứ Hai lúc 8h, gửi tin nhắn Telegram cho tôi nhắc nhở họp standup"

LobeHub gọi openclaw_cron_add tạo cron job. Từ đó mỗi thứ Hai, OpenClaw tự động gửi tin nhắn.

Use case 3: Nghiên cứu và tổng hợp thông tin

Prompt: "Tìm 5 bài viết mới nhất về 'AI Agent Framework 2026', đọc từng bài và tóm tắt lại"

LobeHub gọi openclaw_web_search → openclaw_web_fetch → LLM tổng hợp thành bản tóm tắt.

Use case 4: Giám sát thiết bị từ xa

Prompt: "Chụp ảnh từ camera trước điện thoại (mới hỗ trợ Android) và gửi vào Telegram cá nhân"

Kết hợp openclaw_nodes_camera + openclaw_message_send — tất cả bằng một câu chat.

Use case 5: Multi-Agent chuyên biệt

Tạo nhiều Agent trên LobeHub, mỗi cái một vai trò:

Tất cả đều kết nối cùng một OpenClaw Gateway qua MCP, nhưng mỗi agent có context và chuyên môn riêng — điều mà group chat Telegram/Discord không thể làm được.

Use case 6: Automation thông minh

Prompt: "Lấy vị trí GPS điện thoại, nếu đang ở nhà thì gửi thông báo 'Welcome home' lên thiết bị"

Kết hợp openclaw_nodes_location + logic LLM + openclaw_nodes_notify.

Phần 5: Xử lý lỗi thường gặp

Cấu hình cho LobeHub Desktop (không Docker)

Nếu LobeHub cài trực tiếp trên máy (không dùng Docker), bạn không cần Supergateway. Chỉ cần cài openclaw-mcp-server trên cùng máy đó và import JSON:

{
  "mcpServers": {
    "OpenClaw": {
      "command": "node",
      "args": ["/đường/dẫn/tuyệt/đối/openclaw-mcp-server/dist/index.js"],
      "env": {
        "OPENCLAW_GATEWAY_URL": "http://<IP_MÁY_OPENCLAW>:18789",
        "OPENCLAW_GATEWAY_TOKEN": "TOKEN_CỦA_BẠN"
      }
    }
  }
}

Tất cả chạy self-hosted, dữ liệu nằm trên máy bạn, không phụ thuộc bên thứ ba.