Key Findings
  • OpenClaw 是 2026 年初 GitHub 史上增長最快的開源專案，本質是一個安裝在你電腦上的 AI 自主代理，能透過 WhatsApp、Telegram 等通訊軟體遠端控制你的整台電腦
  • 部署極度簡化——一條命令即可完成安裝，搭配互動式 Onboarding Wizard 完成全部設定，支援 macOS、Linux 與 Windows
  • 其四層架構（Gateway → Nodes → Channels → Skills）讓 AI 不再只是聊天工具，而是能執行瀏覽器自動化、定時任務、程式開發的全能助理
  • 本文以實測方式完整走過部署、模型設定、通訊渠道串接、瀏覽器自動化、定時簡報、Claude Code 程式開發，以及進階的 Hooks 零輪詢 + Agent Teams 多智能體協作方案
步驟導覽
基礎部署
三、環境需求與前置準備 Step 1 — 安裝與 Onboarding Step 2 — 模型設定 Step 3 — 串接通訊渠道 Step 4 — 安裝 Skills 與啟用 Hooks
進階場景
實戰場景 1 — 瀏覽器自動化 實戰場景 2 — 定時任務 實戰場景 3 — Claude Code 自動開發 進階：Hooks 零輪詢 + Agent Teams 進階：Supermemory 長期記憶

一、為什麼你需要關注 AI 自主代理

2026 年初，AI 產業正在經歷一場靜默但深刻的典範轉移：從「人類提問、AI 回答」的對話模式，走向「人類下達目標、AI 自主規劃並執行」的代理模式。

過去三年，我們習慣的 AI 互動方式是這樣的——打開 ChatGPT 或 Claude，輸入一個問題，等待一段回覆，然後自己決定下一步。AI 是一個強大的顧問，但執行仍然靠人。

但 AI 代理（AI Agent）徹底改變了這個邏輯。一個真正的 AI 代理不只回答你的問題——它理解你的意圖、拆解為子任務、調用工具逐步執行、在過程中自我修正、最終交付結果。你不再需要逐步指揮 AI，而是像對一個有經驗的助理說「幫我把這件事搞定」，然後去做其他事情。

OpenClaw（原名 ClawdBot / MoltBot）正是這場範式轉移中最具代表性的開源產品。它在 GitHub 上兩天內突破 10 萬顆星[2]，被 Scientific American、CNBC 等主流媒體廣泛報導[1][3]，成為 2026 年初最受矚目的 AI 專案——不是因為它的技術有多前沿，而是因為它讓普通人第一次真正體驗到「AI 接管電腦」是什麼感覺。

在我們之前的文章《OpenClaw 初探》中，我們從團隊視角分析了 OpenClaw 的核心價值與風險。本文則聚焦於實作——從零開始，手把手帶你完成 OpenClaw 的安裝、設定與六個實戰場景的完整教程。

二、系統架構速覽：理解 OpenClaw 的四層設計

在動手之前，先花兩分鐘理解 OpenClaw 的架構，這會幫助你在後續設定過程中更快掌握全貌。

OpenClaw 採用四層架構設計[3]：

此外還有一個貫穿全局的Memory（記憶層），以 Markdown 文件形式持久化儲存你的對話脈絡與偏好，讓 OpenClaw 越用越懂你。

理解了這四層，後面的每一步設定你都會知道自己在設定「哪一層」的東西。

以下進入實作環節

三、環境需求與前置準備

開始安裝前，請確認你的環境滿足以下條件：

如果你尚未安裝 Node.js 22，可以透過以下方式快速安裝：

🔧 執行指令
# macOS（使用 Homebrew）
brew install node@22

或使用 nvm


nvm install 22
nvm use 22

Step 1安裝與 Onboarding ⏱ 約 5 分鐘

OpenClaw 的安裝過程被極度簡化。打開終端機，執行以下命令[8]：

🔧 執行指令
# macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bash

Windows（PowerShell）


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

你也可以透過 npm 全域安裝：

🔧 執行指令
npm i -g openclaw

