AI > openclaw >

在 OpenClaw中配置企业微信(WeCom)机器人的完整教程

2026-03-25 15:36:16 January1207

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

一、前置条件

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

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

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

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

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

2. 创建应用

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

3. 获取应用凭证

在应用详情页面，找到：

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

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

4. 配置消息接收

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

三、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: 消息发送成功但收不到回复？

检查：

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

Q2: 配置显示 “not configured”？

确保：

botId 和 secret 正确
已启用 WeCom 插件
重启 Gateway

Q3: 如何查看日志？

openclaw logs

查找包含 wecom 的日志。

Q4: 消息延迟或丢失？

可能是网络问题，检查：

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

八、安全建议

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

九、相关命令速查

命令	说明
`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. 群聊配置

让机器人在群聊中工作：

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

{
  "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"]'

总结

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

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

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

以上就是在 OpenClaw中配置企业微信(WeCom)机器人的完整教程的详细内容，更多关于OpenClaw配置企业微信机器人的资料请关注脚本之家其它相关文章！