本文将详细介绍如何将 OpenClaw（原 Moltbot、Clawdbot）与微信集成，实现通过微信收发消息，在聊天中直接与 OpenClaw 智能体进行自然语言交互。

---

一、接入方案选择：企业微信 vs 个人微信

在开始配置前，需要明确一点：OpenClaw 官方并未提供直接接入个人微信的原生通道。个人微信属于封闭生态，通过非官方协议接入存在极高的封号风险和维护成本。

目前最稳定、安全、官方支持的接入方式是企业微信方案。企业微信提供了标准的机器人 API 接口，OpenClaw 可以无缝对接，且完全合规，无封号风险。

方案对比

接入方案	稳定性	安全性	配置复杂度	适用场景
企业微信接入（推荐）	⭐⭐⭐⭐⭐	⭐⭐⭐⭐⭐	中等	团队协作、生产环境、长期稳定运行
个人微信极客方案	⭐⭐	⭐	极高	仅供技术尝鲜，不建议用于日常使用

重要提示：若您仍尝试通过开源协议库（如 WeChaty、ntwork）接入个人微信，请知悉：微信官方对模拟协议检测极其严格，轻则限制功能，重则永久封号。本文不提供存在安全风险的接入方式，仅聚焦企业微信官方方案。

二、准备工作

2.1 基础环境要求

• 轻量应用服务器：已部署 OpenClaw 服务，内存 ≥ 2GiB

• 企业微信账号：拥有企业管理员权限（如未创建企业，可免费注册一个测试企业）

• 阿里云百炼 API Key：推荐使用 Coding Plan 套餐，成本可控

2.2 服务器端口放行

企业微信回调需要访问 OpenClaw 服务，需确保以下端口已放行：

• 18789：OpenClaw 核心通信端口（默认）

• 80/443：如使用域名回调需放行（可选）

在轻量应用服务器控制台，进入实例详情页 → 防火墙，添加规则放行 18789 端口（协议：TCP）。

---

三、企业微信接入详细步骤

3.1 创建企业微信机器人

3.1.1 进入创建页面

1. 登录企业微信管理后台（需管理员权限）。

2. 左侧导航栏选择 安全与管理 → 管理工具。

3. 找到 智能机器人，点击进入。

4. 点击 创建机器人，滑至页面最底部，选择 API模式创建。

3.1.2 填写基本信息并获取凭证

在 API 模式创建页面，需要填写以下信息：

• 机器人名称：自定义（如 "我的AI助手"）

• 简介：机器人的功能描述

• 可见范围：选择可使用该机器人的部门或成员

关键配置项：

配置项	说明	操作
URL	企业微信回调地址，稍后配置	暂不填写
Token	用于验证请求来源的凭证	点击 随机获取，复制保存
EncodingAESKey	消息加密密钥	点击 随机获取，复制保存

重要：此时不要点击「创建」按钮！需要先完成 OpenClaw 侧的配置，否则会提示“服务没有正确响应”。

3.2 配置 OpenClaw 企业微信通道

3.2.1 进入 OpenClaw 应用管理

1. 登录轻量应用服务器控制台。

2. 找到部署了 OpenClaw 的实例，点击卡片进入实例详情。

3. 点击 应用详情 页签。

4. 在 通道配置 区域找到 企业微信（或 WeCom）配置项。

3.2.2 填入企业微信凭证

将上一步保存的 Token 和 EncodingAESKey 填入对应输入框，点击 应用，等待几十秒完成配置。

配置成功后，通道状态会显示为 运行中。

3.3 完成企业微信机器人创建

3.3.1 构造回调 URL

回到企业微信机器人创建页面，现在需要填写 URL。URL 格式为：

http://<服务器公网IP>:18789/wecom/bot

或使用域名（需备案且主体一致）：

http://<您的域名>:18789/wecom/bot

注意：

• 必须使用 http 而非 https

• 端口号默认为 18789（如修改过请使用实际端口）

• 路径为 /wecom/bot

3.3.2 验证并创建

1. 将构造好的 URL 填入 URL 输入框。

