OpenClaw入门：第10讲：微信通道接入实战，国内用户必学平台

github star gitee star atomgit star PyPI Downloads AI 编程 AI 交流群

大家好，我是正在实战各种AI项目的程序员晚枫。

今天我们来接入微信，这是国内最重要的即时通讯平台。对于国内用户来说，这几乎是必选项。

微信接入的特殊性

为什么微信比较难接？

平台官方Bot支持接入难度
Telegram✅ 完善⭐
Discord✅ 完善⭐
WhatsApp⚠️ 有限⭐⭐⭐
微信❌ 无官方Bot⭐⭐⭐⭐

微信没有官方的Bot API，需要通过以下方式接入：

  1. 个人微信号（基于itchat/wechaty等库）
  2. 企业微信（有官方API）
  3. 微信公众号（有官方API，但功能受限）

本教程介绍个人微信号接入方式，使用社区插件实现。

⚠️ 重要风险提示

使用非官方方式接入微信：

  • 可能违反微信服务条款
  • 有封号风险
  • 不稳定，随时可能失效

建议：

  • 使用备用微信号测试
  • 不要用于商业用途
  • 控制消息频率，避免被判定为机器人
  • 考虑使用企业微信（更稳定）

安装微信插件

OpenClaw通过插件系统支持微信：

1
2
3
4
5
6
7
# 安装微信插件
openclaw plugins install wechat

# 或手动安装
cd ~/.openclaw/plugins
git clone https://github.com/openclaw/plugin-wechat.git
npm install

配置微信通道

编辑 ~/.openclaw/openclaw.json：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{
  "channels": {
    "wechat": {
      "enabled": true,
      "plugin": "wechat",
      "method": "web", 
      "qrCodePath": "~/.openclaw/state/wechat/qr.png",
      "allowFrom": [],
      "groups": {
        "enabled": true,
        "requireMention": true,
        "mentionKeywords": ["@AI助手", "AI"]
      },
      "autoReply": {
        "enabled": false,
        "keywords": ["在吗", "你好"],
        "response": "你好！我是AI助手，请直接发送你的问题。"
      }
    }
  }
}

配置说明：

  • method: web（网页版协议）或 pad（iPad协议，需付费）
  • qrCodePath: 二维码保存路径
  • mentionKeywords: 群聊中触发回复的关键词

连接微信

执行命令：

1
openclaw channels connect wechat

流程：

1
2
3
4
5
[wechat] Initializing plugin...
[wechat] Generating QR code...
[wechat] QR code saved to ~/.openclaw/state/wechat/qr.png
[wechat] Please scan the QR code with WeChat
[wechat] Waiting for login...

扫码登录

  1. 打开微信手机客户端
  2. 点击右上角+ → 扫一扫
  3. 扫描终端显示的二维码或打开保存的图片
  4. 在手机端确认登录

看到以下提示表示成功：

1
2
3
[wechat] Login successful
[wechat] User: 你的昵称
[wechat] Connected ✓

测试对话

私聊测试

给自己的微信文件传输助手发送消息：

1
你好，请介绍一下自己

群聊测试

在微信群中@你配置的昵称：

1
@AI助手 帮我总结一下这段话的意思

保持登录状态

微信网页版容易掉线，建议：

1. 使用Pad协议（推荐）

需要购买第三方服务，但更稳定：

1
2
3
4
5
6
7
8
{
  "channels": {
    "wechat": {
      "method": "pad",
      "token": "your-pad-protocol-token"
    }
  }
}

2. 自动重连

1
2
3
4
5
6
7
8
9
10
11
{
  "channels": {
    "wechat": {
      "reconnect": {
        "enabled": true,
        "interval": 300,
        "maxRetries": 10
      }
    }
  }
}

3. 心跳检测

1
2
# 添加到cron，每5分钟检查一次
*/5 * * * * openclaw channels status wechat || openclaw channels connect wechat

企业微信方案（更稳定）

如果你有企业微信账号，推荐使用官方API：

1. 注册企业微信

访问 https://work.weixin.qq.com/ 注册

2. 创建应用

管理后台 → 应用管理 → 创建应用

3. 获取凭证

  • CorpID（企业ID）
  • AgentID（应用ID）
  • Secret（应用密钥）

4. 配置OpenClaw

1
2
3
4
5
6
7
8
9
10
{
  "channels": {
    "wecom": {
      "enabled": true,
      "corpId": "wwxxxxxxxxxxxxxxxx",
      "agentId": "1000002",
      "secret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    }
  }
}

企业微信优势：

  • ✅ 官方API，稳定可靠
  • ✅ 无封号风险
  • ✅ 支持更多功能（审批、打卡等）

常见问题

Q1: 扫码后无法登录

原因：微信网页版限制部分账号

解决：尝试使用Pad协议，或换号测试

Q2: 经常掉线

解决：

  • 开启自动重连
  • 减少同时在线设备
  • 考虑企业微信方案

Q3: 收不到群消息

排查：

  • 检查是否被群主禁言
  • 确认@关键词配置正确
  • 查看日志是否有错误

Q4: 提示操作频繁

原因：触发微信风控

解决：降低消息频率，休息一段时间再试

替代方案对比

方案稳定性成本难度推荐度
个人微信(web)⭐⭐免费低⭐⭐
个人微信(pad)⭐⭐⭐⭐付费中⭐⭐⭐⭐
企业微信⭐⭐⭐⭐⭐免费中⭐⭐⭐⭐⭐
微信公众号⭐⭐⭐⭐⭐免费低⭐⭐⭐

建议：正式环境用企业微信，个人测试用网页版。

下节预告

下一讲快速浏览其他通道：Slack、iMessage、飞书、钉钉等。

👉 继续阅读：第11讲-其他通道速览

💬 加入学习交流群

微信接入问题？加群交流：

👉 点击加入交流群

推荐：AI Python编程实战营

🎁 限时福利：送《利用Python进行数据分析》实体书

👉 点击了解详情

—## 📚 完整学习路线这是OpenClaw入门课程的第X讲。查看完整课程大纲：👉 **OpenClaw入门课程大纲**课程包含30讲，从安装部署到实战项目，带你全面掌握OpenClaw。

课程导航

上一篇： 第9讲-Discord通道连接与Slash命令

下一篇： 第11讲-其他通道速览

PS：微信接入虽然麻烦，但对国内用户来说是刚需。建议有条件的话直接使用企业微信方案。

进群

嗨，扫码 进群

微信

扫一扫，分享到微信

微信分享二维码
本站总访问量次

tag:

    缺失模块。
    1、请确保node版本大于6.2
    2、在博客根目录（注意不是yilia根目录）执行以下命令：
    npm i hexo-generator-json-content --save

    3、在根目录_config.yml里添加配置：

      jsonContent:
    meta: false
    pages: false
    posts:
      title: true
      date: true
      path: true
      text: false
      raw: false
      content: false
      slug: false
      updated: false
      comments: false
      link: false
      permalink: false
      excerpt: false
      categories: false
      tags: true

编程博主，全网粉丝30w+，开源项目：python-office，我的微信：python-office