OpenClaw本地AI助手实战指南:5分钟部署支持WhatsApp/Telegram的私有Agent

OpenClaw实战指南:5分钟在本地跑起支持WhatsApp/Telegram的私有AI助手
问题
想用WhatsApp或Telegram和AI助手聊天,但不想把用户消息发到云端——怕隐私泄露、被封号,或者被网络延迟拖慢响应。
Botpress、Rasa这类框架得配Nginx、写Webhook、搞OAuth,再自己接大模型API;而Claude和ChatGPT官方根本不开放Telegram接入。
方案
用 OpenClaw ——第一个真正“开箱即用”的本地AI Agent框架。它不是网页应用,而是你电脑上直接运行的程序:
✅ 消息从WhatsApp/Telegram直连你的笔记本,数据不出本地
✅ 内置轻量路由层,自动识别用户、分发消息、返回回复,不用写Webhook
✅ 原生支持Claude(Anthropic API)、Ollama本地模型、RAG检索(可插拔)
✅ 不依赖Docker、不建Python虚拟环境、不注册系统服务,Windows/macOS/Linux全通
它快,是因为把“消息通道”和“AI核心”彻底拆开,靠配置驱动,不靠硬编码。
步骤(全程5分钟,无编译、无依赖安装)
1. 下载并解压二进制包(跳过pip install)
OpenClaw是纯Go写的单文件程序,不装Python包,不改PATH:
# macOS / Linux
curl -L https://github.com/openclaw/openclaw/releases/download/v0.4.2/openclaw_0.4.2_darwin_arm64.tar.gz | tar -xz
# Windows(用PowerShell)
Invoke-WebRequest -Uri "https://github.com/openclaw/openclaw/releases/download/v0.4.2/openclaw_0.4.2_windows_amd64.zip" -OutFile "openclaw.zip"; Expand-Archive openclaw.zip✅ 不用pip,避开Python版本冲突和依赖地狱。Go二进制自带HTTP服务器、TLS、消息加解密,启动就是服务。
2. 创建配置文件 config.yaml
同目录新建文本文件,粘贴以下内容(只改3处):
llm:
provider: anthropic
api_key: "your_anthropic_api_key_here" # 在 https://console.anthropic.com/settings/keys 获取
model: "claude-3-haiku-20240307"
channels:
whatsapp:
enabled: true
phone_number: "+8613800138000" # 你的WhatsApp注册手机号(带国家码)
telegram:
enabled: true
bot_token: "123456789:ABCdefGhIjKlmNoPqrStUvWxyZ" # @BotFather给的token
# RAG知识库(可选但推荐):放一个PDF或TXT到当前目录叫 `faq.txt`
retriever:
enabled: true
files: ["faq.txt"]✅ RAG默认走本地文件,不调外部向量数据库(比如Chroma)。faq.txt 自动切片+嵌入,全程在内存完成,不写磁盘、不联网。3. 启动OpenClaw
双击 openclaw(macOS/Linux)或 openclaw.exe(Windows),终端输出:
✅ WhatsApp connected: +8613800138000
✅ Telegram bot online: @your_bot_name
🚀 Listening on http://127.0.0.1:8080 (for debug only)✅ 没有“正在下载模型”提示,因为Claude走API直连——OpenClaw只做请求转发和上下文管理。你用的是原生Claude,不是量化版,效果不打折。
验证
- 打开Telegram,搜索你的bot名,发
/start→ 收到欢迎语 - 换一台手机,用WhatsApp扫码登录,给你的号码发“今天天气如何?” → 5秒内收到Claude回复(含
faq.txt里的公司政策条款) - 查本机进程:
ps aux | grep openclaw→ 只有一个进程,内存占用<120MB
实测延迟(M2 Mac):消息抵达 → 调Claude API → 注入RAG片段 → 生成回复 → 回传Telegram,端到端平均 1.8秒(不含网络波动)。
👉 Binance · OKX · Gate.io · HTX · Bitget
常见问题
Q:WhatsApp需要商业账号或Business API吗?
A:不需要。OpenClaw用的是官方WhatsApp Business App的个人设备协议(类似WhatsApp Desktop),只要手机号已注册WhatsApp就能用,不走Facebook审核流。
Q:我的知识库是Excel表格,能用吗?
A:可以。把faq.txt换成policy.xlsx,OpenClaw会自动解析Sheet1的A/B列(问题/答案)转为RAG语料。支持CSV、MD、PDF。
Q:如何限制只有公司同事能聊?
A:在config.yaml里加:
channels:
telegram:
allowed_users: ["@alice", "@bob"] # 用户名白名单Q:能同时接微信吗?
A:目前不支持(微信未开放第三方协议),但Roadmap已标记“企业微信适配”,下个版本(v0.5)将支持。
下一步
你已经跑起了一个完全私有、免运维、跨平台即时通讯兼容的AI助手原型。接下来可以:
🔹 《给OpenClaw加记忆:用SQLite保存用户对话历史》
🔹 《零代码接入企业微信:用OpenClaw+WeCom Bot API》
🔹 《把RAG换成本地模型:用Ollama跑Phi-3替代Claude》
所有教程都基于同一config.yaml结构,改几行就能切换能力,不用重学API。
OpenClaw官网:https://openclaw.dev|GitHub源码:github.com/openclaw/openclaw