OpenClaw 🦞

OpenClaw

“EXFOLIATE! EXFOLIATE!” — 大概是某隻太空龍蝦說的

任何作業系統皆可運作的 AI Agent 閘道，橫跨 WhatsApp、Telegram、Discord、iMessage 等平台。
傳個訊息，就能從口袋裡拿到 Agent 的回覆。外掛可擴充 Mattermost 等更多頻道。

  • 開始使用 — 安裝 OpenClaw，幾分鐘內啟動 Gateway。
  • 執行精靈 — 透過 openclaw onboard 與配對流程進行引導式設定。
  • 開啟 Control UI — 啟動瀏覽器控制台，管理聊天、設定與工作階段。

什麼是 OpenClaw？

OpenClaw 是一個自架閘道，把你常用的聊天應用——WhatsApp、Telegram、Discord、iMessage 等——連接到 Pi 這類 AI 程式碼代理。你只要在自己的機器（或伺服器）上跑一個 Gateway 程序，它就成了聊天應用和永遠待命的 AI 助手之間的橋樑。

適合誰用？ 開發者和進階使用者——想要一個隨時隨地都能傳訊息的個人 AI 助手，又不想交出資料控制權或依賴託管服務。

有何不同？

  • 自架部署：在你的硬體上執行，規則你定
  • 多頻道：一個 Gateway 同時服務 WhatsApp、Telegram、Discord 等
  • Agent 原生：為程式碼代理量身打造，支援工具呼叫、工作階段、記憶體與多 Agent 路由
  • 開源：MIT 授權，社群驅動

需要什麼？ Node 24（建議），或 Node 22 LTS（22.16+）以確保相容性、你選用的供應商的 API 金鑰，以及 5 分鐘。為了最佳品質與安全性，建議使用最新一代最強的模型。

運作方式

flowchart LR
  A["聊天應用 + 外掛"] --> B["Gateway"]
  B --> C["Pi Agent"]
  B --> D["CLI"]
  B --> E["Web Control UI"]
  B --> F["macOS 應用"]
  B --> G["iOS 與 Android 節點"]

Gateway 是工作階段、路由和頻道連線的唯一事實來源。

核心功能

  • 多頻道閘道 — 一個 Gateway 程序即可連接 WhatsApp、Telegram、Discord 和 iMessage。
  • 外掛頻道 — 透過擴充套件加入 Mattermost 等更多頻道。
  • 多 Agent 路由 — 每個 Agent、工作區或發話者擁有獨立的工作階段。
  • 媒體支援 — 傳送與接收圖片、音訊和文件。
  • Web Control UI — 瀏覽器控制台，管理聊天、設定、工作階段與節點。
  • 行動節點 — 配對 iOS 和 Android 節點，啟用 Canvas、相機與語音工作流程。

快速開始

步驟一：安裝 OpenClaw

```bash
npm install -g openclaw@latest
```

步驟二：引導安裝服務

```bash
openclaw onboard --install-daemon
```

步驟三：配對 WhatsApp 並啟動 Gateway

```bash
openclaw channels login
openclaw gateway --port 18789
```

完整的安裝與開發環境設定請參閱 快速開始。

控制台

Gateway 啟動後即可開啟瀏覽器 Control UI。

OpenClaw

設定（選用）

設定檔位於 ~/.openclaw/openclaw.json。

  • 如果你什麼都不改，OpenClaw 會以 RPC 模式使用內建的 Pi 二進位檔，按發話者建立獨立工作階段。
  • 如果你想要更嚴格的控制，先從 channels.whatsapp.allowFrom 和（針對群組的）提及規則開始設定。

範例：

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

從這裡開始

  • 文件總覽 — 所有文件與指南，依使用情境整理。
  • 設定 — 核心 Gateway 設定、token 與供應商設定。
  • 遠端存取 — SSH 與 tailnet 存取模式。
  • 頻道 — WhatsApp、Telegram、Discord 等頻道的個別設定。
  • 節點 — iOS 與 Android 節點的配對、Canvas、相機與裝置操作。
  • 求助 — 常見修復與疑難排解入口。

深入瞭解

下一頁
Showcase
arrow_forward