OpenClaw 2.0 解析：功能、安裝指南與升級風險

TL;DR： OpenClaw 2.0（版本標籤 v2026.8.1，於 2026 年 8 月 30 日深夜/8 月 31 日清晨發布）是開源 AI 代理 OpenClaw 歷史上規模最大的更新。

由 933 位貢獻者（其中 569 位為首次貢獻）提交逾 16,000 個 Pull Request（約占專案歷史合併 PR 的一半）打造，這次更新簡化了導入流程，將瀏覽器控制 UI 重建為以聊天為先的體驗，引入多人共享雲端工作階段，整合記憶，強化技能與安全控制，並幾乎觸及每個子系統。

安裝現已大幅簡化，透過引導式偵測既有的 ChatGPT/Claude 訂閱、API 金鑰與本地模型即可開始。升級具備真實但可控的風險（SQLite 工作階段遷移、外掛移除、模型路由改名）。在生產環境或需要多模型彈性時，將 OpenClaw 與 CometAPI 等統一路由閘道配對（一把金鑰即可使用 500+ 模型，價格具競爭力）是務實的建議。

Key Takeaways

OpenClaw 2.0 並非傳統語義化版本跳躍，而是基於規模的 “2.0” 標籤（最大規模之整合釋出），在先前 230 天內發布 106 個版本後，又經近七週聚焦整合工作產生。
核心進展：接近零設定的首次啟動、重建為聊天優先的瀏覽器應用（含 Session Rail 與小工具）、共享雲端工作階段（“multiplayer”）、具背景整合與自我學習的內建記憶、Skill Workshop、更強的（但非預設強化）權限與憑證模型。
透過官方指令碼安裝最簡單（curl ... | bash 或 PowerShell 等效）；Windows 與 macOS 亦提供桌面伴侶應用。
升級需先完成可驗證備份；三項主要遷移（SQLite 工作階段、OpenProse 移除、codex/* → openai/*）多由 openclaw doctor --fix 處理。釋出初期問題集中在非互動式 doctor 執行。
安全仍由操作員負責：共享工作階段是協作控制（非租戶隔離）、Secret Store 預設不做靜態加密，且沙箱預設關閉——批評者已指出這些缺口。
為了模型彈性、成本控管與冗餘，將 OpenClaw 配置為使用 CometAPI 的自訂提供者（同一金鑰支援 OpenAI-compatible、Anthropic-messages 與 Google 格式）是可取之道。

What Is OpenClaw?

OpenClaw 是一款免費、開源（MIT License）、自託管的自主式 AI 代理/個人助理，主要在你的本機硬體上執行（macOS、Linux、Windows，Windows 建議使用 WSL2）。不同於僅存在於瀏覽器分頁並只提出建議的純聊天機器人（如 ChatGPT），OpenClaw 會執行真實任務：管理檔案、控制瀏覽器、透過 WhatsApp、Telegram、Slack、Discord、Signal、iMessage 與其他渠道發送訊息、自動化工作流程，並維持持久記憶。

它於 2025 年底誕生（最初為 Warelay/相關專案），由 Peter Steinberger 與社群共同推動，後來重新命名並開源，現由 OpenClaw Foundation 維護。其架構以本地 Gateway（管理工作階段、工具、事件與渠道的控制平面）為核心，搭配 Control UI/CLI/TUI、訊息渠道外掛與可選的伴侶應用。模型可為託管（OpenAI、Anthropic、Google 等）、訂閱支援或完全本地（Ollama、LM Studio、llama.cpp）。狀態與憑證由使用者掌控。

到 2026 年年中，該專案以驚人速度出貨——約 230 天內釋出 106 次——其後暫停近七週以整合基礎工程。這段暫停孕育了 OpenClaw 2.0。

另見 Top 6 OpenClaw Skills you can't afford to miss in 2026

Major Features of OpenClaw 2.0

Simplified, Guided Installation and Onboarding

首次設定現在會偵測機器上已存在的資源：既有的 ChatGPT、Claude 或 Codex 登入/訂閱、API 金鑰與符合條件的本地模型（Ollama、LM Studio）。安裝程式會先驗證所選模型能否實際完成請求再保存憑證，並將多數其餘設定移出初始精靈。使用者更快進入第一段對話，並透過與代理對話完成剩餘設定。

預設的 OpenAI 傾向設定偏向較新的模型（某些處提及預設為 GPT-5.6）；本地路徑有所改進（例如以託管的 llama-server 取代較舊的 node-llama-cpp 路徑、更高的預設上下文長度）。

Rebuilt Browser Control UI (Chat-First Experience)

瀏覽器應用已重建為一級介面。它會直接開啟至對話。舊的 Overview 頁面已移除；工作階段位於側邊欄。檔案、核准、終端機、git 差異與可停駐的瀏覽器面板與聊天並列。「Session Rail」提供精簡的即時狀態（進度、評分、計畫步驟、Pull Request）。互動式小工具可釘選到工作階段儀表板，並可授予限定範圍的動作或網路來源，且支援匯出。在模擬環境中的效能聲明包括減少 JavaScript 請求（140 → 45）與更快啟動（~1.6 s → ~575 ms）。

Shared Cloud Sessions (“Multiplayer”)

主打的協作功能：多位使用者可加入同一個進行中的代理工作階段，擁有完整上下文，分配任務、提出變更建議、以草稿模式工作或完整參與。存取層級可由擁有者/管理員控制。OpenClaw 團隊本身現在就以此模式構建 OpenClaw。工作階段可在本地 Gateway、配對裝置（openclaw connect）或透過佈建工具（AWS、Hetzner 等）在一次性雲端機器上執行。專案特別提醒：這些是協作控制，不是敵意租戶隔離或網路/檔案系統的安全邊界。

Memory System Consolidation

內建記憶現在掌管核心搜尋與回憶（QMD 外掛透過支援的遷移而退役）。背景整合（“grounded dreaming”）會將具來源證據的材料提升至長期記憶（附 Dream Diary，且可明確關閉）。自我學習可將強而可重用的經驗轉為建議的技能。提供全文對話搜尋。也有明確控制，例如 openclaw memory forget。預設情況下，工作階段在閒置期與跨越日界線時更具持久性。

Skills, Automations, and Widgets

Skill Workshop 提供建立、驗證、安裝、呼叫與檢視技能的引導路徑，具備應用歷史與單獨回報無效技能，而不會造成目錄整體損壞。自動化可與創建它的對話保持連結；重複動作可使用一次性核准。IMAP 外掛可由收到的電子郵件觸發代理工作。互動式小工具與可持久的進度卡讓 UI 成為真正的控制介面。

Security and Permission Model Improvements

核准現在更緊密綁定至精確的請求、指令、工作階段與人員。可重用的指令權限可綁定至精確的參數與工作目錄；以腳本為後盾的指令會重新檢查已審閱的位元組。工作階段支援明確模式：唯讀、受保護、工作區或完全存取。團隊憑證儲存將特定祕密值設為唯寫；代理可經由遮罩提示請求憑證，而這些內容永不進入模型可見的文字。從任意可執行來源安裝外掛需要顯式的強制旗標。這些是在早先安全諮詢後的實質進步，但批評者指出仍存不足（詳見風險章節）。

Other Notable Changes

模型與提供者擴充與路由清理
原生應用與伴侶更新
支援新工作階段模型的儲存後端變更
覆蓋各渠道與工具的大量錯誤修正與可靠性提升

How to Install OpenClaw 2.0

System Requirements

Node.js 22.22.3+、24.15+ 或 25.9+（建議 Node 26；安裝器通常會佈署合適版本）
macOS、Linux 或 Windows（強烈建議在 Windows 上使用 WSL2 執行 Gateway）
選用：若從原始碼建置，則需 pnpm

桌面伴侶：

Windows Hub（為 x64/arm64 提供已簽章安裝程式）
macOS 功能表列應用（DMG/ZIP 可自 GitHub 版本頁下載）

Recommended: Official Installer Script

macOS / Linux / WSL2:

curl -fsSL https://openclaw.ai/install.sh | bash

Windows (PowerShell):

iwr -useb https://openclaw.ai/install.ps1 | iex

此指令碼會偵測作業系統、在需要時安裝 Node、安裝 OpenClaw，並啟動導入流程。亦提供 --no-onboard 與其他自動化旗標。

Alternative Methods

npm（已自管 Node）：

  npm install -g openclaw@latest --allow-scripts=openclaw   # adjust for older npm
  openclaw onboard --install-daemon

使用 pnpm 或 bun 的等效方式，搭配適當的 trust/allow-build 旗標
從原始碼（貢獻者）：

  git clone https://github.com/openclaw/openclaw.git
  cd openclaw
  corepack enable
  pnpm install && pnpm build && pnpm ui:build
  pnpm add --global "openclaw@link:$PWD"
  openclaw onboard --install-daemon

高階部署的本地前綴安裝與容器/VPS 選項已於文件中說明。

Post-Install Verification

openclaw --version
openclaw doctor
openclaw gateway status
openclaw dashboard   # or open http://127.0.0.1:18789/ on the gateway host

受管啟動在 macOS 使用 LaunchAgents、在 Linux/WSL2 使用使用者層級 systemd 服務，或在原生 Windows 使用排程工作。完整詳情請參閱官方安裝文件。

Upgrade Path and Risks

Pre-Upgrade Checklist

為你的 OpenClaw 狀態目錄、設定、工作階段與任何自訂外掛/技能建立「可驗證的備份」。
檢閱官方版本說明（docs.openclaw.ai/releases/2026.8.1）與更新指南。
優先在互動式終端（TTY）進行升級與 doctor 步驟——初期回報顯示非互動式 doctor --fix 可能會靜默略過 2.0 遷移。

Known Migrations and Breaking Changes

變更	影響與行動
Sessions & transcripts → SQLite	遷移後的新工作階段在降級至舊版本時不會出現。請先備份。
Bundled OpenProse plugin & /prose command removed	執行 openclaw doctor --fix；依上游 Agent Skill 遷移。既有 .prose 檔將保留。
codex/* and openai-codex/* model refs → openai/*	openclaw doctor --fix 會遷移路由、提供者設定、已儲存的工作階段與自動化。衝突將標記以供手動修復。
Plugin SDK subpath deprecations	2026-09-01 起生效；請依 SDK 遷移指南更新外掛。

大部分清理由 openclaw doctor --fix（或 --repair）處理。升級後，請重新評估每個工作階段的權限模式（偏好最小必要權限），並重新套用先前諮詢中的強化清單。

Early Post-Release Issues (as of late August 31 reporting)

在無 TTY 下 doctor --fix 會略過遷移（P1，迅速修正）
某些嵌入提供者的記憶同步問題（如 Gemini 批次限制）
舊安裝的外掛同意持久化
儀表板就緒狀態誤判

如此規模的釋出通常會有後續修補；請持續關注官方追蹤器與版本說明。

Security Risks Highlighted by Coverage

The Register 等指出，雖然可用性大幅提升，但「預設安全」並未完全跟上：

共享工作階段控制並非網路或檔案系統層級的隔離/租戶邊界。
Secret Store 值（密碼、API 金鑰）預設「不進行靜態加密」；仰賴狀態目錄的檔案系統權限。
用於隔離不受信任程式碼的沙箱「預設未啟用」。

2026 年較早的分析（2.0 前）已紀錄明文憑證、提示注入導致破壞性動作、高嚴重性 CVE 與技能市集（ClawHub）的供應鏈風險。2.0 強化了核准綁定與權限模式，但操作員仍需負責最小權限配置、網路隔離、祕密管理與啟用沙箱。切勿輕率賦予能力強大的代理廣泛的系統與憑證存取。

Comparison Table: OpenClaw Pre-2.0 vs OpenClaw 2.0

面向	2.0 前（2026 年年中常見）	OpenClaw 2.0（v2026.8.1）
安裝	首次執行需較多設定	引導式偵測既有金鑰/訂閱/本地模型；以聊天完成設定
瀏覽器/控制 UI	以 Overview 為中心，整合度較低	以聊天為先、Session Rail、小工具、可停駐面板
協作	主要為單人/本地	共享雲端工作階段，具角色式參與
記憶	分散/QMD 外掛常見	整合內建 + 背景整合 + 自我學習
技能	較為臨時	Skill Workshop、驗證、歷程
工作階段儲存	既有格式	SQLite（需遷移）
安全模型	改進中但偏重政策	更緊密的核准綁定、明確工作階段模式、唯寫祕密（預設仍倚賴操作員）
釋出規模	小步快跑	史上約 50% PR 一次整合釋出

How to Power OpenClaw with CometAPI: Recommended Integration

OpenClaw 對模型中立。你可以指向官方提供者金鑰、本地模型，或使用統一閘道。對需要單一 API 金鑰即可使用 500+ 模型（GPT 系列、Claude 系列、Gemini 與更多）、具競爭力定價（常較標價低 20%+）、便於切換與集中觀測的團隊與進階使用者而言，CometAPI 是自然的選擇。CometAPI 在同一憑證下提供 OpenAI-compatible、Anthropic-messages 與 Google-generative-ai 端點。

Five-minute tutorial on configuring OpenClaw with CometAPI

從 cometapi.com 取得 CometAPI 金鑰。
安全儲存（例如在 ~/.openclaw/.env 中設置 COMETAPI_KEY 並限制權限，或使用你偏好的祕密管理器）。
編輯 ~/.openclaw/openclaw.json（或等效檔）以新增提供者，例如：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "cometapi-claude/claude-sonnet-4-6"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "cometapi-openai": {
        "baseUrl": "https://api.cometapi.com/v1",
        "apiKey": "${COMETAPI_KEY}",
        "api": "openai-completions",
        "models": [{ "id": "gpt-5.4", "name": "GPT-5.4" }]
      },
      "cometapi-claude": {
        "baseUrl": "https://api.cometapi.com",
        "apiKey": "${COMETAPI_KEY}",
        "api": "anthropic-messages",
        "models": [{ "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }]
      },
      "cometapi-google": {
        "baseUrl": "https://api.cometapi.com/v1beta",
        "apiKey": "${COMETAPI_KEY}",
        "api": "google-generative-ai",
        "models": [{ "id": "gemini-3.1-pro-preview", "name": "Gemini 3.1 Pro" }]
      }
    }
  }
}

（實際模型 ID 與路徑請參考當前 CometAPI 與 OpenClaw 文件，因目錄會持續演進。）在工作階段中使用完整的 provider/model 參照。變更後請重啟 Gateway，並以測試對話驗證。

此設定讓你無需為多家供應商重複管理金鑰即可嘗試不同前沿或高性價比模型，同時保留 OpenClaw 的自託管控制平面。詳細指南見 CometAPI 的 OpenClaw 整合頁面。

Practical Recommendations and Best Practices

使用引導式安裝與重建的瀏覽器 UI，最快速取得可用代理。
將共享工作階段視為可信成員間的協作功能；若有多租戶顧慮，請疊加額外的網路與主機隔離。
一律以每個工作階段可行的最窄權限運行，並對不受信任的技能/程式碼啟用沙箱（如可用）。
每次重大升級前務必備份；2.0 級別的釋出後請以互動式方式執行 doctor。
若需多模型或成本敏感的工作負載，透過 CometAPI 之類的閘道進行路由，而非管理多個供應商金鑰。
追蹤官方版本說明、GitHub 追蹤器與安全諮詢——OpenClaw 的速度意味著功能與修補會快速到來。
謹記專案自我定位：OpenClaw 是開源且屬於你的。2.0 降低了取得第一個有用工作流程的門檻，同時擴大了團隊與持續使用的上限。

Frequently Asked Questions (FAQs)

What is the exact version number of OpenClaw 2.0?

出貨標籤為 v2026.8.1（2026 年 8 月 30 日深夜/8 月 31 日）。由於其前所未有的規模，專案與社群稱其為 OpenClaw 2.0。

Is OpenClaw 2.0 a breaking upgrade?

多為增量，但三項刻意的遷移（SQLite 工作階段、OpenProse 移除、模型路由改名）需注意。正確執行時，openclaw doctor --fix 可處理大部分工作。

How long does a typical install take?

在使用官方指令碼且既有 AI 存取已就緒的情況下，多數使用者可在數分鐘內達成第一次對話。完整設定可透過對話持續進行。

Can I still use local models?

可以。Ollama、LM Studio，以及改進的 llama.cpp/llama-server 路徑均受支援，並會於引導式設定中偵測。

Is OpenClaw free?

軟體採 MIT 授權且免費。成本來自你選擇的 LLM 提供者（或本地運算）。像 CometAPI 這樣的閘道可降低有效模型成本。

Should enterprises use the shared session feature immediately?

僅建議在互相信任的參與者之間使用，並在審閱文件中明確的「非隔離」聲明後再行導入。請結合主機層與網路控制。

Where do I find official release notes and docs?

主要來源：openclaw.ai 部落格、docs.openclaw.ai（包含 2026.8.1 版本頁與安裝/更新指南），以及 GitHub 儲存庫 github.com/openclaw/openclaw。

How do I switch models or providers after install?

編輯設定（或與代理對話完成設定）、重啟 Gateway，並驗證。CometAPI 等自訂提供者可透過 models.providers 結構順暢整合。

OpenClaw 2.0 代表自託管代理類別的成熟節點：顯著降低入門摩擦、提供更豐富的連續性與協作能力，並具更清晰（雖仍由操作員承擔）的安全基礎。無論你是尋求具持續性的個人代理，或是探索多人代理工作流程的小型團隊，2.0 皆是該專案迄今最強的起點。搭配謹慎的權限衛生，以及在需要多模型彈性時使用 CometAPI 等統一 API 層，你即可擁有強大且真正屬於你的工作基礎。

在生產部署前，請務必再次查核最新官方文件，因為專案仍在快速演進之中。