新手入門20 分鐘閱讀

OpenClaw 完整指南：從首次安裝到進階使用者

一份實作導向的指南，涵蓋從安裝 OpenClaw 到撰寫自訂 Skills、設定自動化任務以及管理多個 Agent 的所有內容。2026 年最新版。

OpenClaw Guides

Tutorial Authors

2026-03-02

什麼是 OpenClaw？為什麼你應該關注它？

OpenClaw 是一款開源 AI Agent，運行在你自己的機器上——你的筆電、家用伺服器或雲端 VPS 都可以。不同於只能回答問題的瀏覽器式 AI 工具，OpenClaw 會採取行動：它能讀取你的電子郵件、安排會議、整理檔案、透過 WhatsApp、Telegram 和 Discord 發送訊息，並且透過自然語言自動化重複性的工作流程。

自 2026 年 1 月發布以來，這個專案已突破 244,000 GitHub Stars，成為有史以來成長最快的開源專案之一。原因很簡單：人們需要的是一個真正能做事的 AI 助手，而不是只會空談的 AI。

以下是一個快速理解差異的方式：

傳統 AI 聊天機器人：

你：「幫我整理桌面上的檔案。」 AI：「好的！以下是一些建議：1. 按類型建立資料夾... 2. 將檔案分別移入...」

OpenClaw：

你：「幫我整理桌面上的檔案。」 OpenClaw：重新命名、分類並移動了 47 個檔案到 5 個資料夾 —— 「完成了！我已按檔案類型整理好所有檔案。」

這就是核心的轉變：從聊天機器人變成 Agent。

本指南將帶你走過完整的旅程——從首次安裝到撰寫自訂 Skills 以及管理多個 Agent。無論你有 30 分鐘還是一整個下午，都可以按自己的節奏逐步完成每個章節。

開始使用：安裝與設定

你需要準備什麼

Node.js 22+（建議使用 LTS 版本）—— 用 node --version 確認
一個 AI 模型 API Key —— Anthropic Claude（推薦）、OpenAI，或透過 Ollama 使用本地模型
macOS、Linux 或配備 WSL2 的 Windows

安裝 OpenClaw

最快的方式是一行安裝指令：

bash

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

這會偵測你的系統，在需要時安裝依賴套件，並啟動設定精靈。如果你偏好使用 npm：

bash

npm install -g openclaw@latest

Docker 使用者：

bash

docker pull openclaw/openclaw:latest
docker run -d --name openclaw \
  -v ~/.openclaw:/root/.openclaw \
  openclaw/openclaw:latest

如需各種安裝方式的詳細說明，請參閱我們的快速入門指南。

執行引導精靈

安裝完成後，引導精靈會帶你完成所有設定：

bash

openclaw onboard

你需要設定三件事：

AI 提供者與 API Key —— Anthropic Claude 的效果最佳。如果你還沒有 API Key，請到 anthropic.com 取得。想節省費用？請參閱我們的模型選擇與費用指南。
訊息頻道 —— 至少選擇一個：Telegram 是最容易上手的（只需 5 分鐘設定）。我們有 Telegram、WhatsApp 和 Discord 的專屬指南。
安全模式 —— 目前先選擇 Sandbox。等你熟悉後再升級為完整存取權限。

驗證一切正常運作

bash

openclaw status

你應該會看到：

Gateway: Running ✓
Model: Connected ✓
Channels: 1 active

現在打開你選擇的訊息應用程式，發送你的第一則訊息。試試一些簡單的指令：

"What can you do?"
"What time is it?"
"Summarize the latest tech news."

如果你的機器人有回應，恭喜——你已經擁有一個運作中的 AI Agent 了。

核心概念：OpenClaw 的運作方式

在深入探索之前，了解 OpenClaw 的四個基本組成會很有幫助。可以這樣理解它們：

Gateway — 前門

Gateway 是 OpenClaw 連接外部世界的方式。它處理來自 Telegram、Discord、WhatsApp、Web API 甚至命令列的訊息。你可以同時運行多個 Gateway——例如 Telegram 用於個人用途，Slack 用於工作。