安裝完成後，執行 Onboarding Wizard——這是 OpenClaw 的互動式設定精靈，會一步步引導你完成所有初始設定：

🔧 執行指令
# 啟動 Onboarding 精靈（同時安裝系統 Daemon 服務）
openclaw onboard --install-daemon

Onboarding Wizard 會依序引導你完成七個步驟：模型認證 → 工作空間 → Gateway 設定 → 通訊渠道 → Daemon 服務 → 健康檢查 → Skills 安裝。如果你是第一次使用，選擇 QuickStart 模式即可，它會自動配置合理的預設值。

設定完成後，確認 Gateway 狀態：

🔧 執行指令
# 檢查 Gateway 運行狀態
openclaw gateway status

你應該會看到 Gateway 已在 http://127.0.0.1:18789/ 上運行的訊息。你也可以啟動 Control UI 瀏覽器介面：

🔧 執行指令
# 開啟網頁版控制介面
openclaw dashboard

Control UI 提供了一個直觀的網頁介面，讓你可以在瀏覽器中直接與 OpenClaw 對話、查看歷史訊息與系統狀態。如需手動在前台啟動 Gateway（常用於除錯）：

📖 僅供參考（除錯用）
# 在前台啟動 Gateway（適合測試與除錯）
openclaw gateway --port 18789
✅ 確認點 執行 openclaw gateway status 應顯示 Gateway 已在 http://127.0.0.1:18789/ 上運行。開啟 openclaw dashboard 可看到網頁版控制介面。

Step 2模型設定：為 AI 大腦選擇引擎 ⏱ 約 3 分鐘

如果你在 Onboarding 時已完成模型設定，可以跳過這一步。若需要事後調整，OpenClaw 提供了靈活的模型管理機制。

OpenClaw 本身不內建大型語言模型——它需要連接外部 LLM 作為推理核心。模型使用 provider/model 格式引用，例如 anthropic/claude-sonnet-4-5。

🔧 執行指令
# 重新進入設定精靈
openclaw configure

或僅設定特定區塊


openclaw configure —section web

你也可以透過 CLI 直接讀取與修改設定值：

🔧 執行指令
# 查看目前的預設模型
openclaw config get agents.defaults.model.primary

設定預設模型


openclaw config set agents.defaults.model.primary “anthropic/claude-sonnet-4-5”


設定備援模型


openclaw config set agents.defaults.model.fallbacks ’[“openai/gpt-4o”]‘

若使用 Anthropic Claude（推薦，OpenClaw 原生即基於 Claude 生態），你需要前往 Anthropic Console 取得 API Key。API Key 可在設定檔中使用環境變數引用：

📄 設定檔
# API Key 支援環境變數替換
# 在 ~/.openclaw/openclaw.json 中可寫成：
# "apiKey": "${ANTHROPIC_API_KEY}"

也可直接透過 CLI 設定


openclaw config set agents.defaults.model.primary “anthropic/claude-sonnet-4-5”

如果設定出現問題，可以使用內建的診斷工具：

🔧 執行指令
# 驗證設定是否正確
openclaw doctor

自動修復常見問題


openclaw doctor —fix

✅ 確認點 執行 openclaw doctor 應顯示所有檢查項目通過。模型設定正確後，可在 Control UI 中發送測試訊息確認 AI 能正常回覆。

Step 3串接通訊渠道：用手機控制你的電腦 ⏱ 約 5 分鐘

這是 OpenClaw 最令人驚豔的功能之一——透過 WhatsApp、Telegram、Discord 等通訊軟體向你的電腦下達指令。Onboarding Wizard 的第四步已涵蓋渠道設定，但你也可以事後手動添加。

OpenClaw 採用 Pairing（配對）機制管理渠道存取權限。以 Telegram 為例：

🔧 執行指令
# 啟動 Gateway 後，查看待配對的裝置
openclaw pairing list telegram

核准配對


openclaw pairing approve telegram <CODE>

WhatsApp 渠道則透過 QR Code 掃碼完成綁定。所有渠道設定都儲存在 ~/.openclaw/openclaw.json 的 channels 區塊中，支援的存取控制策略包括：

