openclaw/openclaw View GitHub Homepage for Latest Official Releases

開源個人AI助理，可在任何作業系統上本地運行，連接100多個訊息平台，並具備自主任務執行能力

MITTypeScriptopenclawopenclaw 187.3k Last Updated: February 12, 2026

OpenClaw - 個人化 AI 助理

總覽

OpenClaw 是一個免費且開源的自主 AI 助理框架，使用戶能夠在其自有基礎設施上部署個人化 AI 助理。該專案最初由奧地利軟體工程師 Peter Steinberger 於 2025 年 11 月以「Clawdbot」之名開發，後來在 2026 年初更名為「Moltbot」，最終定名為「OpenClaw」。它已獲得顯著的歡迎，在 GitHub 上累積了超過 117,000 顆星和 16,500 個分支。

專案連結

核心概念

OpenClaw 作為一個 AI 助理，其獨特之處在於它能夠「實際執行任務」，而不僅僅是回應提示。它作為一個自主代理，能夠透過大型語言模型 (LLM) 獨立執行任務，並將訊息平台作為其主要的用戶介面。

主要功能

1. 多平台整合

  • 連接 100 多種訊息服務，包括：
    • WhatsApp (透過 Baileys)
    • Telegram (透過 grammY)
    • Slack (透過 Bolt)
    • Discord (透過 discord.js)
    • Google Chat
    • Signal
    • iMessage
    • Microsoft Teams
    • Matrix
    • BlueBubbles
    • WebChat
    • 以及更多

2. 本地優先閘道架構

  • 單一 WebSocket 控制平面，用於處理會話、頻道、工具和事件
  • 完全在您自己的硬體上運行 (Mac mini、Linux 伺服器、Windows 透過 WSL2)
  • 注重隱私：所有數據保留在您的基礎設施上
  • 核心功能無雲端依賴

3. 多代理路由

  • 將傳入的頻道/帳戶路由到獨立的代理
  • 基於工作區的組織，每個代理擁有獨立的會話
  • 支援多個並行的 AI 模型和提供者

4. 語音與語音辨識功能

  • 語音喚醒：macOS/iOS/Android 的持續語音辨識
  • 對話模式：透過 ElevenLabs 整合進行連續對話
  • 透過伴侶應用程式支援按鍵通話

5. 即時畫布

  • 由代理驅動的視覺化工作區
  • A2UI (代理到使用者介面) 框架，用於動態介面
  • 即時渲染和互動

6. 進階工具整合

  • 瀏覽器控制: 專用的 Chrome/Chromium 自動化，支援 CDP
  • 畫布操作: 推送/重置、評估、快照功能
  • 裝置節點: 相機、螢幕錄製、位置服務
  • 系統整合: 通知、本地命令執行
  • 自動化: Cron 作業、Webhook、Gmail Pub/Sub 觸發器

7. 技能平台

  • 模組化技能系統，包含捆綁、管理和工作區技能
  • ClawdHub 技能註冊中心，用於發現和安裝
  • 支援自訂技能開發

8. 模型靈活性

支援多個 AI 提供者：

  • Anthropic (Claude 模型 - Opus 4.5、Sonnet 4.5、Haiku 4.5)
  • OpenAI (GPT 模型、Codex)
  • Google (Gemini)
  • 其他透過 API 的 LLM 提供者

架構

核心元件

