注：如果已经安装OpenClaw可直接查看微信接入配置，跳过前面的安装。ClawBot 是基于 OpenClaw 平台的智能 AI 助手，可以让你在微信中直接与 AI 对话。OpenClaw 是一个开源的、自托管的 AI 网关，支持多个聊天平台（WhatsApp、Telegram、Discord、微信等）。核心优势
- 🤖 多模型支持：支持 OpenAI、Claude、GLM 等多种 AI 模型- 📱 多平台接入：一个 Gateway 服务同时支持微信、Telegram、Discord 等- 🔐 数据自主可控：运行在你自己的设备上，数据不经过第三方服务器- 🎨 功能丰富：支持文字、图片、语音、文件等多种消息类型- 🛡️ 安全可靠：支持配对机制，只有授权用户才能使用准备工作
系统要求
- 操作系统：macOS、Linux 或 Windows (WSL2)- Node.js：版本 24.x（推荐）或 22.16+检查 Node.js 版本
如果版本低于 22.16，请先升级 Node.js。安装步骤
第一步：安装 OpenClaw
npm install -g openclaw@latest
# 使用 pnpmpnpm add -g openclaw@latest# 使用 bunbun add -g openclaw@latest
第二步：运行初始化向导
openclaw onboard --install-daemon
第三步：启动 Gateway
openclaw gateway --port 18789 --verbose
微信接入配置
手机微信需要升级至最新版本，在设置-插件中有微信ClawBot模块。
方法一：快速安装（推荐）
npx -y @tencent-weixin/openclaw-weixin-cli install
方法二：手动安装
1. 安装微信插件
openclaw plugins install "@tencent-weixin/openclaw-weixin"
2. 启用插件
openclaw config set plugins.entries.openclaw-weixin.enabled true
3. 扫码登录
openclaw channels login --channel openclaw-weixin
██████████████████████████████████████████████████████████████ ▄▄▄▄▄ █▀█ ▄▄▄▄▄ ████████ █ █ █▀▀▀█ █ ████████ █▄▄▄█ ██▄ █▄▄▄█ ████...
使用手机微信扫描二维码并确认授权。授权成功后，登录凭据会自动保存在本地，无需重复登录。4. 重启 Gateway
添加多个微信账号
openclaw channels login --channel openclaw-weixin
每次扫码登录都会创建一个新的账号条目，支持多个微信账号同时在线。使用指南
开始对话
配置完成后，打开手机微信，找到刚刚登录的微信号（通常显示为"文件传输助手"或自定义昵称），发送消息即可与 AI 对话。支持的消息类型
常用命令
| |
| |
| |
| |
| /think off|low|medium|high | |
| |
多账号上下文隔离
默认情况下，所有渠道共享同一个 AI 对话上下文。如果需要为每个微信账号隔离对话上下文：openclaw config set agents.mode per-channel-per-peer
这样每个"微信账号 + 消息发送者"组合都有独立的 AI 记忆，防止不同对话之间混淆。高级配置
配置 AI 模型
编辑配置文件 ~/.openclaw/openclaw.json：{ "agent": { "model": "anthropic/claude-opus-4-6" }}
- anthropic/claude-opus-4-6
- anthropic/claude-sonnet-4
配置访问权限
仅允许特定用户
{ "channels": { "openclaw-weixin": { "allowFrom": ["user_id_1", "user_id_2"] } }}
配置配对机制
默认情况下，陌生用户需要配对码才能使用。批准配对：多代理路由
OpenClaw 支持将不同渠道路由到不同的 AI 代理：{ "agents": { "mode": "per-channel", "defaults": { "model": "openai/gpt-4o" }, "perChannel": { "openclaw-weixin": { "model": "anthropic/claude-opus-4-6" } } }}
配置 Gateway 远程访问
使用 Tailscale
{ "gateway": { "tailscale": { "mode": "serve" } }}
使用密码保护
{ "gateway": { "auth": { "mode": "password", "password": "your_secure_password" } }}
常见问题
Q1: 扫码登录失败怎么办？
- 尝试重新运行 openclaw channels login --channel openclaw-weixin
- 检查 Gateway 是否正在运行：openclaw gateway status
Q2: 微信消息没有响应？
- 检查 Gateway 日志：openclaw gateway --verbose
- 确认插件已启用：openclaw config get plugins.entries.openclaw-weixin.enabled
- 重启 Gateway：openclaw gateway restart
Q3: 如何查看运行日志？
# 实时查看日志openclaw gateway --verbose# 或查看日志文件tail -f ~/.openclaw/logs/gateway.log
Q4: 如何更新到最新版本？
# 更新 OpenClawnpm update -g openclaw@latest# 运行诊断工具openclaw doctor# 重启 Gatewayopenclaw gateway restart
Q5: 支持群聊吗？
{ "channels": { "openclaw-weixin": { "groups": { "*": { "requireMention": true } } } }}
requireMention: true 表示只有在群里 @机器人 时才会响应。Q6: 如何切换不同的 AI 模型？
openclaw config set agent.model "openai/gpt-4o"
发送命令：/model openai/gpt-4oQ7: 数据安全吗？
A: ClawBot 运行在你自己的设备上，所有数据都保存在本地：- 配置文件：~/.openclaw/openclaw.json
- 凭据：~/.openclaw/credentials
只有你的 AI 对话会发送到相应的 AI 服务商（如 OpenAI、Anthropic），建议使用最强的最新一代模型以获得最佳体验和安全性。Q8: 如何完全卸载？
# 停止服务openclaw gateway stop# 卸载 npm 包npm uninstall -g openclaw# 删除配置文件（可选）rm -rf ~/.openclaw
技术原理（开发者参考）
架构概览
微信消息 ↓OpenClaw Gateway (localhost:18789) ↓微信插件 (openclaw-weixin) ↓AI 模型 (OpenAI/Claude/GLM) ↓响应消息 → 微信
API 协议
微信插件通过 HTTP JSON API 与后端网关通信。主要接口包括：详细 API 文档请参考：https://docs.openclaw.ai相关资源
- 官方网站：https://openclaw.ai- 文档中心：https://docs.openclaw.ai- GitHub：https://github.com/openclaw/openclaw- 社区支持：https://discord.gg/clawd- 技能市场：https://clawhub.com
夜雨聆风