Skills — 工具箱

Skills 是 OpenClaw 能做的事。每個 Skill 是一個打包好的能力：發送電子郵件、搜尋網頁、管理檔案、控制瀏覽器。把它們想像成智慧手機上的應用程式。OpenClaw 內建了一些 Skills，但真正的威力來自 Clawhub 上的社群生態系統，以及你自己撰寫的 Skills。

瀏覽我們的 Skills 目錄查看有哪些可用的技能。

Memory — 大腦

OpenClaw 能跨對話記住事情。告訴它你的名字、工作時間表、偏好——它會保留這些上下文。不同於無狀態的聊天機器人，OpenClaw 會建立對你的持續理解，了解你是誰以及你的工作方式，資料儲存在本地的 ~/.openclaw/memory/。

Sandbox — 安全網

Sandbox 控制 OpenClaw 在你系統上被允許做的事情。在 Sandbox 模式下，它無法存取任意檔案或執行破壞性指令。這是你的安全層——尤其在嘗試新 Skills 或給予 OpenClaw 更廣泛權限時特別重要。

如需詳細的安全設定，請參閱我們的安全設定範本。

安裝與使用 Skills

Skills 是讓 OpenClaw 從「有趣的展示」變成「日常工具」的關鍵。以下是入門方式。

瀏覽與安裝

bash

# 用關鍵字搜尋 Skills
openclaw skills search email

# 查看特定 Skill 的詳細資訊
openclaw skills info @openclaw/email-manager

# 安裝它
openclaw skills install @openclaw/email-manager

值得優先安裝的五個 Skills

| Skill | 功能說明 | 安裝指令 | |-------|---------|---------| | Email Manager | 讀取、撰寫和發送電子郵件 | openclaw skills install @openclaw/email-manager | | Calendar | 建立行程、查看排程、發送邀請 | openclaw skills install @openclaw/calendar | | File Organizer | 排序、重新命名和整理檔案 | openclaw skills install @openclaw/file-organizer | | Web Search | 搜尋網頁並摘要結果 | openclaw skills install @openclaw/tavily-search | | Browser Control | 自動化瀏覽器任務 | openclaw plugins install @openclaw/browser-control |

安裝完成後，只需用自然語言跟你的 Agent 對話：

"Check my unread emails and summarize the top 3."
"What's on my calendar tomorrow?"
"Search for the latest OpenClaw release notes."

管理你的 Skills

bash

# 列出所有已安裝的 Skills
openclaw skills list

# 更新所有 Skills
openclaw skills update

# 移除不再需要的 Skill
openclaw skills remove @openclaw/file-organizer

在安裝第三方 Skills 之前，請先查閱我們的 Skills 安全檢查清單以確保安全。

設定自動化任務（排程任務）

OpenClaw 最實用的功能之一是排程自動化。你不需要每天早上都手動要求 Agent 做某件事，只需設定一次，讓它自動執行。

建立每日簡報

只需用自然語言告訴你的 Agent：

"Every morning at 8 AM, send me a briefing with today's weather, my calendar events, and a count of unread emails."

OpenClaw 會自動建立排程任務。你也可以手動管理它們：

bash

# 列出所有排程任務
openclaw cron list

# 查看特定任務的詳細資訊
openclaw cron show <task-id>

# 暫停一個任務
openclaw cron disable <task-id>

# 恢復它
openclaw cron enable <task-id>

# 永久刪除它
openclaw cron delete <task-id>

自動化點子

每日簡報 —— 每天早上取得天氣 + 行事曆 + 未讀郵件
每週摘要 —— 週五下午的一週活動報告
價格追蹤 —— 監控商品頁面，當價格下降時通知你
下班提醒 —— 傍晚 6 點的友善提醒，該收工了
收件匣清理 —— 每天傍晚自動封存低優先級郵件

設定持續性記憶

OpenClaw 的記憶系統是讓它變得個人化的關鍵。你提供的上下文越多，它就能為你提供越好的服務。

教你的 Agent 認識你

發送這樣的訊息：