閘道

  • 中央 WebSocket 伺服器 (預設：ws://127.0.0.1:18789)
  • 管理會話、狀態、配置
  • 處理訊息路由和傳遞
  • 提供控制 UI 儀表板

Pi Agent Runtime

  • 基於 RPC 的執行引擎
  • 工具串流和區塊串流
  • 上下文窗口管理
  • 會話隔離

會話模型

  • 主要會話，用於直接聊天
  • 群組隔離，具有啟用模式
  • 佇列管理，用於並行請求
  • 回覆路由

安全模型

預設行為：

  • 工具在主會話的主機上運行 (已驗證用戶擁有完全存取權)
  • 群組/頻道會話的可設定沙盒模式
  • DM 配對系統，防止未經授權的存取

沙盒選項：

  • 非主會話的每個會話 Docker 容器
  • 工具允許/拒絕清單
  • 網路隔離功能

安裝與部署

系統需求

  • 運行環境: Node.js ≥22
  • 作業系統支援: macOS、Linux、Windows (透過 WSL2)
  • 套件管理器: npm、pnpm 或 bun

快速入門

# 全域安裝
npm install -g openclaw@latest

# 運行入門精靈
openclaw onboard --install-daemon

# 啟動閘道
openclaw gateway --port 18789 --verbose

# 發送測試訊息
openclaw message send --to +1234567890 --message "Hello from OpenClaw"

# 與代理互動
openclaw agent --message "Ship checklist" --thinking high

從原始碼建置

git clone https://github.com/openclaw/openclaw.git
cd openclaw

pnpm install
pnpm ui:build
pnpm build

pnpm openclaw onboard --install-daemon
pnpm gateway:watch  # 開發模式，自動重新載入

設定

最簡設定

{
  "agent": {
    "model": "anthropic/claude-opus-4-5"
  }
}

頻道設定範例

WhatsApp：

pnpm openclaw channels login

Telegram：

{
  "channels": {
    "telegram": {
      "botToken": "YOUR_BOT_TOKEN"
    }
  }
}

Discord：

{
  "channels": {
    "discord": {
      "token": "YOUR_DISCORD_TOKEN"
    }
  }
}

安全與隱私

安全功能

  • DM 配對系統 (陌生人接收配對碼)
  • 基於允許清單的存取控制
  • 可設定的沙盒環境
  • 非信任會話的可選 Docker 隔離
  • Tailscale 整合，用於安全的遠端存取

隱私優勢

  • 自我託管：完全的數據所有權
  • 預設無雲端遙測
  • 本地憑證儲存
  • 可設定的網路限制

安全考量

根據安全研究人員的說法：

  • 需要廣泛的權限才能有效運作
  • 適合了解安全影響的進階用戶
  • 建議在生產環境中於隔離環境中運行
  • 可擴展架構存在供應鏈風險
  • 未經適當安全措施，不應連接到生產服務

遠端存取

OpenClaw 支援透過以下方式進行遠端閘道存取：

  • Tailscale Serve/Funnel: 安全的 tailnet 或公開 HTTPS
  • SSH 隧道: 傳統的安全隧道
  • 令牌/密碼驗證: 可設定的驗證模式

這使得可以在 Linux 伺服器上運行閘道，同時從任何裝置進行控制。

聊天指令

用戶可以使用指令控制會話：

  • /status - 會話資訊
  • /new 或 /reset - 重設對話
  • /compact - 摘要上下文
  • /think <level> - 調整思考深度
  • /verbose on|off - 切換詳細輸出
  • /usage off|tokens|full - 使用量統計
  • /restart - 重啟閘道 (僅限擁有者)
  • /activation mention|always - 群組設定

伴侶應用程式

macOS App

  • 選單列控制閘道健康狀態
  • 語音喚醒和按鍵通話
  • WebChat 介面
  • 除錯工具
  • 遠端閘道控制

iOS Node

  • 語音觸發器轉發
  • 畫布表面渲染
  • 基於節點的命令執行

Android Node

  • 畫布、相機、螢幕擷取
  • 透過 Bridge 配對節點

代理工作區與技能

  • 工作區根目錄: ~/.openclaw/workspace
  • 提示檔案: AGENTS.md、SOUL.md、TOOLS.md
  • 技能目錄: ~/.openclaw/workspace/skills/

使用案例

  1. 個人生產力助理

    • 電子郵件管理和回覆
    • 日曆協調
    • 工作自動化

  2. 開發自動化

    • GitHub 通知
    • 自動化部署
    • 代碼審查協助

  3. 多頻道通訊中心

    • 跨平台統一收件箱
    • 自動回覆
    • 訊息轉發和路由

  4. 自訂工作流程自動化

    • 與內部工具整合
    • 資料處理管道
    • 排程任務和提醒

社群與開發

  • 活躍開發: 8,368+ 次提交
  • 開源: MIT 授權
  • 社群: Discord 伺服器可用
  • 貢獻: 歡迎 PR 和社群參與
  • 文件: 在 docs.openclaw.ai 提供完整文件

顯著成就

  • 117k+ GitHub 星標
  • 16.5k+ 分支
  • 在維基百科上出現
  • 透過 Moltbook 整合獲得病毒式傳播
  • 獲得矽谷和國際開發者的極大關注

與替代方案比較

與 ChatGPT 或 Claude AI 不同：

  • 自主性: 獨立執行任務，而非被動回應
  • 自我託管: 在您的基礎設施上運行
  • 多平台: 與 100 多種服務原生整合
  • 可擴展性: 自訂技能和工具
  • 隱私優先: 完全的數據控制

入門資源

  1. 官方文件
  2. 入門指南
  3. 設定參考
  4. 安全指南
  5. 疑難排解

未來發展

OpenClaw 正在積極維護，並提供：

  • 定期更新和錯誤修復
  • 新頻道整合
  • 加強的安全功能
  • 擴展的 AI 模型支援
  • 不斷成長的技能生態系統

鳴謝

  • 創作者: Peter Steinberger
  • 特別感謝: Mario Zechner (pi-mono)、Adam Doppelt (lobster.bot)
  • 社群: 200+ 貢獻者且持續增加

結論

OpenClaw 代表了個人化 AI 助理的範式轉移，強調自主性、隱私和自我託管。它非常適合希望完全控制其 AI 助理，同時保持與現有工作流程和通訊頻道整合彈性的開發者和進階用戶。

對於那些習慣於自我託管並尋求一個真正作為自主代理而非聊天機器人運行的 AI 助理的人來說，OpenClaw 提供了一個強大、開源的基礎。

Star History Chart