前提条件
- OpenClaw 已安装并能正常启动网关
- 至少配置了一个 AI 模型
- 一个可用的微信账号（个人号或企业微信）
安装微信频道插件
微信频道作为 OpenClaw 的插件频道提供，需要先安装：
clawhub install channel-wechat
配置步骤
1. 基础配置
在 openclaw.json5 中添加微信频道配置：
{
channels: {
wechat: {
enabled: true,
mode: "personal", // personal | enterprise
dmPolicy: "pairing",
groupPolicy: "allowlist",
allowFrom: []
}
}
}
2. 启动并扫码登录
启动网关后，终端会输出一个二维码：
openclaw gateway
用微信扫描二维码完成登录。登录成功后，终端会显示：
[wechat] 登录成功：用户名（wxid_xxx）
[wechat] 监听消息中...
3. 配置消息策略
私聊策略
{
channels: {
wechat: {
dmPolicy: "pairing", // 需要配对码才能使用
pairingMessage: "请发送配对码以激活 AI 助手"
}
}
}
可选策略：
pairing：用户需要发送配对码（推荐）allowlist：仅白名单用户可用open：所有人可用（谨慎使用）
群聊策略
{
channels: {
wechat: {
groupPolicy: "allowlist",
allowGroups: ["AI交流群", "技术讨论"],
triggerKeyword: "@AI" // 群聊中触发 AI 的关键词
}
}
}
4. 消息处理配置
{
channels: {
wechat: {
// 消息类型支持
supportImage: true, // 处理图片消息
supportVoice: true, // 语音转文字后处理
supportFile: false, // 文件消息
// 回复控制
replyQuote: true, // 回复时引用原消息
typingDelay: 500, // 模拟打字延迟（ms）
maxReplyLength: 2000, // 单条回复最大字数
splitLongReply: true // 超长回复自动分段发送
}
}
}
企业微信模式
如果使用企业微信，配置略有不同：
{
channels: {
wechat: {
mode: "enterprise",
corpId: "ww_xxx",
agentId: 1000002,
secret: "xxx",
token: "xxx",
encodingAESKey: "xxx",
webhookUrl: "https://your-domain.com/webhook/wechat"
}
}
}
企业微信需要在企业微信管理后台创建自建应用，并配置回调 URL。
掉线与重连
微信协议的特殊性决定了连接可能不稳定。OpenClaw 内置了自动重连机制：
{
channels: {
wechat: {
autoReconnect: true,
reconnectInterval: 30000, // 30 秒后重试
maxReconnectAttempts: 10
}
}
}
如果频繁掉线，检查以下几点：
- 确保微信账号没有在其他设备登录 Web 版
- 避免同时使用多个微信自动化工具
- 新注册的微信号可能无法使用 Web 协议
常见问题
扫码后一直显示"等待确认"
检查手机微信是否弹出了登录确认页面，需要在手机上点击确认。
群聊中 AI 不回复
- 确认群名在
allowGroups列表中 - 确认消息中包含
triggerKeyword - 检查
groupPolicy是否为disabled
收到消息但不回复
查看网关日志确认模型是否正常响应：
openclaw gateway --log-level debug
注意事项
- 个人微信的 Web 协议存在封号风险，建议使用不常用的号
- 企业微信模式更稳定，推荐商用场景使用
- 微信对消息频率有限制，避免短时间内发送大量消息
- 图片和文件消息会产生额外的存储开销