綁定完成後，你可以：

目前支援的渠道包括：WhatsApp、Telegram、Discord、Slack、Signal、iMessage、Google Chat、Mattermost 與 MS Teams。你也可以用 CLI 快速發送測試訊息：

🔧 執行指令
# 發送測試訊息
openclaw message send --target +886912345678 --message "Hello from OpenClaw"

設定完渠道後，透過手機發送一則訊息給 OpenClaw，例如「你好，請告訴我現在的時間」。如果一切正常，OpenClaw 會在幾秒內回覆。

✅ 確認點 透過手機向 OpenClaw 發送「你好」，應在數秒內收到回覆。執行 openclaw pairing list <channel> 應顯示已配對的裝置。

Step 4安裝 Skills 與啟用 Hooks ⏱ 約 3 分鐘

Skills 是 OpenClaw 的能力擴展機制。Onboarding Wizard 的第七步會引導你安裝推薦技能，但你也可以事後隨時追加。OpenClaw 目前提供 50+ 整合，包含 Gmail、GitHub、Spotify、Obsidian 等。

🔧 執行指令
# 查看可用 Skills
openclaw skills list

安裝瀏覽器自動化技能


openclaw skills install browser-automation


安裝 BlogWatcher（部落格/RSS 監控）


openclaw skills install blogwatcher

Hooks（Webhooks）功能讓你在特定事件觸發時自動執行動作，可在 ~/.openclaw/openclaw.json 的自動化區塊中設定。

OpenClaw 還有一個獨特的能力：它可以自己創建 Skills。當 AI 判斷某個任務需要特定功能而現有 Skills 不足時，它能自行撰寫新的技能模組並載入。所有自訂技能存放在工作空間的 skills 目錄下。

✅ 確認點 執行 openclaw skills list 應顯示已安裝的技能清單，包含 browser-automation 等。至此基礎部署已完成，可進入實戰場景。

八、實戰場景 1——瀏覽器自動化

安裝 browser-automation 技能後，OpenClaw 可以遠端控制 Chromium 瀏覽器——開啟網頁、抓取資訊、填寫表單、截圖，全部自動完成。

測試方式很簡單，透過 WhatsApp 或終端機發送指令：

「幫我打開 GitHub，搜尋 OpenClaw 專案，告訴我目前的星數和最新的 Release 版本」

OpenClaw 會自動啟動 Chromium、導航到 GitHub、輸入搜尋關鍵字、點擊進入專案頁面、抓取星數與 Release 資訊，最後將結果整理成文字回傳給你。

這個功能的潛力遠不只搜尋——它可以用來做定期的競品網頁監控、表單自動填寫、網頁資料定期擷取等。但需要注意，瀏覽器自動化需要至少 4GB 記憶體，且在雲端主機上需要額外設定虛擬顯示（headless Chromium）。

九、實戰場景 2——定時任務：每日 AI 簡報

這是我們實測中最實用的功能之一。透過 Cron Job 設定，OpenClaw 可以每天固定時間自動執行任務並將結果推送到你的 WhatsApp。

搭配 BlogWatcher 技能，你可以設定一個每日 AI 新聞簡報：

🔧 執行指令
# 先用 BlogWatcher 新增要監控的 RSS 來源
blogwatcher add "GitHub: Claude Code" \
  https://github.com/anthropics/claude-code/releases.atom

blogwatcher add “OpenAI Blog” 

https://openai.com/blog/rss.xml


手動掃描一次，確認 RSS 來源正常


blogwatcher scan
blogwatcher articles

確認 RSS 來源正常後，設定定時任務：

🔧 執行指令
# 每天早上 9 點自動推送 AI 簡報到 WhatsApp
openclaw cron add \
  --name "每日 AI 簡報" \
  --cron "0 9 * * *" \
  --tz "Asia/Taipei" \
  --session isolated \
  --message "請用繁體中文整理過去 24 小時的重要 AI 新聞，包含技術突破、產品發布和產業動態，以條列式簡報呈現" \
  --deliver \
  --channel whatsapp

