微信频道配置

个人微信没有官方 Bot API，所有接入方案都是非官方实现，封号风险始终存在。

风险警告

微信对第三方接入管控极为严格。无论使用哪种方案，都有可能触发风控导致封号。请勿使用你的主力微信号，建议注册专用小号用于 Bot 服务。

方案概览

方案	路线	合规性	稳定性	技术门槛	推荐度
方案 A	企业微信中转	合法合规	高	中等	推荐
方案 B	iPad 协议 + 中转网关	灰色地带	较高	高	有经验用户
方案 C	微信小程序	合法合规	高	中等	2026 年新方案

方案 A：企业微信中转（推荐）

通过企业微信的官方 API 接入，再利用企业微信与个人微信的互通能力实现消息转发。这是最合规的方案。

配置步骤

1. 注册 企业微信，创建企业
2. 在企业微信管理后台创建自建应用
3. 获取 CorpID、AgentId 和 Secret
4. 配置应用的消息接收 URL，指向 Gateway
5. 在 openclaw.yaml 中配置：

channels:
  wechat:
    enabled: true
    provider: wecom          # 企业微信中转
    corpId: "ww1234567890"
    agentId: 1000002
    secret: "your-app-secret"
    token: "your-callback-token"
    encodingAesKey: "your-encoding-aes-key"

优势

企业微信方案完全合规，不存在封号风险。企业微信应用可以向已添加的外部联系人发送消息，也可以在企业内部群中使用。

方案 B：iPad 协议 + 中转网关

通过模拟 iPad 端微信协议登录，将消息转发到 OpenClaw Gateway。稳定性较高但技术门槛也更高。

配置步骤

1. 部署 iPad 协议服务（如社区维护的开源方案）
2. 扫码登录微信
3. 配置中转网关，将消息转发到 OpenClaw
4. 在 openclaw.yaml 中配置：

channels:
  wechat:
    enabled: true
    provider: ipad-bridge
    bridgeUrl: "http://localhost:8080"
    botWxId: "wxid_xxxxxxxxxx"

注意事项

• 需要自行维护协议服务，微信协议更新时可能失效
• 新注册账号风险极高，建议使用有一定历史的号
• 避免频繁登录登出，保持会话稳定

方案 C：微信小程序（2026 年新方案）

2026 年推出的新方案，通过微信小程序作为消息入口，用户在小程序中与 Agent 对话。

配置步骤

1. 在 微信公众平台 注册小程序
2. 使用 OpenClaw 提供的小程序模板部署前端
3. 配置小程序后端指向 OpenClaw Gateway
4. 在 openclaw.yaml 中配置：

channels:
  wechat:
    enabled: true
    provider: miniprogram
    appId: "wx1234567890"
    appSecret: "your-app-secret"

方案 C 的局限

小程序方案合法合规，但用户需要主动打开小程序才能对话，无法像其他方案那样在微信聊天列表中直接收到 Bot 消息。

openclaw-china 统一插件

一站式方案

BytePioneer-AI/openclaw-china 统一插件也支持微信接入，并提供了更简化的配置流程。

openclaw plugin install openclaw-china

安装后参考插件文档配置微信渠道。

安全建议

1. 使用专用小号 — 不要用日常联系的主号
2. 限制消息频率 — 配置合理的速率限制，避免被识别为异常行为
3. 避免敏感内容 — 不要让 Bot 发送可能触发审核的内容
4. 定期检查状态 — 监控登录状态，及时处理异常

常见问题

扫码登录后很快掉线？

新号或长期未使用的号容易被风控。建议先正常使用该微信号一段时间（1-2 周），再接入 Bot 服务。

企业微信方案能和个人微信互通吗？

可以。企业微信的外部联系人功能允许与个人微信用户沟通。你也可以将企业微信的 Bot 添加到包含个人微信用户的群组中。