2. Token 和 EncodingAESKey 保持之前随机获取的值（不要修改）。

3. 点击 创建 按钮。

如配置正确，机器人将创建成功。

常见报错处理：

• “域名主体校验未通过”：表示您填写的域名备案主体与企业微信认证企业不一致。解决方案：① 使用公网 IP 地址代替域名（简单但可能后续变更）；② 配置一个备案主体一致的企业自有域名。

• “服务没有正确响应”：检查服务器防火墙是否放行 18789 端口，以及 OpenClaw 通道配置是否正确。

3.4 添加机器人到企业微信

1. 创建成功后，进入机器人详情页。

2. 点击右上角 “...” 按钮，选择 获取机器人二维码。

3. 使用企业微信 App 扫码，即可将机器人添加到您的企业通讯录中。

4. 在 App 中搜索机器人名称，打开单聊会话，即可开始与 OpenClaw 对话。

3.5 测试验证

向机器人发送任意消息（如“你好”），如果机器人能够正常回复，则说明接入成功。

注意：首次对话可能需要建立会话，响应时间稍长，请耐心等待。

---

四、进阶配置与常见问题

4.1 如何在群聊中使用机器人？

1. 在企业微信中创建一个群聊。

2. 点击群设置 → 添加成员 → 搜索机器人名称并添加。

3. 在群中 @机器人 发送消息，即可与 OpenClaw 交互。

4.2 如何更改 OpenClaw 调用的模型？

1. 进入 OpenClaw WebUI（获取方式：应用详情 → 访问 WebUI 面板 → 获取地址）。

2. 点击右上角 Config → Agents。alibaba-cloud/模型Code

3. 例如：alibaba-cloud/qwen3-max-2026-01-23-5

模型 Code 可在百炼模型广场查询。

4.3 如何配置定时任务推送到企业微信群？

可以通过与 OpenClaw 对话创建定时任务：

1. 获取群机器人 Webhook 地址（注意：这是群机器人，不是刚才创建的应用机器人）：

   • 在企业微信群中点击 群设置 → 群机器人 → 添加机器人。

   • 选择 自定义机器人，填写名称，复制 Webhook 地址。每天早上 9 点查询实时天气，并发送到 Webhook：https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxxxxx

2. 测试与修改：

   • 可让 Agent 立即执行一次验证。

   • 如需修改或取消，直接对话中告知 Agent 即可。

4.4 常见问题排查

Q1：机器人没有回复，如何排查？

执行以下命令查看 timbot 插件（或 wecom 通道）的日志：

openclaw gateway stop && openclaw gateway --verbose | grep --line-buffered -i 'wecom'

观察是否有收到 webhook 请求的记录。

Q2：如何查看 OpenClaw 的端口号？

登录服务器，执行：

openclaw config get gateway.port

默认值为 18789。

Q3：企业微信机器人提示“服务异常”

1. 检查服务器防火墙是否放行 18789 端口。

2. 确认 OpenClaw 服务状态：sudo systemctl status openclaw。

3. 检查通道配置是否正确应用（应用详情中通道状态应为“运行中”）。

Q4：配置时报“域名主体校验未通过”

该问题由企业微信的安全限制引起，解决方案：

1. 简单方案：使用公网 IP 地址构造 URL（适用于测试环境）。

2. 标准方案：配置一个已备案且主体一致的企业自有域名：

   • 在域名服务商处添加二级域名解析（如 ai.yourcompany.com）指向服务器 IP。

   • 使用该域名构造 URL：http://ai.yourcompany.com:18789/wecom/bot。

---

五、总结

通过企业微信接入 OpenClaw 是目前最稳定、安全的微信集成方案。整个过程可概括为三步：

1. 创建企业微信机器人：获取 Token 和 EncodingAESKey（暂不创建）。

2. 配置 OpenClaw 通道：填入凭证，放通端口。

3. 完成创建并添加机器人：填写回调 URL，保存后扫码使用。

接入成功后，您就可以在企业微信中像使用普通联系人一样，随时向 OpenClaw 发送指令、查询信息、执行任务，让 AI 助手真正融入日常办公沟通流。