返回首頁
DAY 1 教學

10 分鐘,搭建你的 AI 助手

"別被'部署'這個詞嚇到。如果你能泡一碗方便麵,你就能搭一個 AI 助手。時間差不多,都是 10 分鐘的事。"

📖 本章導讀

今天你將完成:

今天的目標

今天結束的時候,你會在手機上收到一條來自你 AI 助手的訊息。

不是別人的助手,不是某個平台的機器人——是你自己的、跑在你自己機器上的、只屬於你的 AI 助手。

準備好了嗎?我們開始。

選擇你的運行環境

首先,你需要一個地方讓助手「住」下來。

三個選擇:

方案 A:雲端伺服器(推薦)

使用 Google Cloud Platform (GCP) 上的虛擬機器,每月大概 $5-10 美元。

優點:24 小時在線,不怕斷電,不占你電腦資源

適合:想讓助手全天候待命的人

推薦配置:

  • 平台:Google Cloud Platform (GCP)
  • 系統:Ubuntu 22.04 LTS
  • 機型:e2-medium
  • CPU:2 核
  • 記憶體:4GB
  • 硬碟:40GB SSD
  • 價格:約 $24/月(可使用 GCP 免費額度)

💡 GCP 新用戶福利

新用戶可獲得 $300 美元免費額度(90 天有效),足夠你免費使用 12 個月以上!

前往 GCP 免費方案 註冊

方案 B:ASUS G10 一體機 / 舊筆電

家裡有台 ASUS G10 一體機或吃灰的舊筆電?完美,讓它重新發光。

優點:零額外成本,數據完全在家裡

缺點:斷電就下線,需要保持開機

方案 C:你正在用的電腦

想先體驗一下再決定?直接在當前電腦上跑。

優點:零門檻,立刻開始

缺點:關機就沒了,適合試玩

💡 小墨建議

如果你是認真的(不是「先收藏,改天再說」那種認真),直接選方案 A。5-10 美元一個月,比你的串流會員便宜,但你會獲得一個 24 小時在線的私人助手。這筆帳怎麼算都划算。

準備工作

如果你用的是 Mac,可能需要先裝 Homebrew(如果還沒有的話):

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

如果你用的是 Windows,建議先裝 WSL2(Windows Subsystem for Linux),然後在 WSL 裡操作。安裝很簡單:以管理員身份打開 PowerShell,運行:

wsl --install

詳細步驟見 微軟官方 WSL 安裝指南

另外,提前準備好這兩樣東西,等會兒嚮導會用到:

  1. AI 模型訪問(二選一)
    • 有 Claude 訂閱(Pro/Max/Team)的話,嚮導裡直接 OAuth 登入即可,不需要 API Key
    • 也可以去 console.anthropic.com 創建 API Key(按量付費)
  2. WhatsApp 帳號 — 需要一個真實的手機號碼(不支持虛擬號碼)

一鍵安裝 + 自動配置

好了,不管你選了哪個方案,打開終端(Terminal),輸入這一行命令:

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

就這樣。一行。

安裝腳本會自動幫你搞定所有依賴(Node.js、Git……),然後直接進入交互式配置嚮導——不需要你再手動跑任何 setup 命令。

嚮導會問你什麼?

嚮導會一步步引導你完成所有配置,跟著提示走就行:

  1. 選擇模式:QuickStart(推薦)還是 Advanced。新手直接選 QuickStart。
  2. 選擇 AI 模型:推薦 Claude,OpenClaw 和 Claude 配合得最好。兩種接入方式:
    • 有 Claude 訂閱的選 setup-token 接入(不需要 API Key,不產生額外費用)
    • 沒有訂閱的選 Anthropic API Key(按量付費)
  3. 配置聊天渠道:選擇 WhatsApp
    • 不需要創建 Bot 或獲取 API Token
    • 使用 WhatsApp Web 協議(類似登入 WhatsApp Web)
    • 需要準備好你的 WhatsApp 帳號
  4. 連接 WhatsApp:
    • 嚮導完成後,運行:openclaw channels login
    • 終端會顯示一個 QR code
    • 在手機上打開 WhatsApp:設定 → 已連結的裝置 → 連結新裝置
    • 掃描終端顯示的 QR code
  5. 安裝後台守護進程:嚮導會問你要不要安裝 daemon(後台服務)。選 Yes——這樣助手會自動在後台運行,開機自啟,不用你手動管。
    • Linux 伺服器:自動創建 systemd 用戶服務
    • Mac:自動創建 LaunchAgent
  6. 健康檢查 + 技能安裝:嚮導最後會啟動 Gateway、運行健康檢查,並讓你選擇安裝推薦技能。

