GitHub - openclaw/openclaw: 你的個人專屬 AI 助手。支援任何作業系統、任何平台。龍蝦風格。 🦞

🦞 OpenClaw — 個人 AI 助手

去角質！去角質！ (EXFOLIATE! EXFOLIATE!)

OpenClaw 是一款運行在你個人裝置上的 AI 助手。
它能在你已使用的頻道上回覆你（WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、Microsoft Teams、WebChat），以及擴充頻道如 BlueBubbles、Matrix、Zalo 和 Zalo Personal。它能在 macOS/iOS/Android 上進行聽說互動，並能渲染一個由你控制的實時畫布 (Canvas)。Gateway 僅是控制層面——產品本身就是這個助手。

如果你想要一個感覺像是在地化、快速且永遠在線的個人單用戶助手，這就是你的選擇。

網站 · 文件 · 願景 · DeepWiki · 入門指南 · 更新說明 · 展示 · 常見問題 · 嚮導 · Nix · Docker · Discord

首選設定方式：在終端機運行引導嚮導 (openclaw onboard)。
嚮導將引導你逐步設定 Gateway、工作空間、頻道和技能。CLI 嚮導是推薦的路徑，適用於 macOS、Linux 和 Windows（透過 WSL2；強烈推薦）。
支援 npm、pnpm 或 bun。
新安裝？從這裡開始：入門指南

訂閱 (OAuth)：

模型說明：雖然支援任何模型，但我強烈建議使用 Anthropic Pro/Max (100/200) + Opus 4.6，以獲得強大的長文本處理能力和更好的提示詞注入防禦。詳見「引導設定」。

模型（選擇 + 認證）

安裝（推薦）

運行環境：Node ≥22。

嚮導會安裝 Gateway 守護進程（launchd/systemd 用戶服務），使其保持運行。

快速開始 (TL;DR)

運行環境：Node ≥22。

完整新手指南（認證、配對、頻道）：入門指南

升級中？更新指南（並運行 openclaw doctor）。

開發頻道

切換頻道（git + npm）：openclaw update --channel stable|beta|dev。
詳情：開發頻道。

從原始碼安裝（開發用）

從原始碼構建建議使用 pnpm。Bun 可選用於直接運行 TypeScript。

注意：pnpm openclaw ... 直接運行 TypeScript（透過 tsx）。pnpm build 會生成 dist/ 目錄，用於透過 Node 或封裝好的 openclaw 二進位檔運行。

安全預設值（私訊存取）

OpenClaw 連接到真實的訊息平台。請將傳入的私訊 (DM) 視為不可信的輸入。

完整安全指南：安全

Telegram/WhatsApp/Signal/iMessage/Microsoft Teams/Discord/Google Chat/Slack 的預設行為：

運行 openclaw doctor 以找出風險或配置錯誤的私訊策略。

亮點

星星歷史

目前已構建的所有內容

核心平台

頻道

應用程式 + 節點

工具 + 自動化

運行環境 + 安全

運維 + 封裝

運作原理（簡述）

關鍵子系統

Tailscale 存取 (Gateway 儀表板)

OpenClaw 可以自動配置 Tailscale Serve（僅限 tailnet）或 Funnel（公開），而 Gateway 保持綁定在 loopback。配置 gateway.tailscale.mode：

注意：

詳情：Tailscale 指南 · Web 介面

遠端 Gateway（Linux 表現優異）

在小型 Linux 實例上運行 Gateway 是完全可行的。客戶端（macOS 應用程式、CLI、WebChat）可以透過 Tailscale Serve/Funnel 或 SSH 隧道連接，你仍然可以配對裝置節點（macOS/iOS/Android）以便在需要時執行裝置本地操作。

詳情：遠端存取 · 節點 · 安全

透過 Gateway 協定的 macOS 權限

macOS 應用程式可以運行在節點模式，並透過 Gateway WebSocket 宣告其功能和權限映射 (node.list / node.describe)。客戶端隨後可以透過 node.invoke 執行本地操作：

提升權限的 bash（主機權限）與 macOS TCC 是分開的：

詳情：節點 · macOS 應用程式 · Gateway 協定

代理對代理 (sessions_* 工具)

詳情：會話工具

技能註冊表 (ClawHub)

ClawHub 是一個極簡的技能註冊表。啟用 ClawHub 後，代理可以自動搜尋技能並根據需要引入新技能。

ClawHub

聊天指令

在 WhatsApp/Telegram/Slack/Google Chat/Microsoft Teams/WebChat 中發送這些指令（群組指令僅限擁有者）：

應用程式（選配）

單獨使用 Gateway 就能提供很好的體驗。所有應用程式都是選配的，用於增加額外功能。

如果你計劃構建/運行配套應用程式，請參考下方的平台運行手冊。

macOS (OpenClaw.app)（選配）

注意：需要簽署構建版本，macOS 權限才能在重新構建後保持有效（參見 docs/mac/permissions.md）。

iOS 節點（選配）

運行手冊：iOS 連接。

Android 節點（選配）

代理工作空間 + 技能

配置

極簡的 ~/.openclaw/openclaw.json（模型 + 預設值）：

完整配置參考（所有鍵值 + 範例）。

安全模型（重要）

詳情：安全指南 · Docker + 沙箱 · 沙箱配置

WhatsApp

Telegram

Slack

Discord

Signal

BlueBubbles (iMessage)

iMessage (舊版)

Microsoft Teams

WebChat

瀏覽器控制（選配）：

文件

當你完成引導流程並想要深入參考時，請使用這些文件。

進階文件（發現 + 控制）

運維與故障排除

深度解析

工作空間與技能

平台內部原理

電子郵件掛鉤 (Gmail)

Molty

OpenClaw 是為 Molty 構建的，Molty 是一個太空龍蝦 AI 助手。 🦞
由 Peter Steinberger 和社群共同開發。

社群

參見 CONTRIBUTING.md 了解指南、維護者以及如何提交 PR。
歡迎 AI/感性編碼 (vibe-coded) 的 PR！ 🤖

特別感謝 Mario Zechner 的支持以及 pi-mono。
特別感謝 Adam Doppelt 的 lobster.bot。

感謝所有貢獻者 (clawtributors)：

(以下為貢獻者頭像列表，保持原樣)
... (略) ...