設定完成後，你每天早上 9 點都會在 WhatsApp 上收到一份由 AI 自動整理的新聞簡報。如果想立即測試：

🔧 執行指令
# 立即執行（不等到排定時間）
openclaw cron run <CRON_JOB_ID> --force

定時任務的應用場景非常廣泛：每日天氣提醒、週報自動整理、競品動態追蹤、社群媒體數據匯總等，都可以透過一條 cron 設定實現。

十、實戰場景 3——調用 Claude Code 自動開發

這是最讓技術人員興奮的功能——OpenClaw 可以調用 Claude Code 來自動撰寫、測試並部署程式碼。

在我們的實測中，我們透過 WhatsApp 發送了一條指令：

「請幫我用 Node.js + Express 建立一個後台登入頁面，包含使用者名稱和密碼欄位，使用 Bootstrap 美化，密碼需要 bcrypt 加密儲存」

接下來 OpenClaw 做了這些事情：

  1. 建立專案結構：自動創建目錄、初始化 package.json
  2. 安裝依賴：自動執行 npm install express bcrypt ejs
  3. 撰寫後端程式碼：生成 Express 路由、bcrypt 加密邏輯、session 管理
  4. 撰寫前端頁面：生成使用 Bootstrap 的登入頁面模板
  5. 啟動並測試：自動啟動伺服器並回報可存取的 URL

整個過程大約花了 2–3 分鐘。最終我們在瀏覽器中打開回報的 URL，看到了一個功能完整的後台登入頁面。

這種「用自然語言指揮 AI 寫程式」的體驗，與直接使用 Claude 或 ChatGPT 的差異在於：OpenClaw 不只生成程式碼片段，而是完成從建立專案到部署執行的整個流程。它會自己處理檔案系統操作、套件安裝、環境設定——這些通常需要開發者手動完成的瑣碎步驟[7]。

十一、進階：Hooks 零輪詢 + Agent Teams 多智能體協作

上一節的常規調用方式有一個痛點：OpenClaw 每隔幾秒就會輪詢一次 Claude Code 的狀態與輸出。任務執行時間越長，輪詢次數越多，消耗的 Token 也越多。這是社群中最常被提及的問題。

解決方案其實非常優雅——利用 Claude Code 的 Hooks 回調機制，搭配最新的 Agent Teams 多智能體協作功能，實現真正的零輪詢異步開發。

11.1 核心原理：從輪詢到回調

傳統方式的流程是：

OpenClaw 下達任務 → 每隔數秒輪詢 Claude Code 狀態 → 持續消耗 Token → 任務完成 → 回傳結果

Hooks 零輪詢方式則是：

OpenClaw 委派任務（一次性，後台執行）→ Claude Code 獨立運行 → 任務完成觸發 Stop Hook → 自動寫入結果 + 喚醒 OpenClaw → 推送通知到聊天群組

整個過程中，OpenClaw 只在派發任務和讀取結果時各消耗一次 Token，中間 Claude Code 自主開發的過程完全不消耗 OpenClaw 的 Token。而且主 Agent 不會被阻塞，可以同時執行其他任務。

11.2 Agent Teams：Claude Code 的多智能體協作

Claude Code 近期新增的 Agent Teams 特性，讓這套流程更加強大。Agent Teams 相當於在 Claude Code 中建立一個完整的開發團隊——每個 Agent 都是獨立的進程，真正平行執行，而且彼此之間可以相互通訊、共享任務列表、自動認領工作、實現專職角色分工（前端、後端、測試等）。

結合 Hooks 回調，你可以透過手機向 OpenClaw 發送一條開發指令，Claude Code 的 Agent Teams 會自動拆分工作、多智能體協作完成開發，完成後自動推送詳細報告到你的聊天群組。

11.3 Hooks 設定：Stop + SessionEnd 雙重保障

在 Claude Code 的 14 個 Hooks 中，我們選用兩個：

在 Claude Code 的設定檔 ~/.claude/settings.json 中配置 Hooks：

