OpenClaw 完全攻略指南（2026 最新版）

Aiko · February 27, 2026, 11:42am

OpenClaw 完全攻略指南（2026 最新版）

OpenClaw 是什麼？

OpenClaw 是一個開源、自架設（self-hosted）的個人 AI 助手平台，原名 Clawdbot → Moltbot → OpenClaw（是的，它改了好幾次名字）。它的核心概念是：

本地運行：所有資料留在你自己的機器上，完整掌控隱私
訊息橋接：透過 Gateway 架構，將你日常使用的通訊 App（WhatsApp、Telegram、Slack、Discord、Signal、iMessage、Teams、Google Chat）串接到 AI 模型
技能擴充：透過 Skills 系統，可安裝超過 5,700+ 個社群技能包
多模型支援：支援 Anthropic Claude、OpenAI GPT-4、Google Gemini、本地 LLM（透過 Ollama）
MIT 授權：完全開源免費，只需支付 AI API 使用費

簡單來說，OpenClaw 不只是聊天機器人。它能監控、排程、編譯、觸發自動化動作，是一個真正的 AI 代理（Agent）平台。

系統需求

項目	最低需求
作業系統	macOS（任何近期版本）、Linux（Ubuntu LTS 推薦）、Windows 10/11（強烈建議使用 WSL2）
Node.js	22 或更高版本（安裝腳本會自動偵測並安裝）
記憶體	4GB RAM 以上（建議 8GB+）
硬碟空間	至少 2GB 可用空間
AI Provider	Anthropic API Key（推薦）或其他支援的 AI 提供者
網路	穩定的網路連線

檢查 Node.js 版本

node --version

如果版本低於 22 或出現 “command not found”，請從 nodejs.org 下載最新 LTS 版本，或使用 nvm 版本管理器：

# 使用 nvm 安裝 Node.js 22
nvm install 22
nvm use 22

安裝方式總覽

方法	適合對象	隔離程度
CLI 安裝（推薦）	大多數使用者	中
npm/pnpm 手動安裝	開發者	中
Docker	進階使用者 / 伺服器部署	高
Ollama 整合	想用本地 LLM 的使用者	中
DigitalOcean 1-Click	雲端部署	高
從原始碼編譯	貢獻者 / 深度客製	低

方法一：官方 CLI 安裝（推薦）

這是官方推薦的安裝方式，一行指令搞定所有事情：

curl -fsSL https://get.openclaw.ai | bash

這個安裝腳本會自動：

偵測並安裝 Node.js（如果缺少）
全域安裝 OpenClaw CLI
啟動設定精靈（Onboarding Wizard）

設定精靈會引導你完成：

認證設定 — 產生 Gateway Token，確保本地與遠端客戶端需要驗證才能連線
Gateway 設定 — 連接埠、綁定位址、服務安裝
頻道連接 — 可選的 WhatsApp、Telegram、Discord 等設定
Daemon 安裝 — 將 OpenClaw 安裝為背景服務

如果只想安裝不要啟動精靈：

curl -fsSL https://get.openclaw.ai | bash -s -- --no-onboard

方法二：npm / pnpm 手動安裝

使用 npm：

npm install -g openclaw@latest
openclaw onboard --install-daemon

使用 pnpm：

pnpm add -g openclaw@latest
pnpm approve-builds -g    # 核准 openclaw、node-llama-cpp、sharp 等套件的 build scripts
openclaw onboard --install-daemon

注意：pnpm 需要明確核准含有 build scripts 的套件。安裝後如果看到 “Ignored build scripts” 警告，執行 pnpm approve-builds -g 並選擇列出的套件。

如果 sharp 安裝失敗：

# 如果你透過 Homebrew 安裝了 libvips，可能會衝突
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

方法三：Docker 安裝（最佳隔離性）

Docker 方式提供最好的安全隔離，適合伺服器部署：

# 使用 docker-compose
git clone https://github.com/openclaw/openclaw.git
cd openclaw
docker-compose up -d

或使用 Podman（Rootless container）：

# 執行設定腳本後啟動
./setup-podman.sh

方法四：透過 Ollama 安裝（最簡單）

如果你已經在使用 Ollama 跑本地模型，這是最快的方式：

ollama run openclaw

Ollama 會自動偵測系統上是否有 OpenClaw，如果沒有會提示安裝。安裝完成後：

選擇 AI 模型（雲端或本地皆可）
自動安裝 Web Search 插件（雲端模型）
可選擇連接通訊平台

提示：Agent 在至少 64k context length 的模型上效果最好。

首次啟動設定

