一、前置條件（開始前先準備）
1. 硬體
- 一台 Mac（MacBook / Mac mini / Apple Silicon）
- 建議 macOS 已更新到最新版本
2. AI 模型 API Key（擇一）
先申請並保存 API Key：
可用模型例如：
- GLM-4.7
- MiniMax
- Kimi
- Claude
- GPT
- Gemini
建議新手：
GLM-4.7（便宜且穩定）
取得：
https://open.bigmodel.cn
建立並複製 API Key
3. Telegram 帳號
需要一個 Telegram 帳號
下載：
https://telegram.org
二、Mac 環境安裝
OpenClaw 運行需要 Node.js 環境。
順序：
Homebrew → fnm → Node.js → OpenClaw
Step 1
安裝 Homebrew
打開 Terminal
貼上：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
安裝完成後執行：
echo >> ~/.zprofile
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
驗證：
brew -v
看到版本號代表成功。
Step 2
安裝 fnm（Node.js 管理工具）
brew install fnm
啟用 fnm：
echo 'eval "$(fnm env --use-on-cd)"' >> ~/.zshrc
source ~/.zshrc
驗證：
fnm --version
Step 3
安裝 Node.js（官方推薦 v22）
fnm install 22
fnm use 22
fnm default 22
驗證：
node -v
npm -v
正常會看到類似：
v22.x.x
10.x.x
Step 4
安裝 OpenClaw
npm i -g openclaw
完成後即可使用。
三、建立 Telegram Bot
在 Telegram 搜尋：
@BotFather
流程：
1️⃣ 輸入
/start
2️⃣ 建立新 Bot
/newbot
3️⃣ 設定
Bot Name
例如：
MyOpenClaw
4️⃣ 設定 Username（必須 bot 結尾）
例如：
my_openclaw_bot
5️⃣ 取得
BOT TOKEN
格式像：
123456:ABCDEFxxxxxxxx
保存 Token
四、OpenClaw 初始設定
執行：
openclaw onboard
進入設定介面。
設定 AI 模型
選擇：
Model Settings
填入：
Provider
Zhipu
Model Name
glm-4.7
API Key
你的 API Key
保存。
設定 Telegram Channel
進入：
Channels
選：
Telegram Bot
填入：
Bot Token
保存。
五、完成 Telegram 綁定
在 Telegram 對 Bot 發送：
/start
會得到：
PAIR-XXXXXX
回到 Terminal：
openclaw pairing approve telegram PAIR-XXXXXX
成功會看到：
Approved telegram sender
六、測試 AI 助手
在 Telegram 對 Bot 發送：
你好
若成功回覆
代表 OpenClaw 已經運作。
一句話總結整個架構
OpenClaw 的本質其實是：
Mac
↓
Node.js
↓
OpenClaw
↓
LLM API
↓
Telegram Bot
你是在 Telegram 跟 AI 說話
Mac 只是 AI 助理的大腦主機。