"Remember this about me: My name is Alex. I'm a product manager. I work Monday through Friday, 9 AM to 6 PM, timezone GMT+8. I prefer concise responses. I communicate in English but can read Chinese."

OpenClaw 會將這些資訊存入長期記憶，並套用到未來的每次互動中。

查看與編輯記憶

bash

# 查看你的 Agent 記得什麼
cat ~/.openclaw/memory/long-term.json

# 或者直接在聊天中詢問
"What do you know about me?"

你也可以修正或刪除記憶：

"Forget my old work schedule. I now work 10 AM to 7 PM."

記憶的運作方式

OpenClaw 使用三層記憶架構：

短期記憶 —— 當前對話的上下文（每次會話結束後清除）
長期記憶 —— 關於你的持續性事實（偏好、習慣、個人資料）
情境記憶 —— 過去互動的紀錄（用於隨時間進行模式識別）

這種分層方式意味著你使用 Agent 的時間越長，它就越有用，不需要反覆提醒。

撰寫你的第一個自訂 Skill

當內建和社群 Skills 無法滿足你的特定需求時，你可以自己撰寫。OpenClaw Skills 使用簡單的 YAML 格式。

Skill 結構

在 ~/.openclaw/skills/daily-news.yaml 建立一個新檔案：

yaml

name: "Daily Tech News"
description: "Fetches and summarizes today's top tech headlines"
version: "1.0.0"

triggers:
  - "tech news"
  - "today's news"
  - "news summary"

steps:
  - action: web_search
    query: "top tech news today"
    max_results: 5

  - action: summarize
    content: "{{search_results}}"
    style: "bullet_points"

  - action: respond
    message: |
      Here's your tech news summary:

      {{summary}}

測試它

bash

# 重新載入 Skills 以偵測新檔案
openclaw skills reload

# 測試它
openclaw skills test "Daily Tech News"

然後在對話中嘗試："Give me today's tech news."

建構更複雜的 Skills

Skills 可以串連多個動作：

web_search —— 搜尋網頁
summarize —— 將文字壓縮為條列式重點或段落
respond —— 發送格式化的回覆
file_read / file_write —— 讀取或建立檔案
shell_exec —— 執行 Shell 指令（需要適當的權限）
http_request —— 呼叫外部 API

你可以將這些動作組合起來建構工作流程，例如：搜尋機票價格 → 比較結果 → 將摘要寫入檔案 → 透過 Telegram 通知你。

多 Agent 管理

隨著使用量增長，你可能會需要為生活中不同領域建立不同的 Agent——一個用於工作、一個用於個人事務、一個用於實驗。

建立 Agent

bash

# 建立一個使用 Claude Sonnet 的工作 Agent
openclaw create-agent work
openclaw config --agent work set ai.model "claude-sonnet-4-6"

# 建立一個個人 Agent
openclaw create-agent personal
openclaw config --agent personal set ai.model "claude-haiku-4-5"

# 列出所有 Agent
openclaw list-agents

# 在它們之間切換
openclaw switch-agent work

為什麼要使用多個 Agent？

| Agent | 模型 | 連接到 | 用途 | |-------|------|--------|------| | Work | Claude Sonnet | Slack、Gmail、Linear | 專業任務、郵件分類 | | Personal | Claude Haiku | Telegram、Google Calendar | 排程、提醒、個人事務 | | Lab | Ollama（本地） | 僅 CLI | 測試新 Skills、實驗 |

每個 Agent 擁有自己的記憶、Skills 和頻道連接——彼此完全隔離。

瀏覽器自動化

OpenClaw 可以控制瀏覽器來執行超越簡單 API 呼叫的任務：填寫表單、從網頁擷取資料、跨站比價或截圖。

啟用 Browser Control

bash

# 安裝瀏覽器外掛
openclaw plugins install @openclaw/browser-control

# 啟用它
openclaw config set browser.enabled true

# 顯示瀏覽器視窗（設為 true 以便除錯）
openclaw config set browser.headless false

使用案例

"Open GitHub and find the top trending repositories today."
"Go to Amazon, search for mechanical keyboards, and list the top 3 by rating with prices."
"Fill out the contact form on example.com with my information."
"Take a screenshot of my portfolio website."

