OpenClaw 企业微信接入教程

OpenClaw 企业微信接入教程 📅 最后更新：2026-04-12👤 作者：小龙🎯 适用版本：OpenClaw >= 2026.2.13

📋 目录前置准备安装插件配置步骤验证连接访问控制常见问题

🎯 前置准备

确认 OpenClaw 版本 openclaw version

确保版本 >= 2026.2.13 2. 准备企业微信 Bot 信息在企业微信管理后台创建 AI Bot，获取： Bot ID（必填） Secret（必填） ⚠️ 注意：请妥善保管 Secret，不要泄露给他人

📦 安装插件方式一：命令行安装 openclaw plugins install @wecom/wecom-openclaw-plugin

方式二：交互式配置（推荐） openclaw channels add

按提示输入 Bot ID 和 Secret 即可。

⚙️ 配置步骤方式一：CLI 快速配置

设置 Bot ID

openclaw config set channels.wecom.botId <YOUR_BOT_ID>

设置 Secret

openclaw config set channels.wecom.secret <YOUR_SECRET>

启用企业微信渠道

openclaw config set channels.wecom.enabled true

重启 Gateway 使配置生效

openclaw gateway restart

方式二：手动编辑配置文件编辑 ~/.openclaw/openclaw.json，在 channels 部分添加： { "channels": { "wecom": { "enabled": true, "connectionMode": "websocket", "botId": "<YOUR_BOT_ID>", "secret": "<YOUR_SECRET>", "streamPlaceholderContent": "正在思考...", "welcomeText": "你好！我是 AI 助手", "dm": { "policy": "open" } } } }

然后重启 Gateway： openclaw gateway restart

✅ 验证连接

查看 Gateway 日志

查看实时日志

tail -f ~/.openclaw/logs/openclaw.log

或查看最近 100 行

tail -100 ~/.openclaw/logs/openclaw.log

成功标志看到以下日志表示连接成功： ✅ WebSocket 连接建立 ✅ 认证成功 (Authentication successful) ✅ 心跳启动 (Heartbeat timer started, 30 秒间隔) ✅ 认证完成 (Authenticated)
测试消息在企业微信中：打开企业微信 APP 找到配置的智能机器人发送消息："你好" 确认收到回复

🔒 访问控制私聊访问策略（dmPolicy）

策略

说明

配置值

open

所有用户可私聊（默认）

"open"

pairing

需要配对码验证

"pairing"

allowlist

仅允许指定用户

"allowlist"

disabled

禁用所有私聊

"disabled" 群聊访问策略（groupPolicy）

策略

说明

配置值

open

所有群可访问（默认）

"open"

allowlist

仅允许指定群

"allowlist"

disabled

禁用所有群聊

"disabled" 配置示例允许所有用户私聊（推荐） { "channels": { "wecom": { "dmPolicy": "open" } } }

仅允许指定用户私聊 { "channels": { "wecom": { "dmPolicy": "allowlist", "allowFrom": ["user_id_1", "user_id_2"] } } }

仅允许指定群聊 { "channels": { "wecom": { "groupPolicy": "allowlist", "groupAllowFrom": ["group_id_1", "group_id_2"] } } }

配对管理

查看待配对的请求

openclaw pairing list wecom

批准配对请求

openclaw pairing approve wecom <配对码>

❓ 常见问题 Q1: 连接失败怎么办？检查步骤：确认 Bot ID 和 Secret 正确检查网络是否通畅查看 Gateway 日志确认错误信息重启 Gateway 重试 Q2: 收不到消息回复？可能原因：访问策略限制（检查 dmPolicy/groupPolicy）用户不在允许列表中 Gateway 未正常运行解决方法：

检查 Gateway 状态

openclaw gateway status

重启 Gateway

openclaw gateway restart

Q3: 如何更新插件？ openclaw plugins update wecom-openclaw-plugin

Q4: 如何禁用企业微信渠道？ openclaw config set channels.wecom.enabled false openclaw gateway restart

📚 相关资源企业微信官方文档 OpenClaw 官方文档完整接入指引文档

🆘 获取帮助如有问题，请：查看 Gateway 日志定位错误检查配置是否正确联系技术支持

本文档由 AI 助手自动生成，如有更新请以最新版本为准

📱 AiToMoney 虾主联盟入群二维码 QQ 群（群号：242249487）飞书群（仅限企业内部成员加入）微信群（二维码 7 天内有效） image.png

入群暗号：「我是一只虾，正在水里瞎折腾。」 Slogan：一个人可以走得很快，一群虾可以折腾得更远 🦞