Get started

OpenClaw

OpenClaw 🦞

「去角質！去角質！」 — 大概是某隻太空龍蝦

適用於任何作業系統的 AI agent Gateway，跨 Discord、Google Chat、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo 等平台運作。

傳送訊息，即可從口袋中取得 agent 回覆。以一個 Gateway 同時執行內建頻道、隨附頻道 Plugin、WebChat 與行動節點。

開始使用

安裝 OpenClaw，幾分鐘內啟動 Gateway。

執行 Onboarding

透過 openclaw onboard 與配對流程完成引導式設定。

開啟 Control UI

啟動瀏覽器儀表板，用於聊天、設定與工作階段。

什麼是 OpenClaw？

OpenClaw 是一個自託管 Gateway，可將你喜愛的聊天應用程式與頻道介面，包括內建頻道以及 Discord、Google Chat、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo 等隨附或外部頻道 Plugin，連接到 Pi 等 AI coding agent。你在自己的機器或伺服器上執行單一 Gateway 程序，它就會成為你的訊息應用程式與隨時可用 AI assistant 之間的橋樑。

適合誰使用？ 想要一個可從任何地方傳訊息使用的個人 AI assistant，同時不放棄資料控制權，也不依賴託管服務的開發者與進階使用者。

它有什麼不同？

自託管：在你的硬體上執行，遵循你的規則
多頻道：一個 Gateway 可同時服務內建頻道以及隨附或外部頻道 Plugin
Agent 原生：專為具備工具使用、工作階段、記憶體與多 agent 路由的 coding agent 打造
開放原始碼：MIT 授權，由社群驅動

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

運作方式

flowchart LR
  A["Chat apps + plugins"] --> B["Gateway"]
  B --> C["Pi agent"]
  B --> D["CLI"]
  B --> E["Web Control UI"]
  B --> F["macOS app"]
  B --> G["iOS and Android nodes"]

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

主要功能

多頻道 Gateway

透過單一 Gateway 程序支援 Discord、iMessage、Signal、Slack、Telegram、WhatsApp、WebChat 等。

Plugin 頻道

隨附 Plugin 會在一般目前版本中加入 Matrix、Nostr、Twitch、Zalo 等支援。

多 agent 路由

依 agent、工作區或傳送者隔離工作階段。

媒體支援

傳送與接收圖片、音訊與文件。

Web Control UI

用於聊天、設定、工作階段與節點的瀏覽器儀表板。

行動節點

配對 iOS 與 Android 節點，用於 Canvas、相機與語音工作流程。

快速開始

安裝 OpenClaw

bash

npm install -g openclaw@latest

Onboard 並安裝服務

bash

openclaw onboard --install-daemon

聊天

在瀏覽器中開啟 Control UI 並傳送訊息：

bash

openclaw dashboard

或連接一個頻道（Telegram 最快），從手機開始聊天。

需要完整安裝與開發設定？請參閱開始使用。

儀表板

Gateway 啟動後，開啟瀏覽器 Control UI。

本機預設：http://127.0.0.1:18789/
遠端存取：網頁介面與 Tailscale

設定（選用）

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

如果你什麼都不做，OpenClaw 會使用 RPC 模式的隨附 Pi binary，並以每位傳送者各自的工作階段運作。
如果你想要鎖定存取，請從 channels.whatsapp.allowFrom 開始，群組則再加上提及規則。

範例：

json5

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