🎯 重點摘要: 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 會引導你:

  1. 選擇 AI 模型提供商 (OpenAI / Anthropic / Google / Ollama / 本地模型)
  2. 輸入 API 金鑰
  3. 設定工作空間與預設通道
  4. 選擇安裝的功能插件 (Skills)
  5. 啟動 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