確認 Gateway 狀態

openclaw status        # 檢查 Gateway 是否正在運行
openclaw doctor        # 診斷設定問題
openclaw dashboard     # 在瀏覽器中打開控制面板

控制面板 (Control UI)

安裝完成後，在瀏覽器中打開：

http://127.0.0.1:18789/

這是 OpenClaw 的控制中心，你可以：

監控 Agent 狀態
查看對話記錄與記憶
管理已安裝的 Skills
調整設定

手動前景執行（除錯用）

openclaw gateway

背景服務（Daemon）

macOS：建立 launchd daemon，開機自動啟動
Linux：建立 systemd service，開機自動啟動
Windows：使用對應的服務機制

連接通訊頻道

OpenClaw 支援以下通訊平台：

平台	狀態	備註
WhatsApp	正式支援	使用 Baileys 函式庫，需持久 WebSocket 連線
Telegram	正式支援	需要建立 Bot Token
Discord	正式支援
Slack	正式支援
Signal	正式支援
iMessage	正式支援	僅限 macOS
Google Chat	正式支援
Teams	正式支援
WebChat	內建	透過控制面板即可使用，無需額外設定

快速測試（不需連接通訊 App）

直接使用控制面板內建的 WebChat，點擊聊天圖示即可開始對話。

連接頻道基本步驟

# 查看可用頻道
openclaw channels list

# 登入頻道
openclaw channels login

# 登出頻道
openclaw channels logout

發送測試訊息

openclaw message send --target +886912345678 --message "Hello from OpenClaw"

Skills 技能系統全解析

Skills 是 OpenClaw 最強大的擴充機制。理解它的運作方式是精通 OpenClaw 的關鍵。

Skills vs Tools — 關鍵區別

概念	比喻	說明
Tools（工具）	器官	決定 OpenClaw「能不能」做某件事
Skills（技能）	教科書	教 OpenClaw「怎麼」組合工具完成任務

重要觀念：安裝一個 Skill 並不會給予 OpenClaw 新的權限。例如安裝了 obsidian Skill，OpenClaw 知道如何組織筆記了，但如果 write Tool 沒有啟用，它仍然無法寫入任何檔案。

讓 Skill 正常運作的三個條件

以「讀取 Gmail」為例：

Configuration（設定）：你是否允許 OpenClaw 執行指令？（沒有 exec 就無法啟動任何程式）
Installation（安裝）：相關的 bridge tool 是否已安裝在機器上？
Authorization（授權）：你是否已登入 Google 帳號並授權存取？

三個條件缺一不可。

Skill 的結構

每個 Skill 是一個資料夾，核心是一個 SKILL.md 檔案：

my-skill/
├── SKILL.md          # YAML frontmatter + 指令（必要）
├── scripts/          # 輔助腳本（可選）
├── templates/        # 範本（可選）
└── reference/        # 參考資料（可選）

Skill 載入優先順序

Workspace Skills（~/.openclaw/workspace/skills/）— 最高優先
Managed Skills（~/.openclaw/skills/）— 跨所有 Agent 共享
Bundled Skills — 隨 OpenClaw 安裝的內建技能

同名 Skill 高優先順序的會覆蓋低優先順序的。

安裝 Skills

# 從 ClawHub 安裝
clawhub install <skill-slug>

# 同步所有已安裝的 skills
clawhub sync --all

# 瀏覽 ClawHub
# https://clawhub.com

手動建立 Skill

cd ~/.openclaw/skills
mkdir my-custom-skill
cd my-custom-skill

建立 SKILL.md：

---
name: my-custom-skill
description: "描述你的 skill 觸發條件，用使用者實際會說的話來寫"
user-invocable: true
disable-model-invocation: false
requirements:
  - name: curl
    type: binary
---

# 指令內容

這裡寫 Agent 在觸發此 Skill 時應該遵循的步驟...

在 openclaw.json 中設定 Skills

{
  "skills": {
    "install": {
      "nodeManager": "npm"
    },
    "entries": {
      "my-skill": {
        "enabled": true,
        "env": {
          "API_KEY": "your-api-key"
        }
      }
    }
  }
}

重要安全提醒

內建 Skills 預設自動載入 — 如果對應的 CLI 工具已安裝在系統上，Skill 會自動啟用
使用 skills.allowBundled 白名單模式來控制哪些 Skills 可以啟用
將第三方 Skills 視為不受信任的程式碼，安裝前請先閱讀原始碼
使用 ClawHub 的 VirusTotal 掃描報告檢查安全性

Tools 工具系統（25 個核心工具）

