打造你的家庭 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	点击「随机生成」按钮

💡 建议选择「兼容模式」作为加密方式，更容易配置。

第二步：安装企业微信插件

在终端执行以下命令：

bash 复制代码

openclaw plugins install @openclaw/wecom@latest

等待 1-2 分钟，插件会自动下载安装。

⚠️ 安装过程需要一些时间，小内存机器请耐心等待

第三步：配置企业微信

方式一：命令行配置

bash 复制代码

openclaw channels add --channel wechat --token "你的AgentId:你的Secret"

方式二：手动编辑

编辑 ~/.openclaw/openclaw.json：

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
点击「测试连接」
提示成功后保存配置
开启「自动回复」和「群消息监听」

第四步：启动服务

bash 复制代码

# 重启网关（后台运行）
openclaw gateway restart

# 或前台运行查看日志
openclaw gateway --port 18789 --verbose

第五步：测试连接

在企业微信中找到你创建的应用
向应用发送测试消息，例如：「你好，帮我生成一段代码」
观察是否收到 AI 的回复
查看 OpenClaw 日志确认消息已收到：
bash 复制代码
```
docker-compose logs openclaw
```

功能特性

功能	支持情况
C2C 私聊	✅ 支持
群聊 @消息	✅ 支持
图片收发	✅ 支持
文件发送	✅ 支持
Markdown 格式	✅ 支持
定时推送	✅ 支持

常见问题

Q：收不到消息怎么办？

检查服务器 IP 是否已加入可信 IP 白名单
确认 IP 是否发生变化
检查 OpenClaw 网关是否正常运行
查看日志是否有报错

Q：提示 URL 校验失败？

确保 OpenClaw 服务已启动
检查 URL 配置是否正确（特别是 IP 和端口）
确认 Token 和 EncodingAESKey 配置一致

Q：IP 频繁变更怎么办？

方案一：使用云服务器（推荐，最省心）
方案二：使用动态 DNS + 脚本自动更新可信 IP
方案三：改用飞书（不需要可信 IP）

Q：如何升级插件？

bash 复制代码

npx -y @openclaw/wecom@latest upgrade

总结

企业微信接入 OpenClaw 本身并不复杂，但可信 IP 的配置是最大的限制因素。

如果你有云服务器（固定 IP），配置好可信 IP 后基本可以稳定使用。但如果你只有家用宽带，建议：

使用飞书方案（不需要可信 IP）
或者升级到云服务器部署

省心的选择：

方案	推荐程度	说明
云服务器 + 企业微信	✅ 推荐	稳定，有固定 IP
家用宽带 + 企业微信	⚠️ 需处理	IP 变化导致配置麻烦
飞书	✅ 推荐	不需要可信 IP，最省心

系列文章：

打造你的家庭 AI 助手（一）：OpenClaw 安装与配置
打造你的家庭 AI 助手（二）：飞书机器人接入你的 OpenClaw
打造你的家庭 AI 助手（三）：QQ 机器人接入你的 OpenClaw
打造你的家庭 AI 助手（四）：企业微信 AI 助手接入你的 OpenClaw（本文）