本文详细介绍如何在 OpenClaw 中配置企业微信（WeCom）机器人，实现通过企业微信与 AI 助手交互。

一、前置条件

在开始配置前，你需要准备：

• 一个企业微信账号（需要管理员权限）
• 已安装好的 OpenClaw
• 企业已开通企业微信应用

二、企业微信后台创建应用

1. 登录企业微信管理后台

打开 企业微信管理后台，使用管理员账号登录。

2. 创建应用

1. 进入「应用管理」→「应用」
2. 点击「创建应用」
3. 填写应用信息：
   • 应用名称：OpenClaw AI助手
   • 应用描述：个人 AI 助手
   • 应用图标：可上传自定义图标
4. 设置应用可见范围

3. 获取应用凭证

在应用详情页面，找到：

字段	说明
AgentId	应用 ID
Secret	应用密钥

重要：点击「查看」获取 Secret，建议备份保存。

4. 配置消息接收

1. 进入应用详情
2. 点击「接收消息」→「设置」
3. 配置「企业微信」接收事件的服务器地址

三、OpenClaw 配置

方式一：交互式配置（推荐）

# 启动配置向导
openclaw configure

# 或直接添加渠道
openclaw channels add

按照提示选择「企业微信（WeCom）」，输入凭证信息。

方式二：手动配置

编辑配置文件 openclaw.json：

{
  "channels": {
    "wecom": {
      "enabled": true,
      "config": {
        "botId": "你的Bot ID",
        "secret": "你的Secret"
      }
    }
  }
}

方式三：CLI 配置

# 设置 Bot ID
openclaw config set channels.wecom.botId 你的BotID

# 设置 Secret
openclaw config set channels.wecom.secret 你的Secret

# 启用企业微信
openclaw config set channels.wecom.enabled true

# 重启 Gateway
openclaw gateway restart

四、验证配置

1. 检查状态

openclaw status

应该显示：

WeCom: configured

2. 测试发送

# 发送测试消息
openclaw message send --channel wecom --target 用户ID --message "测试消息"

3. 接收测试

在企业微信中找到你的应用，发送消息，应该能收到 AI 回复。

五、配置参数详解

基础配置

参数	说明	必填
botId	企业微信应用 ID	是
secret	应用密钥	是
enabled	是否启用	是

高级配置

参数	说明	默认值
websocketUrl	WebSocket 地址	wss://openws.work.weixin.qq.com
dmPolicy	私信访问策略	open
groupPolicy	群聊访问策略	open
allowFrom	白名单用户	[]
groupAllowFrom	白名单群组	[]
sendThinkingMessage	发送思考消息	true

访问控制策略

策略	说明
open	所有人可用
allowlist	仅白名单用户/群组
disabled	禁用
pairing	需要配对审批

六、配置示例

示例1：基础配置

{
  "channels": {
    "wecom": {
      "enabled": true,
      "config": {
        "botId": "ww1234567890abcdef",
        "secret": "AbcdefghijklmnopQRSTUVwxyz1234567890"
      }
    }
  }
}

示例2：限制白名单

{
  "channels": {
    "wecom": {
      "enabled": true,
      "config": {
        "botId": "ww1234567890abcdef",
        "secret": "AbcdefghijklmnopQRSTUVwxyz1234567890",
        "dmPolicy": "allowlist",
        "allowFrom": ["user_id_1", "user_id_2"],
        "groupPolicy": "disabled"
      }
    }
  }
}

示例3：完全配置

{
  "channels": {
    "wecom": {
      "enabled": true,
      "config": {
        "botId": "ww1234567890abcdef",
        "secret": "AbcdefghijklmnopQRSTUVwxyz1234567890",
        "websocketUrl": "wss://openws.work.weixin.qq.com",
        "dmPolicy": "open",
        "groupPolicy": "allowlist",
        "groupAllowFrom": ["group_id_1", "group_id_2"],
        "sendThinkingMessage": true
      }
    }
  }
}

七、常见问题

Q1: 消息发送成功但收不到回复？

检查：

1. 应用是否已发布
2. WebSocket 是否正常连接
3. 网络是否能访问企业微信服务器

Q2: 配置显示 “not configured”？

确保：

1. botId 和 secret 正确
2. 已启用 WeCom 插件
3. 重启 Gateway

Q3: 如何查看日志？

openclaw logs

查找包含 wecom 的日志。

Q4: 消息延迟或丢失？

可能是网络问题，检查：

1. 服务器网络稳定性
2. 企业微信服务器状态

八、安全建议

1. 保护 Secret：不要将 Secret 泄露到公开代码库
2. 定期更换：定期更新应用密钥
3. 限制权限：根据需要设置访问策略
4. 日志监控：定期检查消息日志

九、相关命令速查

命令	说明
openclaw status	查看企业微信连接状态
openclaw gateway restart	重启 Gateway
openclaw channels list	查看所有渠道
openclaw message send --channel wecom	发送企业微信消息
openclaw logs	查看企业微信日志
openclaw pairing list wecom	查看配对请求
openclaw pairing approve wecom <CODE>	批准配对请求

十、进阶功能

1. 群聊配置

让机器人在群聊中工作：

1. 在企业微信中创建群聊
2. 添加机器人到群聊
3. 获取群聊 ID
4. 配置白名单：

{
  "channels": {
    "wecom": {
      "config": {
        "groupPolicy": "allowlist",
        "groupAllowFrom": ["群聊ID"]
      }
    }
  }
}

2. 定时推送

设置定时任务推送消息：

openclaw cron add \
  --name "每日早报" \
  --cron "0 7 * * *" \
  --message "早安！今日资讯..." \
  --channel wecom

3. 访问控制

配置仅特定用户可用：

openclaw config set channels.wecom.dmPolicy allowlist
openclaw config set channels.wecom.allowFrom '["user_id_1","user_id_2"]'

总结

配置企业微信机器人需要以下步骤：

1. ✅ 在企业微信管理后台创建应用并获取凭证
2. ✅ 在 OpenClaw 中配置企业微信渠道
3. ✅ 重启 Gateway 并验证
4. ✅ 测试发送和接收消息

按照本文档操作，通常 5-10 分钟即可完成配置。

---

参考链接：

• 企业微信管理后台：https://work.weixin.qq.com/
• OpenClaw 官方文档：https://docs.openclaw.ai/
• WeCom 插件文档：https://github.com/openclaw/wecom-openclaw-plugin