> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# OpenClaw
# OpenClaw 🦞
> *「去角質！去角質！」* — 大概是某隻太空龍蝦
跨越 Discord、Google Chat、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo 等平台，適用於任何作業系統的 AI 代理程式閘道。
傳送訊息，即可從口袋中的裝置取得代理程式回覆。以單一閘道執行多個頻道外掛、WebChat 與行動節點。
由非營利組織 OpenClaw 基金會公開開發。
安裝 OpenClaw，幾分鐘內即可啟動閘道。
使用 `openclaw onboard` 與配對流程進行引導式設定。
連結 Discord、Signal、Telegram、WhatsApp 等服務，隨時隨地開始聊天。
啟動瀏覽器儀表板，以進行聊天、設定與工作階段管理。
## 瀏覽文件
行動瀏覽器可能只會顯示區段選單，而不會顯示完整的桌面版分頁列。請使用
這些中心連結，從頁面內文前往相同的頂層文件區域。
概覽、成果展示、入門步驟與設定指南。
安裝方式、更新、容器、託管與進階設定。
訊息頻道、配對、路由、存取群組與頻道品質保證。
架構、工作階段、上下文、記憶與多代理程式路由。
工具、Skills、排程、網路鉤子與自動化功能。
外掛市集、發布、策展與信任指南。
供應商、模型設定、容錯移轉與本機模型服務。
macOS、Windows、iOS、Android、節點與網頁介面。
閘道設定、安全性、診斷與維運。
命令列介面參考、結構描述、RPC、版本資訊與範本。
疑難排解、常見問題、測試、診斷與環境檢查。
## 什麼是 OpenClaw？
OpenClaw 是一個**自行託管的閘道**，透過頻道外掛，將你喜愛的聊天應用程式（Discord、Google Chat、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo 等）連接至 AI 程式設計代理程式。你可以在自己的電腦（或伺服器）上執行單一閘道程序，使其成為訊息應用程式與隨時可用的 AI 助理之間的橋樑。
**適合哪些人？** 希望擁有能從任何地方傳訊息互動的個人 AI 助理，同時不放棄資料控制權，也不依賴託管服務的開發人員與進階使用者。
**有何不同？**
* **自行託管**：在你的硬體上，依照你的規則執行
* **多頻道**：單一閘道可同時服務所有已設定的頻道外掛
* **代理程式原生**：專為支援工具使用、工作階段、記憶與多代理程式路由的程式設計代理程式打造
* **開放原始碼**：採用 MIT 授權，由社群共同推動
**需要什麼？** Node 24.15+（建議）、為相容性使用 Node 22 LTS（`22.22.3+`），或 Node 25.9+、所選供應商提供的 API 金鑰，以及 5 分鐘。為獲得最佳品質與安全性，請使用可用的最強最新世代模型。
## 運作方式
```mermaid theme={"theme":{"light":"min-light","dark":"min-dark"}}
flowchart LR
A["聊天應用程式 + 外掛"] --> B["閘道"]
B --> C["OpenClaw 代理程式"]
B --> D["命令列介面"]
B --> E["網頁控制介面"]
B --> F["macOS 應用程式"]
B --> G["iOS 與 Android 節點"]
```
閘道是工作階段、路由與頻道連線的唯一真實來源。
## 主要功能
透過單一閘道程序使用 Discord、iMessage、Signal、Slack、Telegram、WhatsApp、WebChat 等服務。
頻道外掛可新增 Matrix、Nostr、Twitch、Zalo 等服務；官方外掛可按需安裝。
依代理程式、工作區或傳送者建立隔離的工作階段。
傳送與接收圖片、音訊及文件。
用於聊天、設定、工作階段與節點的瀏覽器儀表板。
配對 iOS 與 Android 節點，以支援 Canvas、相機與語音工作流程。
## 快速開始
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
npm install -g openclaw@latest
```
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --install-daemon
```
在瀏覽器中開啟控制介面並傳送訊息：
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw dashboard
```
或連接頻道（[Telegram](/zh-TW/channels/telegram) 最快），並從手機開始聊天。
需要完整的安裝與開發環境設定嗎？請參閱[開始使用](/zh-TW/start/getting-started)。
## 儀表板
閘道啟動後，開啟瀏覽器控制介面。
* 本機預設：[http://127.0.0.1:18789/](http://127.0.0.1:18789/)
* 遠端存取：[網頁介面](/zh-TW/web)與 [Tailscale](/zh-TW/gateway/tailscale)
## 設定（選用）
設定位於 `~/.openclaw/openclaw.json`。
* 如果你**不進行任何操作**，OpenClaw 會使用內建的 OpenClaw 代理程式執行環境；私訊共用代理程式的主要工作階段，而每個群組聊天都有自己的工作階段。
* 如果你想限制存取，請從 `channels.whatsapp.allowFrom` 開始，並針對群組設定提及規則。
範例：
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
channels: {
whatsapp: {
allowFrom: ["+15555550123"],
groups: { "*": { requireMention: true } },
},
},
messages: { groupChat: { mentionPatterns: ["@openclaw"] } },
}
```
## 從這裡開始
依使用情境整理的所有文件與指南。
核心閘道設定、權杖與供應商設定。
SSH 與 tailnet 存取模式。
Discord、Feishu、Microsoft Teams、Telegram、WhatsApp 等服務的頻道特定設定。
支援配對、Canvas、相機與裝置動作的 iOS 和 Android 節點。
常見修正方式與疑難排解入口。
## 深入瞭解
完整的頻道、路由與媒體功能。
工作區隔離與個別代理程式工作階段。
權杖、允許清單與安全控制。
閘道診斷與常見錯誤。
專案起源、貢獻者與授權條款。