# OpenClaw 🦞

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

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

傳送訊息，即可從口袋裡取得 agent 回應。透過一個 Gateway，跨內建頻道、隨附頻道 Plugin、WebChat 和行動節點執行。

# 什麼是 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 分鐘。為了最佳品質和安全性，請使用可用的最強最新世代模型。

# 運作方式

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 是工作階段、路由和頻道連線的單一事實來源。

# 主要功能

# 快速開始

npm install -g openclaw@latest

openclaw onboard --install-daemon

openclaw dashboard

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

# 儀表板

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

• 本機預設值：http://127.0.0.1:18789/
• 遠端存取：Web 介面和 Tailscale

# 設定（選用）

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

• 如果你什麼都不做，OpenClaw 會使用 RPC 模式中的隨附 Pi 二進位檔，並為每個傳送者建立工作階段。
• 如果你想要鎖定存取，請從 channels.whatsapp.allowFrom 和（針對群組）提及規則開始。

範例：

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

# 從這裡開始

# 深入了解