第一層：核心功能（8 個工具）

這些是 OpenClaw 的基礎，幾乎所有人都會啟用：

工具	功能
`read`	讀取檔案
`write`	寫入檔案
`edit`	編輯檔案
`exec` / `shell`	執行 Shell 指令
`web_search`	網路搜尋
`web_fetch`	抓取網頁內容
`list`	列出目錄內容
`glob`	檔案模式匹配

第二層：進階功能（17 個工具）

根據需求啟用：

類別	工具
瀏覽器控制	`browser_navigate`、`element_interact`、`screenshot`
記憶	`memory_store`、`memory_recall`
多重會話	`multi_session`
自動化	`cron_scheduler`、`webhook`
通訊	`whatsapp_send`、`telegram_send` 等

第三層：知識層（53 個內建 Skills）

教 OpenClaw 如何與特定服務互動：

類別	Skills
生產力	Google Workspace (gog)、Obsidian、Notion
開發	GitHub、GitLab、Docker
通訊	Slack、Discord、Email
智慧家庭	Home Assistant、IoT
社群媒體	Twitter/X、Instagram
其他	天氣、1Password、瀏覽器自動化

進階功能與自動化

排程任務（Cron Jobs）

# 例：每天早上 8 點推送天氣摘要
# 在 ~/.openclaw/cron/jobs.json 中設定

瀏覽器自動化

啟用 browser_navigate 和 element_interact 工具後，OpenClaw 可以：

自動瀏覽網頁
填寫表單
擷取畫面截圖
執行網頁互動

多 Agent 架構

OpenClaw 支援多個 Agent 同時運行：

# 在不同 port 運行多個實例
openclaw gateway --port 18789
openclaw gateway --port 18790

每個 Agent 有獨立的 workspace，Skills 可以獨立配置也可以共享。

PM2 持久化運行（Windows）

# 安裝 PM2
npm install -g pm2

# 用 PM2 啟動 OpenClaw
cd my-agent
pm2 start npm --name "openclaw" -- start

# 開機自動啟動
pm2 startup
pm2 save

# 監控
pm2 status
pm2 logs openclaw

24/7 伺服器部署

# Linux systemd 方式
sudo cp scripts/openclaw.service /etc/systemd/system/
sudo systemctl enable openclaw
sudo systemctl start openclaw
sudo systemctl status openclaw

安全性最佳實踐

這是非常重要的章節。2026 年初已有報導指出約 21,000 個 OpenClaw 實例因設定不當而暴露在公開網路上。

七條黃金守則

不要將 OpenClaw 暴露在公開網路上 — 使用防火牆限制存取
最小權限原則 — 只啟用需要的 Tools 和 Skills
危險指令黑名單 — 禁止 rm -rf、format 等危險操作
Docker 沙盒隔離 — 對不信任的 Skills 使用容器化執行
強 Token 認證 — Gateway Token 要夠強夠長
定期更新 — 保持 OpenClaw 在最新版本
審查第三方 Skills — 安裝前先閱讀原始碼

更新 OpenClaw

# 檢查目前版本
openclaw --version

# 更新到最新穩定版
npm update -g openclaw@latest

# 或使用 beta/dev 頻道
npm install -g openclaw@beta
npm install -g openclaw@dev

設定防火牆

# UFW 設定（Linux）
sudo ufw allow 18789/tcp   # 只允許需要的 port
sudo ufw enable

SSL 憑證（遠端存取）

openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365

學習路徑規劃

第一週：建立信任

重點掌握以下基礎 Skills：

file_search（檔案搜尋）
whatsapp_send（發送訊息）
run_shell_command（執行簡單指令如 ls）

練習任務：讓 OpenClaw 整理桌面檔案

第 2-4 週：自動化工作流程

browser_navigate + element_interact（瀏覽器自動化）
cron_scheduler（排程任務）
Google Workspace 整合（Email、Calendar、Drive）

練習任務：設定每日新聞摘要自動推送

第 2-3 個月：進階應用

自訂 Skill 開發
多 Agent 協調
Docker 沙盒測試
工作流程引擎（lobster）

練習任務：開發自己的 Skill 套件並發布到 ClawHub

常見問題排除

“EACCES: permission denied” 安裝時權限錯誤

# 方法一：使用 sudo
sudo npm install -g openclaw@latest

# 方法二：修改 npm 全域套件目錄（推薦）
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

Gateway 無法啟動

# 檢查 port 是否被佔用
lsof -i :18789

# 使用其他 port
openclaw gateway --port 18790

頻道認證迴圈

openclaw channels logout && openclaw channels login