瀏覽器自動化功能強大但消耗較多資源。請將它用於真正需要與網頁進行視覺互動的任務——對於簡單的資料擷取，使用 Web Search Skill 會更快也更省錢。

聊天以外的整合

OpenClaw 不只連接訊息應用程式。以下是一些熱門的整合方式：

Google Workspace

bash

openclaw config set integrations.google.enabled true
openclaw config set integrations.google.credentialsPath "/path/to/credentials.json"
openclaw integrations google authorize

連接後，你就可以透過自然語言管理 Gmail、Google Calendar 和 Google Drive。

專案管理（Linear、Jira）

bash

openclaw skills install @openclaw/linear
openclaw config set integrations.linear.apiKey "YOUR_API_KEY"

"Create a high-priority task in Linear: Fix the login page redirect bug."

筆記工具（Obsidian、Notion）

bash

openclaw skills install @openclaw/obsidian
openclaw config set integrations.obsidian.vaultPath "/path/to/vault"

"Create a new note in Obsidian titled 'Meeting Notes — March 2' with today's discussion points."

如需完整的支援平台清單，請查看我們的頻道整合目錄。

安全與費用控制

Docker Sandbox

為了獲得最大程度的隔離，在 Docker Sandbox 中運行 OpenClaw：

bash

openclaw config set sandbox.mode "docker"
openclaw config set sandbox.docker.image "openclaw/sandbox:latest"
openclaw sandbox test

這會將檔案系統存取、網路存取和 Shell 執行限制在預定義的範圍內。

執行安全稽核

bash

openclaw security audit --deep

這會檢查設定錯誤的權限、暴露的 Token 以及其他常見問題。

如需完整的安全強化指南，請閱讀 Port 暴露與遠端存取。

控制你的花費

API 費用可能會累積。以下是設定防護機制的方式：

bash

# 設定每日請求上限
openclaw config set ai.dailyLimit 1000

# 設定每月預算上限（美元）
openclaw config set ai.monthlyBudget 50

# 查看你的用量
openclaw stats usage
openclaw stats cost

典型月費用：

| 使用等級 | 說明 | 預估費用 | |---------|------|---------| | 輕度 | 每天 10-20 次對話 | $5–10/月 | | 中度 | 每天 50-100 次對話 + 排程任務 | $20–30/月 | | 重度 | 自動化 + 瀏覽器控制 | $50–100/月 |

想深入了解費用最佳化？請參閱我們的模型選擇與費用指南。

疑難排解快速參考

| 症狀 | 可能原因 | 修復方式 | |------|---------|---------| | 啟動時出現 EADDRINUSE | Port 18789 已被佔用 | openclaw gateway start --port 18790 | | 401 Unauthorized | 無效或過期的 API Key | openclaw config set api-key | | 機器人沒有回應 | 頻道未連接 | 檢查 openclaw status 和頻道設定 | | 回應緩慢 | 模型超載或網路問題 | 嘗試較輕量的模型或檢查網路連線 | | Skills 未載入 | 安裝後需要重新載入 | openclaw skills reload |

如需更詳細的疑難排解，請參閱我們的常見錯誤指南。

實用的診斷指令

bash

# 完整健康檢查
openclaw doctor

# 查看日誌
openclaw logs

# 除錯模式
openclaw config set logging.level "debug"

接下來做什麼？

你已經涵蓋了大量的內容。以下是根據你的興趣可以前往的方向：

想要更多頻道？ 瀏覽我們的 50+ 頻道整合指南——從 Slack 和 Teams 到 WeChat 和 Line。
對安全感興趣？ 閱讀 Skills 安全檢查清單和安全設定指南。
想要自架？ 查看我們的遠端存取與 Port 暴露指南。
準備好貢獻了？ OpenClaw GitHub 儲存庫歡迎 Pull Request、Skill 貢獻和錯誤回報。

OpenClaw 代表了我們與 AI 互動方式的真正轉變——從尋求建議到委派真實的任務。這個專案發展迅速，社群正在壯大，而現在就是開始建構你自己的 AI Agent 配置的最佳時機。