学习 AI

简体中文

English

简体中文

English

Appearance

OpenClaw 微信接入指南 ​

前置知识：本章节面向具备基础 TypeScript/Node.js 经验的 iOS 开发者。
目标读者：希望在 iOS 设备上通过微信接入 OpenClaw 的用户。
维护状态：⚠️ 实验性功能，维护不稳定，可能存在限制和未报告的问题。

⚠️ 重要声明 ​

微信接入属于高度实验性功能，存在以下已知限制：

  1. 仅支持 iOS：不支持 Android、macOS、Windows
  2. 仅支持私聊：不支持群聊、不支持加入群组
  3. 封号风险：微信可能对第三方机器人接入采取限制措施
  4. 维护状态：功能维护不稳定，功能可能随时中断
  5. 数据安全：消息数据将通过第三方服务传输，请自行评估风险

💡 建议：生产环境优先考虑 飞书接入，飞书接入更稳定、功能更完整。

目录 ​

  1. 环境要求
  2. 安装步骤
  3. 配置与运行
  4. 验证接入
  5. 已知限制
  6. 安全与封号风险警告

1. 环境要求 ​

组件最低要求推荐版本
iOS 版本iOS 15.0+iOS 16.0+
微信版本WeChat ≥ 8.0.70最新版
WeChatClawBot 插件最新版最新版
Node.js（Gateway 主机）v20 或 v24+v24+
OpenClawv2026.3+最新版

1.1 检查微信版本 ​

打开微信 → 「我」→ 「设置」→ 「关于微信」，确认版本 ≥ 8.0.70。

2. 安装步骤 ​

2.1 安装 OpenClaw Gateway ​

在运行 OpenClaw 的主机上（通常是本地电脑或服务器）安装 OpenClaw：

bash
# 全局安装 OpenClaw
pnpm add -g openclaw

# 确认安装成功
openclaw --version

2.2 安装 WeChatClawBot CLI 插件 ​

bash
npx -y @tencent-weixin/openclaw-weixin-cli@latest install

执行后，插件会自动：

  1. 检测本地 OpenClaw 安装
  2. 添加必要依赖
  3. 显示配对二维码

2.3 配置 Gateway ​

启动 Gateway（需要先配置 ~/.openclaw/openclaw.json）：

bash
# 创建配置文件
mkdir -p ~/.openclaw

配置 ~/.openclaw/openclaw.json：

json5
{
  // ⚠️ 安全提示：禁止硬编码敏感信息！
  channels: {
    wechat: {
      enabled: true,
      // connectionMode 支持 websocket（推荐）和 webhook
      connectionMode: "websocket"
    }
  },

  gateway: {
    mode: "local",
    port: 18789
  }
}

2.4 启动 Gateway ​

bash
# 启动 Gateway（需要保持运行）
openclaw gateway

# 查看状态
openclaw status

3. 配置与运行 ​

3.1 在 iOS 上配对 ​

  1. 打开微信
  2. 进入「我」→「设置」→「插件」(Plug-in)
  3. 找到「WeixinClawBot」插件
  4. 点击「扫码配对」，扫描步骤 2.2 显示的二维码
  5. 配对成功后，插件状态变为「已连接」

3.2 验证连接 ​

配对成功后，在微信中向任一联系人发送消息，确认：

  • OpenClaw Gateway 日志显示收到消息
  • 机器人正常回复

4. 验证接入 ​

4.1 基本验证 ​

bash
# 查看 Gateway 日志
openclaw gateway --verbose

# 诊断工具
openclaw doctor

4.2 测试消息 ​

在微信中向机器人发送：

/help

应收到帮助信息回复。

5. 已知限制 ​

限制类型具体说明严重程度
平台限制仅支持 iOS🔴 高
消息类型仅支持私聊🔴 高
群组支持不支持群聊、不支持加群🔴 高
功能稳定性功能处于实验阶段🟡 中
数据隐私消息经第三方传输🟡 中

5.1 不支持的功能 ​

  • ❌ 群聊消息收发
  • ❌ 加入群组
  • ❌ 发送语音/视频消息
  • ❌ 文件传输
  • ❌ 微信支付相关功能
  • ❌ 公众号消息接收

6. 安全与封号风险警告 ​

6.1 封号风险等级：⚠️ 高 ​

使用第三方插件接入微信存在较高封号风险，微信官方可能：

  1. 临时限制：限制消息发送频率、限制功能使用
  2. 永久封号：检测到违规行为后直接封禁账号
  3. 功能降级：限制部分功能的使用

6.2 风险场景 ​

场景风险等级说明
正常私聊使用🟡 中使用频率正常，风险较低
高频消息轰炸🔴 高短时间内大量消息，极高封号风险
敏感词传播🔴 高发送违规内容
多账号批量操作🔴 高批量注册或操作多个账号

6.3 安全建议 ​

  1. 仅用于测试：不要在主账号上使用，备用小号更安全
  2. 控制频率：避免短时间内发送大量消息
  3. 避免违规：不发送微信协议禁止的内容
  4. 定期备份：重要聊天记录定期备份
  5. 隔离使用：建议使用独立测试账号

6.4 免责声明 ​

⚠️ 使用本功能即表示您已充分理解并接受以下风险：

  • 微信账号可能被封禁或限制
  • 消息数据可能被第三方服务收集
  • 功能可能随时因微信政策调整而失效
  • 作者不对任何封号或数据损失承担责任

延伸阅读 ​