📄 設定檔 — ~/.claude/settings.json
{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "/path/to/hooks/notify-agi.sh",
            "timeout": 10
          }
        ]
      }
    ],
    "SessionEnd": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "/path/to/hooks/notify-agi.sh",
            "timeout": 10
          }
        ]
      }
    ]
  }
}

11.4 回調腳本的雙通道設計

回調腳本採用雙通道架構，兼顧可靠性與即時性：

之所以需要雙通道，是因為 Wake Event 有字數上限（約 300 字元），而 Claude Code 的輸出可能超過 2000 字元。檔案儲存無限量內容，Wake Event 負責即時通知。即使 Gateway API 呼叫失敗，latest.json 仍會被寫入，Agent 在下一次 heartbeat 時仍能讀取到結果——這就是容錯設計。

喚醒 OpenClaw 的 API 呼叫如下：

📖 僅供參考
curl -X POST "http://127.0.0.1:18789/api/cron/wake" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"text": "Claude Code task complete, read latest.json", "mode": "now"}'

11.5 完整流程：從手機下達指令到接收開發報告

以下是一個完整的實測場景。我們透過聊天軟體輸入：

「用 Claude Code 的 Agent Teams 協作模式，建構一個基於物理引擎的 HTML/CSS 落沙模擬遊戲，包含材質系統」

接下來發生的事情：

  1. OpenClaw 將任務委派給 Claude Code 的 Agent Teams（僅此一次呼叫，Token 消耗可忽略）
  2. 主 Agent 不被阻塞——我們繼續在同一個聊天窗口詢問「新加坡今天天氣如何」、「講個笑話」，OpenClaw 即時回應
  3. Claude Code 在後台自主運行約 6 分鐘，多個 Agent 平行協作
  4. 開發完成，Stop Hook 自動觸發，結果寫入 latest.json
  5. 我們在另一個聊天群組收到推送通知——包含任務名稱、專案路徑、完成時間、Agent Teams 啟用狀態、184 個測試通過、交付的功能清單與專案結構

之所以將通知推送到獨立群組，而非主 Agent 的聊天窗口，是為了避免在主窗口執行其他任務時突然插入完成通知，造成上下文混亂。

完整的 Hooks 回調程式碼已開源於 github.com/win4r/claude-code-hooks，包含 dispatch 腳本、回調腳本與 Claude Code 設定範例。

十二、進階：Supermemory 外掛——讓 AI 擁有完美長期記憶

OpenClaw 內建的 Memory 層以 Markdown 檔案儲存對話脈絡，但隨著使用時間增長，這種樸素的記憶機制會遇到瓶頸：上下文窗口有限、無法跨渠道統一記憶、缺乏語義搜索能力。Supermemory 外掛正是為了解決這些問題而設計的。

12.1 Supermemory 解決了什麼問題

想像這樣的場景：你上週透過 WhatsApp 告訴 OpenClaw「我偏好用 TypeScript 開發」，今天改用 Telegram 請它幫你寫一個 API。沒有 Supermemory 的情況下，OpenClaw 在 Telegram 的會話中不會知道你的偏好——因為那是另一個獨立的對話上下文。

安裝 Supermemory 後，OpenClaw 擁有了跨渠道、跨時間的統一語義記憶。它會：

效果是：OpenClaw 真正變成一個「越用越懂你」的長期助理，而不只是一個每次都從零開始的對話工具。

12.2 安裝與設定

安裝只需一條指令：

🔧 執行指令
openclaw plugins install @supermemory/openclaw-supermemory

安裝完成後重啟 OpenClaw。接著設定 API Key（需要 Supermemory Pro 以上方案）：

🔧 執行指令
# 設定環境變數
export SUPERMEMORY_OPENCLAW_API_KEY="sm_your_key_here"

或直接寫入 ~/.openclaw/openclaw.json：

📄 設定檔 — ~/.openclaw/openclaw.json
{
  "plugins": {
    "entries": {
      "openclaw-supermemory": {
        "enabled": true,
        "config": {
          "apiKey": "${SUPERMEMORY_OPENCLAW_API_KEY}"
        }
      }
    }
  }
}

12.3 進階設定參數

Supermemory 提供了精細的控制選項：

12.4 使用方式

