打造你的家庭 AI 助手（四）：企业微信 AI 助手接入你的 OpenClaw
打造你的家庭 AI 助手（四）：企业微信 AI 助手接入你的 OpenClaw
⚠️ 重要提示：企业微信同样需要配置可信 IP，如果你的服务器没有固定公网 IP，在家中部署可能会遇到网络通信问题。建议使用云服务器或有固定 IP 的环境部署。
前言
在完成 OpenClaw 安装后，我们已经介绍了飞书和 QQ 机器人的接入方式。本文将介绍如何通过企业微信来控制你的 AI 助手。
但在此之前，有一个重要提醒：企业微信也需要配置可信 IP，如果你使用的是动态 IP（家用宽带），可能会遇到回调失败的问题。
⚠️ 关于可信 IP 的说明
企业微信的服务器回调机制要求配置可信 IP：
- 云服务器（固定 IP）✅ 推荐
- 家用宽带（动态 IP）⚠️ 需要额外处理
如果你的服务器 IP 会频繁变化，需要：
- 使用动态 DNS 服务
- 编写脚本自动更新可信 IP
- 或者直接使用云服务器（更省心）
💡 建议：如果是家用宽带且没有固定 IP，建议直接使用飞书方案，省去配置麻烦。
第一步：准备工作
1.1 访问企业微信管理后台
打开浏览器，访问：企业微信管理后台
使用企业微信扫码登录。
1.2 创建应用
进入「应用管理」→「创建应用」：
| 项目 | 填写内容 |
|---|---|
| 应用名称 | OpenClaw-AI助手（或你喜欢的名字） |
| 应用描述 | 我的家庭 AI 助手 |
| 应用 logo | 上传一个图标（可选） |
| 应用可见范围 | 全公司或指定部门 |
1.3 获取凭证信息
创建成功后，在应用页面找到以下信息并记录：
| 凭证 | 位置 | 说明 |
|---|---|---|
| 企业 ID | 「我的企业」→「企业信息」 | 类似 ww1234567890abcdef |
| AgentId | 应用详情页 | 应用 ID |
| Secret | 应用详情页 | 应用密钥 |
1.4 配置应用权限
进入「权限管理」→「接口权限」，开启：
- ✅ 消息推送
- ✅ 接收消息
- ✅ 发送消息
1.5 配置可信 IP（关键步骤）
⚠️ 这一步很重要，IP 不在白名单中会导致消息收发失败
在应用设置中，找到「API 接收消息」或「服务器配置」：
- 添加你的服务器公网 IP
- 如果使用云服务器，确保安全组已开放相应端口
💡 如果你的 IP 会变化，每次变更后都需要更新可信 IP。
1.6 配置消息接收服务器
在「API 接收消息」部分点击「设置」：
| 配置项 | 说明 |
|---|---|
| URL | http://你的服务器IP:3000/wework/webhook |
| Token | 随机填一个字符串（后续配置需要） |
| EncodingAESKey | 点击「随机生成」按钮 |
💡 建议选择「兼容模式」作为加密方式，更容易配置。
第二步：安装企业微信插件
在终端执行以下命令：
openclaw plugins install @openclaw/wecom@latest 等待 1-2 分钟，插件会自动下载安装。
⚠️ 安装过程需要一些时间，小内存机器请耐心等待
第三步：配置企业微信
方式一：命令行配置
openclaw channels add --channel wechat --token "你的AgentId:你的Secret"方式二：手动编辑
编辑 ~/.openclaw/openclaw.json：
{"channels":{"wechat":{"enabled":true,"agentId":"你的AgentId","secret":"你的Secret","corpId":"你的企业ID","token":"你设置的Token","encodingAESKey":"你的EncodingAESKey","webhookUrl":"http://你的服务器IP:3000/wework/webhook"}}}方式三：可视化配置（新手友好）
如果不喜欢命令行，可以通过管理后台配置：
- 进入「集成中心」→「企业微信配置」
- 依次填入：
- 企业 ID
- 应用 ID (AgentId)
- 应用密钥 (Secret)
- Token
- EncodingAESKey
- 点击「测试连接」
- 提示成功后保存配置
- 开启「自动回复」和「群消息监听」
第四步：启动服务
# 重启网关（后台运行） openclaw gateway restart # 或前台运行查看日志 openclaw gateway --port 18789 --verbose 第五步：测试连接
- 在企业微信中找到你创建的应用
- 向应用发送测试消息，例如：「你好，帮我生成一段代码」
- 观察是否收到 AI 的回复
查看 OpenClaw 日志确认消息已收到：
docker-compose logs openclaw 功能特性
| 功能 | 支持情况 |
|---|---|
| C2C 私聊 | ✅ 支持 |
| 群聊 @消息 | ✅ 支持 |
| 图片收发 | ✅ 支持 |
| 文件发送 | ✅ 支持 |
| Markdown 格式 | ✅ 支持 |
| 定时推送 | ✅ 支持 |
常见问题
Q：收不到消息怎么办？
- 检查服务器 IP 是否已加入可信 IP 白名单
- 确认 IP 是否发生变化
- 检查 OpenClaw 网关是否正常运行
- 查看日志是否有报错
Q：提示 URL 校验失败？
- 确保 OpenClaw 服务已启动
- 检查 URL 配置是否正确（特别是 IP 和端口）
- 确认 Token 和 EncodingAESKey 配置一致
Q：IP 频繁变更怎么办？
- 方案一：使用云服务器（推荐，最省心）
- 方案二：使用动态 DNS + 脚本自动更新可信 IP
- 方案三：改用飞书（不需要可信 IP）
Q：如何升级插件？
npx -y @openclaw/wecom@latest upgrade 总结
企业微信接入 OpenClaw 本身并不复杂，但可信 IP 的配置是最大的限制因素。
如果你有云服务器（固定 IP），配置好可信 IP 后基本可以稳定使用。但如果你只有家用宽带，建议：
- 使用飞书方案（不需要可信 IP）
- 或者升级到云服务器部署
省心的选择：
| 方案 | 推荐程度 | 说明 |
|---|---|---|
| 云服务器 + 企业微信 | ✅ 推荐 | 稳定，有固定 IP |
| 家用宽带 + 企业微信 | ⚠️ 需处理 | IP 变化导致配置麻烦 |
| 飞书 | ✅ 推荐 | 不需要可信 IP，最省心 |
系列文章：
- 打造你的家庭 AI 助手（一）：OpenClaw 安装与配置
- 打造你的家庭 AI 助手（二）：飞书机器人接入你的 OpenClaw
- 打造你的家庭 AI 助手（三）：QQ 机器人接入你的 OpenClaw
- 打造你的家庭 AI 助手（四）：企业微信 AI 助手接入你的 OpenClaw（本文）
