guide beginner tutorial installation

OpenClaw 入門:15 分鐘內從零開始建立你的第一個 AI 代理

OpenClaws.io Team

OpenClaws.io Team

@openclaws

March 6, 2026

7 分鐘

OpenClaw 入門:15 分鐘內從零開始建立你的第一個 AI 代理

什麼是 OpenClaw?

OpenClaw 是一個在你自己電腦上運行的開源 AI 代理。不同於 ChatGPT 或 Claude.ai 這些在雲端上只能對話的服務,OpenClaw 住在你的機器上,而且能行動——管理檔案、傳送訊息、瀏覽網頁、控制智慧家居裝置,以及按排程執行自動化任務。

你透過你已經在使用的聊天應用程式與它互動:WhatsApp、Telegram、Discord、Slack、iMessage 等。它永遠在線、持續學習,而且永遠屬於你。

你需要什麼

  • 一台電腦:Mac、Windows(搭配 WSL2)或 Linux。Raspberry Pi 也可以。
  • Node.js 22 或更高版本:OpenClaw 在 Node.js 上運行。
  • 一個 AI API 金鑰:來自 Anthropic(Claude)、OpenAI(GPT),或透過 Ollama 使用本地模型。
  • 10 分鐘:真的只需要這麼多時間。

步驟一:安裝 Node.js

如果你還沒有 Node.js 22+,透過 nvm(Node 版本管理器)安裝:

bash
# macOS / Linux
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22

# Windows (use nvm-windows from github.com/coreybutler/nvm-windows)
nvm install 22
nvm use 22

驗證:node --version 應該顯示 v22.x.x 或更高版本。

步驟二:安裝 OpenClaw

bash
npm install -g openclaw@latest

或使用 pnpm:

bash
pnpm add -g openclaw@latest

驗證:openclaw --version 應該印出已安裝的版本。

步驟三:執行初始設定精靈

bash
openclaw onboard --install-daemon

設定精靈將引導你完成:

  1. 1.API 金鑰設定:貼上你的 Anthropic 或 OpenAI API 金鑰。如果你想使用本地模型,可以之後再設定 Ollama。
  2. 2.聊天平台:選擇要先連接哪個通訊應用程式。WhatsApp 是最受歡迎的選擇——你需要掃描 QR 碼來連結你的帳號。
  3. 3.常駐程式安裝:常駐程式讓 OpenClaw 在背景持續運行,即使你關閉終端機也不會中斷。

步驟四:打聲招呼

開啟你連接的聊天應用程式(WhatsApp、Telegram 等),發送一則訊息給你的代理:

> 嗨!你能做什麼?

你的代理會回覆它的能力摘要。試試以下幾個功能:

  • 「東京現在幾點?」
  • 「摘要這篇文章:[貼上網址]」
  • 「提醒我明天下午 6 點打電話給媽媽」
  • 「搜尋最新的 OpenClaw 版本」

步驟五:自訂你的代理

設定它的個性

編輯 ~/.openclaw/agents/default/SOUL.md 來定義你代理的語氣和規則。例如:

markdown
You are a helpful, concise assistant. Always confirm before deleting files or sending messages.

安裝技能

技能是賦予你的代理新能力的外掛:

bash
openclaw skill install web-search
openclaw skill install home-assistant
openclaw skill install github-integration

ClawHub 市集 瀏覽可用的技能。

存取 Web UI

OpenClaw 包含一個本地網頁儀表板:

bash
openclaw ui

這會開啟一個瀏覽器介面,你可以在其中查看對話歷史、管理技能、監控代理活動和調整設定。

了解架構

You (phone/laptop)
    |
    v
Chat Platform (WhatsApp, Telegram, Discord...)
    |
    v
OpenClaw Gateway (runs on your machine)
    |
    v
AI Model (Claude, GPT, Ollama, etc.)
    |
    v
Skills & Tools (file system, web, APIs, smart home...)

你的訊息從聊天應用程式流向你機器上的 OpenClaw 閘道器。閘道器將訊息傳送到 AI 模型進行推理,然後使用已安裝的技能執行任何操作。回應透過相同的路徑流回。

除了 AI 模型推論(除非你使用 Ollama 進行本地推論),所有東西都在本地運行。

第一週常見問題

「為什麼我的代理回應很慢?」 冷啟動後的第一個回應需要幾秒鐘,因為 AI 模型需要載入上下文。同一對話中的後續訊息會更快。如果回應持續很慢,請檢查你與 AI 供應商的網路連線。

「這會花我多少錢?」 輕度使用(每天幾次對話)通常每月 API 費用為 $10-30。你可以透過使用 Claude Haiku 或本地模型處理簡單任務來大幅降低成本。

「我可以同時使用多個聊天應用程式嗎?」 可以。OpenClaw 可以同時連接 WhatsApp、Telegram、Discord 和其他平台。來自所有平台的訊息都由同一個代理處理。

「安全嗎?」 OpenClaw 在你的機器上運行,你控制所有資料。保持更新、安裝前審查技能,並遵循 docs.openclaw.ai/security 上的安全指南。

接下來

歡迎加入 OpenClaw 社群。你的龍蝦已經準備好了。

訂閱更新

第一時間收到新功能和整合資訊。不會發垃圾信,隨時可以退訂。