Clawbot 開發者指南｜OpenClaw GitHub 專案、架構、Gateway API 與外掛開發

本文內容以 2026 年 9 月的官方文件與 GitHub README 為準。外掛 API 官方標示為實驗性質，升級時請重新核對文件。

---

官方專案在哪裡？

專案在 2026 年 1 月 30 日完成改名，GitHub、npm 與文件站都改為 OpenClaw。網路上若看到 clawbot/... 這類 repo 或 api.clawbot.io 之類的網址，都不是官方專案。

授權與治理

• 授權：MIT，© OpenClaw Foundation（README 的 License 段落）。可以商用，但要保留授權聲明
• 治理：由 OpenClaw Foundation 公開開發，它是獨立的 501(c)(3) 非營利組織，聘用核心團隊並簽署發行版本
• 贊助：捐款者與基礎設施贊助商不擁有、也不主導專案

---

從原始碼建置

官方 README 的開發流程：

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm ui:build

注意事項：

• 這是一個 pnpm workspace，在根目錄執行 npm install 不受支援
• 需要 Node 24.16 以上或 26.1 以上
• 想把本機建置的版本當成全域指令使用，官方安裝文件的做法是 pnpm add --global "openclaw@link:$PWD"，再執行 openclaw onboard --install-daemon
• 完整開發循環見官方的 Setup 文件與 repo 裡的 CONTRIBUTING.md

---

架構：Gateway 是核心

依官方架構文件：

• 一台主機只跑一個 Gateway，它是長駐的服務，管理所有聊天頻道的連線（例如 WhatsApp 透過 Baileys、Telegram 透過 grammY），以及 Slack、Discord、Signal、iMessage、WebChat 等
• 控制端（macOS App、CLI、網頁控制台、排程器）透過 WebSocket 連到 Gateway，預設位址是 127.0.0.1:18789
• 節點（nodes）（macOS、iOS、Android 或無介面裝置）也用同一個 WebSocket 連線，但宣告 role: node，提供相機、螢幕錄影、定位等裝置端指令，並以裝置為單位配對
• Gateway 對外提供有型別的 WebSocket API（請求、回應、伺服器推播事件），並用 JSON Schema 驗證收到的資料

---

外部程式怎麼串接 OpenClaw？

OpenClaw 沒有託管在雲端的 REST API。官方文件列出的整合方式如下（前四種出自「External apps」頁，Inbound Webhook 出自「Inbound webhooks」頁）：

官方建議的流程：連上 Gateway → 呼叫文件上列出的 RPC 方法 → 固定你測試過的 OpenClaw 版本 → 升級時重新核對 RPC 文件。啟動 agent 建議用 agent RPC 搭配 agent.wait 取得結果；需要保存對話狀態則用 sessions.* 方法。

Webhook 的設定方式見 OpenClaw AI Agent 自動化教學。

寫在 OpenClaw 程序裡面的程式（外掛），要用官方的 openclaw/plugin-sdk/*，不要走上面這些外部介面。

---

擴充 OpenClaw：技能（Skills）

技能是教 agent 何時、如何使用工具的 markdown 說明檔。每個技能是一個資料夾，裡面有一個帶 YAML frontmatter 的 SKILL.md。OpenClaw 會載入內建技能與本機覆寫，並依環境、設定與系統上有沒有對應程式來篩選。

從 ClawHub 搜尋與安裝技能：

openclaw skills search "calendar"
openclaw skills install @openclaw/demo
openclaw skills update --all

---

擴充 OpenClaw：外掛（Plugins）

外掛可以在不改核心的情況下，新增聊天頻道、模型供應商、本機 CLI 後端、agent 工具、hook、媒體供應商等能力。

開發需求（官方「Building plugins」文件）：

• 所有外掛 API 都標示為實驗性質：請固定 OpenClaw 主程式版本，並逐一測試你宣稱相容的版本
• Node 24.16 以上或 26.1 以上，搭配 npm 或 pnpm
• 以 TypeScript ESM 模組撰寫

外部外掛不需要合併進 OpenClaw 的 repo，發布到 ClawHub 後，使用者這樣安裝：

openclaw plugins install clawhub:<package-name>

不加 clawhub: 前綴的套件名稱會從 npm 安裝。發布、驗證身分等登錄站操作要用另一支 clawhub CLI。

---

如何參與貢獻？

• 貢獻流程：見 repo 的 CONTRIBUTING.md；README 寫明歡迎用 AI 輔助的 PR
• 回報問題與功能需求：用 GitHub 的 issue 範本
• 安裝與設定問題：到官方 Discord 詢問
• 資安漏洞：依 SECURITY.md 的流程私下回報
• 新功能：官方建議多半做成外掛，透過 ClawHub 分享，而不是改核心

---

開發時的安全提醒

• 把所有收到的訊息與網頁內容當成不可信的輸入
• 除非設定沙箱，主對話的工具會直接在主機上執行
• 一個 Gateway 只是一個信任範圍，互不信任的使用者要分開部署
• 發布技能或外掛前，參考 ClawHub 的安全與審核規範

---

常見問題 FAQ

OpenClaw 有官方 REST API 嗎？

沒有託管在雲端的 REST API。外部程式透過本機 Gateway 的 WebSocket 協定與 RPC 方法整合，也可以呼叫 CLI 或使用 Webhook。

OpenClaw 的授權是什麼？可以商用嗎？

MIT 授權，版權屬於 OpenClaw Foundation。MIT 允許商業使用與修改，但要保留原本的授權與版權聲明。另見 repo 的 THIRD_PARTY_NOTICES.md。

舊的 Clawdbot、Moltbot repo 怎麼辦？

專案已於 2026 年 1 月 30 日改到 github.com/openclaw/openclaw，npm 套件也以 openclaw 名稱發行。請以新位置為準。

寫外掛要用什麼語言？

TypeScript ESM 模組，搭配 Node 24.16 以上或 26.1 以上。外掛 API 屬實驗性質，要固定測試過的版本。

技能和外掛差在哪？

技能是給 agent 看的 markdown 說明，教它怎麼用既有工具；外掛是程式碼，能新增頻道、模型供應商、工具等新能力。

---

免費諮詢：找到適合你的 AI 自動化方案

想把 AI 助理整合進既有系統？CloudInsight 提供免費諮詢，適合以下需求：

• 評估 AI 自動化工具
• 想設計自動化工作流程
• 需要 API 整合與架構建議

預約免費諮詢，我們會在 24 小時內回覆你。所有諮詢內容完全保密，沒有任何銷售壓力。

---

參考資料

1. OpenClaw GitHub README（openclaw/openclaw）- https://github.com/openclaw/openclaw
2. OpenClaw 官方文件「Architecture」- https://docs.openclaw.ai/concepts/architecture
3. OpenClaw 官方文件「Gateway integrations for external apps」- https://docs.openclaw.ai/gateway/external-apps
4. OpenClaw 官方文件「Skills」- https://docs.openclaw.ai/tools/skills
5. OpenClaw 官方文件「Building plugins」- https://docs.openclaw.ai/plugins/building-plugins
6. OpenClaw 官方文件「ClawHub」- https://docs.openclaw.ai/clawhub
7. npm 套件 openclaw - https://www.npmjs.com/package/openclaw