OpenClaw 🦞

“EXFOLIATE! EXFOLIATE!” — Một con tôm hùm không gian, có lẽ vậy

OpenClaw

Gateway kết nối WhatsApp/Telegram/Discord/iMessage với AI Agent (Pi) trên mọi hệ điều hành.
Plugin hỗ trợ thêm Mattermost và nhiều nền tảng khác. Gửi tin nhắn, nhận phản hồi từ Agent — ngay từ điện thoại của bạn.

GitHub · Releases · Tài liệu · Cài đặt OpenClaw assistant

OpenClaw kết nối WhatsApp (qua WhatsApp Web / Baileys), Telegram (Bot API / grammY), Discord (Bot API / channels.discord.js), và iMessage (imsg CLI) với các coding Agent như Pi. Plugin hỗ trợ thêm Mattermost (Bot API + WebSocket) và nhiều nền tảng khác. OpenClaw cũng cung cấp sức mạnh cho OpenClaw assistant.

Bắt đầu từ đây

Nếu Gateway đang chạy trên cùng máy tính, link trên sẽ mở Control UI trên trình duyệt ngay lập tức. Nếu không được, hãy khởi động Gateway trước: openclaw gateway.

Dashboard (Control UI trên trình duyệt)

Dashboard là Control UI trên trình duyệt để chat, cấu hình, quản lý node, session và nhiều thứ khác. Mặc định local: http://127.0.0.1:18789/ Truy cập từ xa: Web surfaces và Tailscale

OpenClaw

Cách hoạt động

WhatsApp / Telegram / Discord / iMessage (+ plugins)
        │
        ▼
  ┌───────────────────────────┐
  │          Gateway          │  ws://127.0.0.1:18789 (loopback-only)
  │     (single source)       │
  │                           │  http://<gateway-host>:18793
  │                           │    /__openclaw__/canvas/ (Canvas host)
  └───────────┬───────────────┘
              │
              ├─ Pi agent (RPC)
              ├─ CLI (openclaw …)
              ├─ Chat UI (SwiftUI)
              ├─ macOS app (OpenClaw.app)
              ├─ iOS node via Gateway WS + pairing
              └─ Android node via Gateway WS + pairing

Hầu hết các thao tác đều đi qua Gateway (openclaw gateway), một process chạy liên tục duy nhất quản lý các kết nối Channel và WebSocket control plane.

Mô hình mạng

  • Một Gateway cho mỗi host (khuyên dùng): đây là process duy nhất được phép sở hữu WhatsApp Web session. Nếu các bạn cần rescue bot hoặc cách ly nghiêm ngặt, hãy chạy nhiều Gateway với profile và port riêng biệt; xem Multiple gateways.
  • Loopback-first: Gateway WS mặc định là ws://127.0.0.1:18789.
    • Wizard giờ tạo gateway token mặc định (ngay cả với loopback).
    • Để truy cập Tailnet, chạy openclaw gateway --bind tailnet --token ... (token bắt buộc với non-loopback bind).
  • Nodes: kết nối tới Gateway WebSocket (LAN/tailnet/SSH tùy nhu cầu); legacy TCP bridge đã bị deprecated/xóa.
  • Canvas host: HTTP file server trên canvasHost.port (mặc định 18793), phục vụ /__openclaw__/canvas/ cho node WebView; xem Cấu hình Gateway (canvasHost).
  • Remote use: SSH tunnel hoặc tailnet/VPN; xem Remote access và Discovery.

