跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
OpenClaw 🦞

OpenClaw

“EXFOLIATE! EXFOLIATE!” — 可能是一隻太空龍蝦

適用於任何作業系統的 AI agent Gateway，橫跨 Discord、Google Chat、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo 等平台。
傳送訊息，即可從口袋裡取得 agent 回應。透過一個 Gateway，跨內建頻道、隨附頻道 Plugin、WebChat 和行動節點執行。

開始使用

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

執行新手導引

使用 openclaw onboard 和配對流程進行引導式設定。

開啟控制 UI

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

​
什麼是 OpenClaw？

OpenClaw 是一個自架 Gateway，可將你常用的聊天應用程式和頻道介面（包含內建頻道，以及隨附或外部頻道 Plugin，例如 Discord、Google Chat、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo 等）連接到像 Pi 這樣的 AI coding agents。你在自己的機器（或伺服器）上執行單一 Gateway 程序，它就會成為你的訊息應用程式與隨時可用的 AI 助理之間的橋樑。 適合誰使用？ 適合想要一個可從任何地方傳訊息聯絡的個人 AI 助理，同時不想放棄資料控制權或依賴託管服務的開發者和進階使用者。 它有什麼不同？
  • 自架：在你的硬體上執行，依你的規則運作
  • 多頻道：一個 Gateway 可同時服務內建頻道，以及隨附或外部頻道 Plugin
  • Agent 原生：專為具備工具使用、工作階段、記憶體和多 agent 路由的 coding agents 建置
  • 開放原始碼：採用 MIT 授權，由社群驅動
你需要什麼？ Node 24（建議），或相容用的 Node 22 LTS (22.14+)、你所選提供者的 API 金鑰，以及 5 分鐘。為了最佳品質和安全性，請使用可用的最強最新世代模型。

​
運作方式

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

​
主要功能

多頻道 Gateway

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

Plugin 頻道

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

多 agent 路由

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

媒體支援

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

Web 控制 UI

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

行動節點

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

​
快速開始

1

安裝 OpenClaw

npm install -g openclaw@latest
2

新手導引並安裝服務

openclaw onboard --install-daemon
3

聊天

在瀏覽器中開啟控制 UI 並傳送訊息：
openclaw dashboard
或連接一個頻道（Telegram 最快），然後從手機聊天。
需要完整安裝和開發設定？請參閱開始使用。

​
儀表板

Gateway 啟動後，開啟瀏覽器控制 UI。

OpenClaw

​
設定（選用）

設定位於 ~/.openclaw/openclaw.json。
  • 如果你什麼都不做，OpenClaw 會使用 RPC 模式中的隨附 Pi 二進位檔，並為每個傳送者建立工作階段。
  • 如果你想要鎖定存取，請從 channels.whatsapp.allowFrom 和（針對群組）提及規則開始。
範例： 
{
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: { "*": { requireMention: true } },
    },
  },
  messages: { groupChat: { mentionPatterns: ["@openclaw"] } },
}

​
從這裡開始

文件中心

依使用情境整理的所有文件和指南。

設定

核心 Gateway 設定、權杖和提供者設定。

遠端存取

SSH 和 tailnet 存取模式。

頻道

Feishu、Microsoft Teams、WhatsApp、Telegram、Discord 等的頻道專屬設定。

節點

具備配對、Canvas、相機和裝置動作的 iOS 與 Android 節點。

說明

常見修正和疑難排解入口。

​
深入了解

完整功能清單

完整的頻道、路由和媒體功能。

多 agent 路由

工作區隔離和每個 agent 的工作階段。

安全性

權杖、允許清單和安全控制。

疑難排解

Gateway 診斷和常見錯誤。

關於與致謝

專案起源、貢獻者和授權。