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 不是黑盒平台，而是一层薄薄的胶水——粘得住协议，也粘得住你的代码。它不替你思考，只确保你的想法，不出你的局域网。