企业微信接入

企业微信（WeCom）是国内接入 OpenClaw 最成熟的微信系方案，社区插件功能完善。

插件介绍

openclaw-plugin-wecom 是目前功能最完善的企业微信集成插件，支持三种工作模式：

模式	私聊	流式回复	主动推送	思考过程
Bot 模式	支持	支持	不支持	支持
Agent 模式	支持	不支持	支持	不支持
Webhook 模式	不支持	不支持	支持	不支持

推荐使用 Bot 模式，体验最好。

前置准备

1. 创建企业微信应用

1. 登录 企业微信管理后台
2. 应用管理 → 自建 → 创建应用
3. 记录 AgentId、Secret
4. 在企业信息页记录 CorpId

2. 配置回调

在应用详情 → API 接收消息中配置：

• URL：你的服务器回调地址
• Token：自定义 Token
• EncodingAESKey：自动生成的 43 位密钥

安装插件

openclaw plugins install @sunnoy/wecom

配置

编辑 ~/.openclaw/openclaw.json：

{
  "channels": {
    "wecom": {
      "enabled": true,
      "corpId": "ww_your_corp_id",
      "agentId": 1000002,
      "secret": "your_app_secret",
      "token": "your_callback_token",
      "encodingAesKey": "43位AES密钥",
      "adminUsers": ["admin_userid"],
      "mode": "bot"
    }
  }
}

配置项说明

参数	说明
corpId	企业 ID
agentId	应用 AgentId
secret	应用 Secret
token	回调 Token
encodingAesKey	回调加密密钥
adminUsers	管理员 userid 列表
mode	工作模式：bot / agent / webhook

启动

openclaw gateway restart
openclaw doctor

特色功能

动态 Agent 管理

插件支持按用户或群自动创建独立的 Agent 实例，每个用户/群有独立的上下文和记忆：

{
  "channels": {
    "wecom": {
      "dynamicAgents": true,
      "agentIsolation": "per-user"
    }
  }
}

消息防抖

避免用户快速连续发送多条消息时触发多次 AI 调用：

{
  "channels": {
    "wecom": {
      "debounceMs": 2000
    }
  }
}

指令白名单

限制可执行的命令，增强安全性：

{
  "channels": {
    "wecom": {
      "allowedCommands": ["/status", "/new", "/model"]
    }
  }
}

Heartbeat 定时推送

定时向指定用户推送消息（如每日摘要）：

{
  "channels": {
    "wecom": {
      "heartbeat": {
        "enabled": true,
        "cron": "0 9 * * *",
        "message": "早上好，以下是今日待办事项摘要："
      }
    }
  }
}

个人微信

不推荐

个人微信没有官方 Bot API，所有第三方方案都基于逆向协议，存在严重封号风险。

如果你确实需要微信生态的 AI 助手，请使用企业微信方案。

常见问题

回调验证失败

1. 确认 Token 和 EncodingAESKey 与企业微信后台一致
2. 检查回调 URL 是否可从公网访问
3. 确认服务器防火墙已开放对应端口

消息发送失败

1. 检查 Secret 是否正确
2. 确认应用的可见范围包含目标用户
3. 运行 openclaw doctor 检查插件状态

流式回复不生效

流式回复仅在 Bot 模式下支持。检查配置中 mode 是否为 "bot"。