🎯 重點摘要: OpenClaw 2.0 已正式發表!這是從「簡化設定 + 一流瀏覽器體驗」出發的大改版,新增桌面應用(Companion Nodes)、團隊 Gateway、29+ 頻道支援、Skills / Plugins 擴充與完整系統存取(網頁、檔案、終端機、表單):
① 了解 OpenClaw 2.0 的新架構(Gateway、Channels、Companion Nodes、Skills、Plugins)
② 安裝 2.0(桌面 App / curl / npm / pnpm / Bun)與首次 onboarding 操作
③ 掌握完整 CLI 命令與瀏覽器控制面板(dashboard)操作
④ 進階技巧:多頻道整合、團隊 Gateway、Skills 設定、Plugins 擴充、安全配對與沙箱審查
⑤ 常見問題解決 (診斷、錯誤排查、更新到 2.0)
30 分鐘從零開始,把自己的 AI 助手架設在本地或 VPS,完全掌控資料與隱私。2.0 讓操作更直覺、更像「你的個人 AI 同事」!
OpenClaw 2.0 新登場 — 有什麼不一樣?
嘿,朋友!如果你之前看過 OpenClaw 的介紹,這次 2.0 真的值得你重新認識一下。官方說這次是從「讓設定更簡單 + 給你一流的瀏覽器體驗」為出發點的大改版,結果就長成現在這個樣子了。簡單來說,2.0 讓 OpenClaw 從「好用的 AI 助手」進化成「在你裝置上跑的個人 AI 代理」。
2.0 的五大亮點
- 桌面應用 + 瀏覽器體驗(Companion Nodes / Desktop Apps):現在有原生桌面版,支援語音、Canvas 畫布、相機、螢幕擷取、裝置本地動作。不再只是 CLI,操作起來更像一個真正的「同事」。
- 29+ 聊天頻道支援:除了原本的 Telegram、Discord、WhatsApp、Slack、Signal、iMessage,現在還多了 Google Chat、Matrix、Microsoft Teams、Zalo、Facebook Messenger 等,基本上你平常用的聊天軟體都能串。
- 團隊 Gateway(Team Gateways):同一個 Gateway 不只服務一台筆電,還能當成團隊共享部署的控制平面。設定檔是唯一差別,擴展起來超方便。
- Skills + Plugins 擴充:Skills 是內建功能模組(像小工具箱),Plugins 則是透過 Plugin SDK 開發、可在 ClawHub 共享的新功能。想加什麼能力,通常寫成 Plugin 就對了。
- 完整系統存取 + 持久記憶:2.0 讓 AI 不只聊聊天,還能操作網頁(瀏覽、填表)、讀寫檔案、執行終端機指令、記住之前的對話內容。這讓它從「聊天機器人」變成「能幫你做事的代理」。
💡 2.0 操作心法 — 三步驟搞定:
① 安裝:桌面 App 最快(下載即用),或用npm i -g openclaw/curl安裝腳本
② Onboarding:跑openclaw onboard --install-daemon,選模型、設頻道、啟動 Gateway
③ 日常操作:打開openclaw dashboard看控制面板,或直接在 Telegram / Discord 對話。想擴充功能就去設定 Skills 或安裝 Plugins。
前言 — 什麼是 OpenClaw?
OpenClaw 是一個開源、自架的 AI 助手平台。你可以把它想像成「把 AI 串接到你已經用的聊天軟體上」的橋樑 — 不管是 Telegram、Discord、WhatsApp,還是 iMessage,只要設定好頻道,你就可以透過對話使用 AI 助手。
與以付費為主的 AI 助手不同,OpenClaw 是100% 開源(MIT 授權),你可以:
- 選擇自己的 AI 模型提供商 (OpenAI、Anthropic、Google、本地 Ollama 等)
- 自架在自己的電腦、VPS 或 NAS 上
- 完全掌控對話資料,無隱私疑慮
- 透過插件擴充功能(plugins)添加新功能
| 方案 | 開源 | 自架 | 多頻道 | 插件擴充 |
|---|---|---|---|---|
| OpenClaw | ✅ | ✅ | ✅ | ✅ |
| ChatGPT 官網 | ❌ | ❌ | ❌ | 部分 |
| Claude.ai | ❌ | ❌ | ❌ | 部分 |
| LangGate | ✅ | ✅ | ✅ | ✅ |
OpenClaw 架構概觀
OpenClaw 採用 Gateway 為核心控制平面 的架構:
| 元件 | 說明 |
|---|---|
| Gateway | 核心控制平面,處理 AI 模型串接、路由與安全驗證 |
| Channels | 連接 Discord、Telegram、WhatsApp、Slack 等聊天平台的插件 |
| Companion Nodes | 行動裝置與桌面上的輔助應用程式 |
| Control UI / CLI / TUI | 網頁控制面板、命令列介面與終端應用程式 |
系統需求
| 需求 | 說明 |
|---|---|
| Node.js | 版本 22.22.3+、24.15+ 或 25.9+ (建議 26) |
| 作業系統 | macOS / Linux / Windows (原生或 WSL2) |
| Git | 選用,僅在源碼安裝時需要 (安裝器會自動安裝) |
| pnpm | 選用,僅在源碼建構時需要 |
安裝教學
方法 1:安裝腳本 (推薦)
官方提供一鍵安裝腳本,會自動檢測作業系統、安裝 Node.js 並完成設定:
macOS / Linux / WSL2:
curl -fsSL https://openclaw.ai/install.sh | bash
如不想執行 onboarding:
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
Windows (PowerShell):
iwr -useb https://openclaw.ai/install.ps1 | iex
跳過 onboarding:
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
方法 2:npm 安裝
如果你已經有 Node 環境,可以直接用 npm 安裝:
npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon
方法 3:pnpm 安裝
pnpm add -g --allow-build=openclaw openclaw@latest
openclaw onboard --install-daemon
方法 4:Bun 安裝
bun add -g --trust openclaw@latest
openclaw onboard --install-daemon
方法 5:從 GitHub (開發版)
想使用最新開發版本的話:
curl -fsSL --proto '=https' --tlsv1.2 \
https://openclaw.ai/install.sh \
| bash -s -- --install-method git --version main
方法 6:從源碼建構 (開發者)
如果你是開發者或想貢獻程式碼:
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon
💡 安裝腳本支援的選項:
--no-prompt— 禁用互動式提示
--no-onboard— 跳過 onboarding 流程
--verify— 安裝後驗證
--dry-run— 預覽動作但不執行
--verbose— 顯示偵錯訊息
基本使用
驗證安裝
安裝完成後,驗證版本與健康狀態:
# 檢查版本
openclaw --version
# 執行診斷
openclaw doctor
# 檢查 Gateway 狀態
openclaw gateway status
執行 Onboarding
首次運行需要設定 AI 模型、建立工作空間、配置 Gateway、設定 Channels 和 Skills。
openclaw onboard --install-daemon
Wireshark 會引導你:
- 選擇 AI 模型提供商 (OpenAI / Anthropic / Google / Ollama / 本地模型)
- 輸入 API 金鑰
- 設定工作空間與預設通道
- 選擇安裝的功能插件 (Skills)
- 啟動 Gateway 服務
打開控制面板
openclaw dashboard
會自動在瀏覽器中打開 Web 控制面板,你可以在上面:
- 查看 Gateway 狀態
- 管理已連接的 Channels
- 查看對話歷史
- 配置模型與插件
完整 CLI 命令速查
OpenClaw 提供豐富的 CLI 命令,用於設定、管理與開發:
設定與診斷
| 命令 | 說明 |
|---|---|
openclaw onboard |
執行引導式安裝流程 |
openclaw setup |
驗證推理後開始設定 Gateway、工作空間、Channels、Skills |
openclaw setup --baseline |
建立基線配置與工作空間,不進入引導流程 |
openclaw configure |
修改現有設定 (模型 auth、Gateway、Channels、Plugins、Skills) |
openclaw doctor |
診斷安裝環境並檢查設定問題 |
openclaw config |
配置管理:get、set、unset、file、schema、validate |
Gateway 管理
| 命令 | 說明 |
|---|---|
openclaw gateway status |
顯示 Gateway 服務狀態 |
openclaw gateway run |
在前台啟動 Gateway |
openclaw gateway start |
啟動 Gateway (背景服務) |
openclaw gateway stop |
停止 Gateway |
openclaw gateway restart |
重新啟動 Gateway |
openclaw gateway health |
檢查 Gateway 健康程度 |
Channel (頻道) 管理
| 命令 | 說明 |
|---|---|
openclaw channels list |
列出所有已配置的 Channel |
openclaw channels add |
添加新的 Channel (引導式設定) |
openclaw channels status |
顯示 Channel 狀態 |
openclaw channels login |
登入 Channel 帳號 |
openclaw channels logout |
登出 Channel 帳號 |
openclaw channels remove |
移除 Channel |
Agent 與對話
| 命令 | 說明 |
|---|---|
openclaw tui |
啟動終端應用程式 (TUI) |
openclaw chat |
聊天模式 (tui --local 的別名) | openclaw agents list |
列出所有 Agent |
openclaw agents add |
添加新 Agent |
openclaw message send |
發送訊息 |
更新與維護
| 命令 | 說明 |
|---|---|
openclaw update |
更新 OpenClaw (子命令: wizard、status、repair) |
openclaw backup create |
建立備份 |
openclaw migrate list |
查看可用遷移 |
openclaw migrate apply |
套用遷移 |
openclaw reset |
重置安裝 |
openclaw uninstall |
完全移除 OpenClaw |
全局選項 (Global Flags)
openclaw [命令] --dev # 開發模式 (隔離狀態於 ~/.openclaw-dev)
openclaw [命令] --profile # 使用命名稱隔離狀態 (~/.openclaw-)
openclaw [命令] --container # 在容器中執行 CLI
openclaw [命令] --log-level debug # 設定日誌等級
openclaw [命令] --no-color # 禁用顏色輸出
進階技巧
Docker 部署
OpenClaw 也可以透過 Docker 容器化部署,特別適合 VPS 或 NAS 環境:
# 拉取官方 Docker 映像
docker run -d \
--name openclaw \
-p 3010:3010 \
-v ~/.openclaw:/root/.openclaw \
openclaw/openclaw:latest
多代理器路由 (Multi-Agent Routing)
OpenClaw 支援配置多個 Agent,並根據訊息類型或來源路由到不同的 Agent 來處理。
# 列出所有 Agent
openclaw agents list
# 添加 Agent
openclaw agents add --name my-agent --model gpt-4
安全配對 (Pairing)
當來自未知發送者的訊息進來時,OpenClaw 會要求配對 (pairing) 才會處理。這是一個安全機制,防止來路不明的請求。
# 查看配對請求列表
openclaw pairing list
# 批准配對
openclaw pairing approve telegram <配對碼>
匯出診斷資訊
如果遇到問題,可以匯出診斷資訊給開發者:
# 匯出診斷
openclaw gateway diagnostics
容器管理
OpenClaw 的 Gateway 可以透過 Daemon 進行管理:
# Daemon 管理
openclaw daemon status # 查看狀態
openclaw daemon install # 安裝為系統服務
openclaw daemon start # 啟動服務
openclaw daemon stop # 停止服務
openclaw daemon restart # 重新啟動
狀態隔離 (Profile/Container)
開發或測試時可以使用 --profile 或 --container 進行狀態隔離:
# 使用 profile 隔離狀態
openclaw onboard --profile dev
openclaw dashboard --profile dev
OpenClaw 2.0 桌面應用與瀏覽器操作
2.0 最大的改變是「你不再只能靠 CLI 操作了」。現在有原生桌面應用(Companion Nodes / Desktop Apps),打開後你會看到一個更直覺的控制介面:
- 語音輸入:直接對著電腦說話,AI 會即時回應,就像跟同事聊天一樣自然。
- Canvas 畫布:可以在畫布上畫草圖、標註,AI 會理解你的視覺內容並協助修改。
- 螢幕擷取 + 相機:讓 AI 直接「看到」你的螢幕或透過相機看實體物品,然後幫你分析或操作。
- 瀏覽器控制面板(Dashboard):打開
openclaw dashboard後,你可以在瀏覽器中直接查看 Gateway 狀態、管理 Channels、檢視對話記錄、調整模型設定。不用記一堆 CLI 指令,點選就搞定。
操作步驟很簡單:安裝完後跑 openclaw onboard --install-daemon → 啟動 Gateway → 打開桌面 App 或瀏覽器面板 → 開始對話。如果你想在團隊中共享同一個 Gateway,只要確保所有成員的設定檔指向同一個控制平面即可(Team Gateway)。
Skills 與 Plugins 如何操作
2.0 把擴充功能分成兩種,操作上也不一樣:
- Skills(內建功能模組):在 onboarding 時選擇安裝,或事後用
openclaw configure調整。像小工具箱,直接整合進 Gateway,不用額外開發。 - Plugins(透過 Plugin SDK 開發):想加新功能時,寫一個 Plugin,然後透過 ClawHub 分享或本地安裝。這讓 2.0 的擴充性比以前更強,基本上只要你想得到的功能,都可以自己寫一個 Plugin 加進去。
# 查看已安裝的 Skills
openclaw configure --skills
# 安裝新 Plugin(本地或從 ClawHub)
openclaw plugins install <plugin-name>
# 列出所有 Plugins
openclaw plugins list
安全配對與沙箱審查(2.0 更嚴謹)
2.0 對安全更重視。所有來自未知發送者的訊息,都必須經過配對核准(pairing approval)才會被處理。這不是多餘的步驟,而是防止來路不明的請求直接操作你的系統。另外,2.0 也引入了沙箱審查機制,讓你可以檢視每個 Plugin 或 Skill 在執行時會存取哪些系統資源,確保沒有隱私外洩的風險。
# 查看配對請求
openclaw pairing list
# 核准配對
openclaw pairing approve telegram <配對碼>
# 檢視 Plugin 的沙箱權限
openclaw plugins inspect <plugin-name>
實用技巧
- 設定金鑰記錄檔:
openclaw configure→ 選擇「model auth」,可設定本地模型 (如 Ollama) 供離線使用 - 更新頻道:
openclaw update --channel dev可切換到開發版獲得最新功能 - 備份設定:
openclaw backup create可備份你的配置與工作空間 - 清理會話:
openclaw sessions cleanup清理過期的對話會話 - 狀態檔案位置:配置檔位於
~/.openclaw/openclaw.json,可以使用openclaw config file快速打開
常見問題 (FAQ)
Q1: OpenClaw 能連接哪些 AI 模型?
OpenClaw 支援多種模型提供商,包括:
- OpenAI (GPT-4、GPT-4o、o1 等)
- Anthropic (Claude 3、Claude 4 等)
- Google (Gemini 1.5、Gemini 2.0 等)
- 本地模型 (透過 Ollama、llama.cpp、LM Studio 等)
在 onboarding 時選擇即可。
Q2: OpenClaw 支援哪些聊天頻道?
目前支援:
- Discord、Telegram、WhatsApp、Signal、Slack
- iMessage (macOS)、Matrix、Microsoft Teams
- Zalo、Facebook Messenger 等插件頻道
插件頻道可以透過 openclaw channels add 進行設定。
Q3: OpenClaw 會收集我的資料嗎?
不會。OpenClaw 是 100% 開源、自架的工具。你的 API 金鑰、對話資料與配置全部儲存在你的本地設備 (~/.openclaw/),OpenClaw 開發團隊無法存取。
Q4: 如何在 VPS 上部署 OpenClaw?
推薦使用 Docker 部署:
docker run -d \
--name openclaw \
-p 3010:3010 \
-v ~/.openclaw:/root/.openclaw \
openclaw/openclaw:latest
或使用 Docker Compose 進行更複雜的部署。
Q5: OpenClaw 如何更新?
# 更新到最新版本
openclaw update
# 切換到開發版
openclaw update --channel dev
# 更新狀態
openclaw update status