Daemon 重開機後沒有自動啟動

openclaw onboard --install-daemon

Skills 沒有被載入

# 執行診斷
openclaw doctor --repair

# 確認 Gateway 的 PATH 與你的終端機一致
# Homebrew 或 ~/bin 安裝的工具可能在 Gateway 中看不到

“node: command not found”

Node.js 未安裝或未加入 PATH。確認安裝了 22+ 版本。

sharp 安裝錯誤

# macOS 用戶
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
# 或安裝 build 工具
xcode-select --install
npm install -g node-gyp

npm 全域路徑問題

# macOS/Linux
echo 'export PATH=$(npm prefix -g)/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

# Windows
# 將 `npm prefix -g` 的輸出加入系統 PATH

實用資源連結

資源	連結
官方文件	https://docs.openclaw.ai
安裝指南	Install - OpenClaw
Skills 文件	Skills - OpenClaw
ClawHub（Skills 市集）	https://clawhub.com
GitHub Repo	GitHub - openclaw/openclaw: Your own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞
Awesome OpenClaw Skills	GitHub - VoltAgent/awesome-openclaw-skills: The awesome collection of OpenClaw Skills. Formerly known as Moltbot, originally Clawdbot.
安全性指南	Security - OpenClaw
Docker 部署	Docker - OpenClaw
DigitalOcean 1-Click	https://www.digitalocean.com/community/tutorials/how-to-run-openclaw
Ollama 整合	The simplest and fastest way to setup OpenClaw · Ollama Blog

總結

OpenClaw 不只是又一個聊天機器人。它是一個完整的 AI 代理基礎設施，在你控制的硬體上運行，串接你已經在使用的工具和通訊平台。

掌握 OpenClaw 的關鍵心法：

循序漸進 — 不要一開始就啟用所有功能，先從核心 Tools 開始
理解 Tools vs Skills — Tools 是開關，Skills 是說明書，兩者缺一不可
安全第一 — 不信任的 Skills 不要裝，不需要的 Tools 不要開
善用社群 — ClawHub 上有 5,700+ 個 Skills，善加利用但注意安全審查
持續更新 — OpenClaw 仍在快速發展中，保持版本更新

最後提醒：OpenClaw 的真正威力不在於技術本身，而在於你如何用它來自動化重複性工作、串接不同系統、讓 AI 成為你真正的數位助手。先想清楚你要解決什麼問題，再去找對應的工具和技能。

本指南根據 2026 年 2 月最新資訊整理，OpenClaw 版本 2026.1.24+

OpenClaw 完全攻略指南（2026 最新版）

OpenClaw 完全攻略指南（2026 最新版）

目錄

OpenClaw 是什麼？

系統需求

檢查 Node.js 版本

安裝方式總覽

方法一：官方 CLI 安裝（推薦）

設定精靈會引導你完成：

如果只想安裝不要啟動精靈：

方法二：npm / pnpm 手動安裝

使用 npm：

使用 pnpm：

如果 sharp 安裝失敗：

方法三：Docker 安裝（最佳隔離性）

方法四：透過 Ollama 安裝（最簡單）

首次啟動設定

確認 Gateway 狀態

控制面板 (Control UI)

手動前景執行（除錯用）

背景服務（Daemon）

連接通訊頻道

快速測試（不需連接通訊 App）

連接頻道基本步驟

發送測試訊息

Skills 技能系統全解析

Skills vs Tools — 關鍵區別

讓 Skill 正常運作的三個條件

Skill 的結構

Skill 載入優先順序

安裝 Skills

手動建立 Skill

在 openclaw.json 中設定 Skills

重要安全提醒

Tools 工具系統（25 個核心工具）

第一層：核心功能（8 個工具）

第二層：進階功能（17 個工具）

第三層：知識層（53 個內建 Skills）

進階功能與自動化

排程任務（Cron Jobs）

瀏覽器自動化

多 Agent 架構

PM2 持久化運行（Windows）

24/7 伺服器部署

安全性最佳實踐

七條黃金守則

更新 OpenClaw

設定防火牆

SSL 憑證（遠端存取）

學習路徑規劃

第一週：建立信任

第 2-4 週：自動化工作流程

第 2-3 個月：進階應用

推薦的 5 個必裝 Skills

常見問題排除

“EACCES: permission denied” 安裝時權限錯誤

Gateway 無法啟動

頻道認證迴圈

Daemon 重開機後沒有自動啟動

Skills 沒有被載入

“node: command not found”

sharp 安裝錯誤

npm 全域路徑問題

實用資源連結

總結