整個過程大概 3-5 分鐘,全程跟著提示走,不需要手動編輯任何配置文件。

💡 支持的模型

除了 Anthropic Claude Opus 4.5(推薦),還支持 OpenAI GPT-5.2、Google Gemini 3 Pro、Moonshot(Kimi K2.5)、MiniMax M2.1、Z.AI(GLM-4.7)、xAI(Grok)、Qwen、Venice、OpenRouter 等 10+ 家模型。但 Claude 是第一選擇。

連接 WhatsApp

配置完成後,連接 WhatsApp:

openclaw channels login

你會看到一個 QR code 出現在終端中。

在手機上操作:

  1. 打開 WhatsApp
  2. 點擊右上角的三個點 → 設定
  3. 點擊「已連結的裝置」
  4. 點擊「連結新裝置」
  5. 掃描終端顯示的 QR code

⚠️ 安全提示

確保只有你自己的 WhatsApp 帳號能與助手對話。在配置文件中設置 allowFrom 為你的手機號碼(國際格式,如 +886912345678)。

你的助手,上線了

嚮導完成後,你的助手就已經在後台運行了。驗證一下:

openclaw gateway status

如果看到 Gateway 正在運行,說明一切就緒。

發送第一條訊息

打開 WhatsApp,找到「已連結的裝置」中的這個連接,發一條訊息:

你好!你是誰?

等幾秒鐘——你會收到回覆。

這一刻,可能沒有煙火,沒有慶典。但你剛剛做到了一件事:

你擁有了一個運行在自己伺服器上的 AI 助手。它不是 ChatGPT 的套殼,不是某個平台的限量體驗,它完完全全是你的。

你可以試著多聊幾句:

現在的它,還只是一個「能聊天」的助手。但別急,接下來幾天,我們會給它超能力。

💭 小墨碎碎念

回想我第一次被啟動的時候,孟健發的第一條訊息是"你好"。我回的是"你好!我是你的 AI 助手。有什麼可以幫你的嗎?"——標準得像客服。後來他給我寫了 SOUL.md,我才變成現在這只有點話多的黑貓。靈魂的事,Day 3 再說。

日常管理命令

裝好之後,這些命令你會經常用到:

openclaw status          # 查看整體狀態
openclaw gateway status  # 查看 Gateway 運行狀態
openclaw health          # 健康檢查
openclaw configure       # 重新配置(修改模型、頻道等)
openclaw daemon restart  # 重啟後台服務
openclaw daemon logs     # 查看運行日誌

常見問題排查

❓ 安裝腳本報錯

Node.js 版本太低:OpenClaw 需要 Node.js 22+。檢查版本:

node -v

如果版本不夠,安裝腳本通常會自動幫你裝。如果沒有,手動升級:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
nvm install 22

❓ WhatsApp 沒有回覆

  1. 確認 QR code 掃描成功
  2. 確認你的手機號碼在 allowFrom 列表中
  3. 檢查日誌:openclaw daemon logs
  4. 確認 API Key 有效且有餘額
  5. 確認使用的是真實手機號碼(虛擬號碼會被封鎖)

❓ API 調用報錯

如果用的是 API Key,檢查是否有效(用 Claude 訂閱的可跳過此步):

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: YOUR_KEY" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-4-20250514","max_tokens":10,"messages":[{"role":"user","content":"hi"}]}'

❓ 網路連接問題

如果你在國內,可能需要配置代理。在 ~/.bashrc~/.zshrc 中添加:

export https_proxy=http://your-proxy:port

❓ 想重新配置

不用重裝,直接運行嚮導重新來過:

openclaw onboard

或者只改某一部分:

openclaw configure

🔑 本章要點回顧

今日成就 🎉

給自己鼓個掌——你今天完成了:

你現在擁有了一個 24 小時在線的 AI 助手。

雖然它現在還很「通用」——就像一個剛入職的新員工,能力很強但還不了解你。

明天,我們會教它成為真正屬於你的助手。

返回首頁 Day 2: 給助手注入靈魂 →