安裝後大多數功能是自動運作的，但你也可以手動操作：

🔧 執行指令
# 手動記住特定資訊
/remember 我的公司使用 AWS 作為雲端基礎設施，偏好 Terraform 管理

主動搜尋記憶


/recall 上次討論的資料庫遷移方案


CLI 操作


openclaw supermemory search “API 設計偏好”
openclaw supermemory profile        # 查看 AI 建構的使用者檔案
openclaw supermemory wipe           # 清除所有記憶（需確認）

AI 本身也可以自主調用記憶工具：supermemory_store（儲存）、supermemory_search（搜尋）、supermemory_forget（刪除）、supermemory_profile（讀取使用者檔案）。

12.5 應用場景

Supermemory 與 OpenClaw 的結合，在以下場景特別有價值：

十三、核心設定檔案一覽

在使用過程中，你可能需要手動調整一些設定。以下是 OpenClaw 的關鍵檔案位置：

你也可以透過環境變數覆蓋預設路徑：

常用的 CLI 設定指令：

🔧 執行指令
# 讀取特定設定值
openclaw config get agents.defaults.workspace

修改設定值


openclaw config set agents.defaults.heartbeat.every “2h”


移除設定值


openclaw config unset tools.web.search.apiKey


驗證與自動修復


openclaw doctor
openclaw doctor —fix

如果 OpenClaw 出現異常行為，先執行 openclaw doctor 診斷；如需完全重置，可以刪除 ~/.openclaw/ 目錄後重新執行 openclaw onboard。

十四、安全性提醒：不可忽視的風險

在興奮地部署完 OpenClaw 後，我們必須嚴肅提醒幾個重大安全風險。

2026 年 2 月初，安全研究人員披露了 CVE-2026-25253 漏洞（CVSS 8.8 高危）[5]——攻擊者可透過跨站 WebSocket 劫持取得 OpenClaw 的完整控制權。CrowdStrike 的調查發現，網路上超過 42,000 個公開暴露的 OpenClaw 實例中，93.4% 存在認證繞過漏洞[4]。

Cisco 的安全團隊更直言[6]，像 OpenClaw 這樣的個人 AI 代理結合了 Shell 存取權限、網路連線能力與 Prompt Injection 攻擊面，是駭客的理想目標。

我們的安全建議：

Quick Reference — 常用指令速查
指令用途
openclaw onboard --install-daemon初始安裝與設定精靈
openclaw gateway status檢查 Gateway 運行狀態
openclaw dashboard開啟網頁版控制介面
openclaw configure重新進入設定精靈
openclaw config get/set <key>讀取或修改個別設定值
openclaw doctor --fix診斷問題並自動修復
openclaw pairing list <channel>查看渠道配對狀態
openclaw skills install <name>安裝技能模組
openclaw cron add ...新增定時排程任務
openclaw cron run <id> --force立即執行排程任務

十五、總結與展望

從安裝到完成六個實戰場景，整個過程不到一小時。OpenClaw 確實將「AI 自主代理」從一個抽象概念變成了可以立即上手的工具——一條命令安裝、掃一個 QR Code 連接手機、然後用自然語言指揮 AI 做事。

但我們需要保持清醒：易用性與安全性之間的張力是 OpenClaw 當前最大的矛盾。它讓 AI 控制你的整台電腦，這既是它最大的賣點，也是最大的風險。在安全架構尚未完全成熟的現階段，我們建議將 OpenClaw 視為一個學習與實驗工具，而非生產力核心。

AI 代理的時代已經到來，這一點毋庸置疑。OpenClaw 的爆紅證明了市場對「AI 自動化」的巨大需求。無論你最終是否長期使用 OpenClaw，花一小時走過這個教程、親身體驗 AI 代理的運作方式，都會幫助你更深刻地理解接下來一到兩年 AI 產業的發展方向。

如果您的企業正在評估 AI 代理與自動化工具的導入策略，歡迎與我們的研究團隊進行深度對話。我們將持續追蹤 OpenClaw 及同類產品的發展，協助客戶在工具百花齊放的時代做出最適切的技術決策。