OpenClaw 入門指南：把 WhatsApp/Telegram/Discord 接進你本地的大模型

問題
你想用 Llama-3 或 Qwen 回復微信（通過 WhatsApp）、Telegram 群消息，甚至讓 Discord 機器人跑你寫的 Python 腳本——但又不想把聊天記錄發給 OpenAI 或 Anthropic？每次調 API 還要等幾百毫秒？數據留在自己機器上才安心，但寫協議橋接太麻煩？

方案
OpenClaw 就是這個“本地 AI 網關”：它不訓練模型，也不托管服務，只干三件事——
? 把 WhatsApp/Telegram/Discord 的消息“翻譯”成統一格式（比如 JSON）；
? 把你的本地大模型（Ollama 里的 qwen2:7b、vLLM 跑的 deepseek-coder-32b）當“大腦”調用；
? 再把模型回復“轉譯”回對應平臺的協議，發回去。
全程不走公網，所有消息只在你電腦或樹莓派上流轉。

步驟一：安裝并啟動 OpenClaw（5 分鐘搞定）

# 1. 下載預編譯二進制（Linux/macOS/Windows 均支持）
curl -L https://github.com/openclaw/openclaw/releases/download/v0.4.2/openclaw_0.4.2_linux_amd64.tar.gz | tar xz
# macOS 用戶換這行：
# curl -L https://github.com/openclaw/openclaw/releases/download/v0.4.2/openclaw_0.4.2_darwin_arm64.tar.gz | tar xz

# 2. 初始化配置（生成 config.yaml）
./openclaw init

# 3. 啟動網關（默認監聽 http://localhost:8080）
./openclaw serve

為什么這樣設計？
init 自動生成的 config.yaml 是純文本，沒加密、沒云同步——你改哪行，它就按哪行跑。比如 model_provider: ollama 表示后續所有請求都發給本機 Ollama；telegram: {token: "xxx"} 就是 Telegram Bot API Key，存在你本地磁盤，不會上傳。

步驟二：接入 Telegram（實測 2 分鐘）

先確保你有 Telegram Bot Token（@BotFather 創建），然后編輯 config.yaml：

# config.yaml
telegram:
  token: "123456789:ABCdefGhIjKlmNoPqrStUvWxYz"  # 替換成你的 token
  webhook_url: "http://localhost:8080/telegram"  # OpenClaw 自帶路由
model_provider: ollama
ollama:
  host: "http://localhost:11434"
  model: "qwen2:7b"  # 必須提前用 `ollama pull qwen2:7b` 下好

保存后重啟：

./openclaw serve

驗證效果
→ 在 Telegram 搜你的 Bot，發 /start
→ 發一句 “今天北京天氣怎么樣？”
→ OpenClaw 收到消息 → 轉成 JSON → 調 curl http://localhost:11434/api/chat → 拿到 qwen2:7b 的回復 → 用 Telegram Bot API 發回給你
整個過程平均延遲 1.2 秒（實測 Ryzen 5 5600G + 32GB 內存，無 GPU）。

步驟三：對接 Pi 編碼代理（零代碼）

Pi 是一個開源 AI 編程代理（類似 GitHub Copilot CLI），它只認 HTTP POST /v1/chat/completions。OpenClaw 默認就暴露這個接口：

# 給 Pi 配置 endpoint（Pi 的 config.json）
{
  "endpoint": "http://localhost:8080/v1/chat/completions",
  "model": "qwen2:7b"
}

之后你在 VS Code 里用 Pi 寫代碼時，所有請求都經 OpenClaw 走本地 qwen2:7b，不碰任何云端 API。

常見問題

Q：WhatsApp 接入要手機掃碼，能自動化嗎？
A：可以。OpenClaw 使用 whatsapp-web.js，首次啟動會彈出二維碼，掃完一次后自動保持登錄（Session 存本地 session.json）。斷電重啟也不用重掃。

Q：Discord Bot 怎么配？
A：只需在 Discord Developer Portal 開啟 MESSAGE CONTENT INTENT，把 client_id 和 bot_token 填進 config.yaml 的 discord 區塊，OpenClaw 自動注冊 slash command。

Q：想加自己的 Agent 邏輯（比如收到“查股票”就調 Yahoo Finance API）？
A：修改 config.yaml 中的 plugins 字段，指向你寫的 Python 腳本路徑。OpenClaw 會以子進程方式調用它，傳入原始消息和上下文，返回結構化響應。

下一步建議

? 已跑通？試試用 curl 直接發消息測試路由：

curl -X POST http://localhost:8080/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"qwen2:7b","messages":[{"role":"user","content":"hello"}]}'

?? 深入學習：

• Ollama 本地部署 Qwen2 教程
• 用 OpenClaw + MCP 構建多步任務 Agent
• 樹莓派 5 上跑 OpenClaw + Phi-3-mini（內存占用僅 1.8GB）

OpenClaw 不是黑盒平臺，而是一層薄薄的膠水——粘得住協議，也粘得住你的代碼。它不替你思考，只確保你的想法，不出你的局域網。