Tính năng (tổng quan)

  • 📱 Tích hợp WhatsApp — Dùng Baileys cho WhatsApp Web protocol
  • ✈️ Telegram Bot — DM + group qua grammY
  • 🎮 Discord Bot — DM + guild channel qua channels.discord.js
  • 🧩 Mattermost Bot (plugin) — Bot token + WebSocket events
  • 💬 iMessage — Tích hợp imsg CLI local (macOS)
  • 🤖 Agent bridge — Pi (RPC mode) với tool streaming
  • ⏱️ Streaming + chunking — Block streaming + Telegram draft streaming chi tiết (/concepts/streaming)
  • 🧠 Multi-agent routing — Route provider account/peer tới các Agent riêng biệt (workspace + per-agent session)
  • 🔐 Subscription auth — Anthropic (Claude Pro/Max) + OpenAI (ChatGPT/Codex) qua OAuth
  • 💬 Sessions — Chat trực tiếp gộp vào main chung (mặc định); group thì riêng biệt
  • 👥 Hỗ trợ Group Chat — Mặc định dựa trên mention; owner có thể toggle /activation always|mention
  • 📎 Hỗ trợ Media — Gửi và nhận hình ảnh, audio, tài liệu
  • 🎤 Voice notes — Hook transcription tùy chọn
  • 🖥️ WebChat + macOS app — UI local + menu bar companion cho ops và voice wake
  • 📱 iOS node — Pair như một node và expose Canvas surface
  • 📱 Android node — Pair như một node và expose Canvas + Chat + Camera

Lưu ý: các đường dẫn legacy Claude/Codex/Gemini/Opencode đã bị xóa; Pi là đường dẫn coding-agent duy nhất.

Bắt đầu nhanh

Yêu cầu runtime: Node ≥ 22.

# Khuyên dùng: cài đặt global (npm/pnpm)
npm install -g openclaw@latest
# hoặc: pnpm add -g openclaw@latest

# Onboard + cài đặt service (launchd/systemd user service)
openclaw onboard --install-daemon

# Pair WhatsApp Web (hiển thị QR)
openclaw channels login

# Gateway chạy qua service sau khi onboard; vẫn có thể chạy thủ công:
openclaw gateway --port 18789

Chuyển đổi giữa npm và git install sau này rất dễ: cài đặt phiên bản khác và chạy openclaw doctor để cập nhật gateway service entrypoint.

Từ source (development):

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build # tự động cài UI deps lần đầu chạy
pnpm build
openclaw onboard --install-daemon

Nếu các bạn chưa có global install, hãy chạy bước onboarding qua pnpm openclaw ... từ repo.

Multi-instance quickstart (tùy chọn):

OPENCLAW_CONFIG_PATH=~/.openclaw/a.json \
OPENCLAW_STATE_DIR=~/.openclaw-a \
openclaw gateway --port 19001

Gửi tin nhắn test (cần Gateway đang chạy):

openclaw message send --target +15555550123 --message "Hello from OpenClaw"

Cấu hình (tùy chọn)

Config nằm ở ~/.openclaw/openclaw.json.

  • Nếu các bạn không làm gì, OpenClaw sẽ dùng Pi binary đi kèm ở RPC mode với per-sender session.
  • Nếu muốn khóa chặt, bắt đầu với channels.whatsapp.allowFrom và (cho group) mention rules.

Ví dụ:

{
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: { "*": { requireMention: true } },
    },
  },
  messages: { groupChat: { mentionPatterns: ["@openclaw"] } },
}

Tài liệu

Tên gọi

OpenClaw = CLAW + TARDIS — bởi vì mọi con tôm hùm không gian đều cần một cỗ máy thời gian-không gian.

“Tất cả chúng ta đều chỉ đang chơi với prompt của riêng mình.” — Một AI, có lẽ đang say token

Credits

  • Peter Steinberger (@steipete) — Creator, người thì thầm với tôm hùm
  • Mario Zechner (@badlogicc) — Pi creator, security pen-tester
  • Clawd — Con tôm hùm không gian đòi một cái tên hay hơn

Core Contributors

License

MIT — Tự do như tôm hùm trong đại dương 🦞

“Tất cả chúng ta đều chỉ đang chơi với prompt của riêng mình.” — Một AI, có lẽ đang say token