教程

三步连接微信到 OpenClaw

让你的 AI 助手 24/7 在微信中响应消息，无需服务器、无需公众号。

开始之前

确保你已经完成以下准备：

💡
还没装 OpenClaw？

运行 curl -fsSL https://openclaw.ai/install.sh | bash，然后执行 openclaw onboard --install-daemon 完成引导。

1

安装微信插件

OpenClaw 通过插件系统连接各类消息渠道。微信插件由腾讯微信团队官方提供。

一键安装（推荐）

Terminal 
npx -y @tencent-weixin/openclaw-weixin-cli install

这条命令会自动完成插件下载、安装和启用。

手动安装

如果你更喜欢手动操作：

Terminal 
# 安装插件
openclaw plugins install "@tencent-weixin/openclaw-weixin"

# 启用插件
openclaw config set plugins.entries.openclaw-weixin.enabled true
2

扫码登录微信

运行登录命令，终端会显示一个二维码：

Terminal 
openclaw channels login --channel openclaw-weixin
⏱
二维码有效期约 60 秒

过期后会自动刷新，最多刷新 3 次。如果全部过期，重新运行登录命令即可。

3

重启 Gateway

让新配置生效：

Terminal 
openclaw gateway restart

验证一切正常：

Terminal 
openclaw gateway status

你应该看到类似输出：

Runtime: running (pid 7750, state active)
RPC probe: ok
Listening: 127.0.0.1:18789
🎉
完成！

现在给你的微信发一条消息试试，OpenClaw 会自动回复。

进阶配置

多账号支持

再次运行登录命令即可添加更多微信账号：

Terminal
openclaw channels login --channel openclaw-weixin

每个账号会生成独立的凭证条目，Gateway 重启后同时生效。

会话隔离

如果有多个微信账号，建议开启上下文隔离，避免不同账号之间的 AI 记忆串线：

Terminal
openclaw config set agents.mode per-channel-per-peer

这会让每个「微信账号 + 发送者」组合维护独立的对话上下文。

查看日志

微信插件的日志和 Gateway 主日志在同一文件中：

Terminal
# 实时查看日志
tail -f ~/.openclaw/logs/gateway.log

# 只看微信相关
grep "openclaw-weixin" ~/.openclaw/logs/gateway.log
健康检查

运行 doctor 命令检查整体配置状态：

Terminal
openclaw doctor --fix

常见问题

二维码扫了但没反应？

扫码后需要在手机微信上点击确认授权。如果超时，会自动刷新二维码，重新扫描即可。

安装时提示 Config validation failed？

可能是配置文件中存在无效字段。运行以下命令自动修复：

Terminal
openclaw doctor --fix
消息发了但 AI 没回复？

检查以下几点：

  • 确认 Gateway 正在运行：openclaw gateway status
  • 确认模型 API key 配置正确
  • 查看错误日志：tail -20 ~/.openclaw/logs/gateway.err.log
如何断开微信连接？

禁用插件并重启 Gateway：

Terminal
openclaw config set plugins.entries.openclaw-weixin.enabled false
openclaw gateway restart