文档说明：本文档适用于通过1Panel面板部署OpenClaw，并完成企业微信渠道对接（支持企业微信机器人、企业自建应用两种方式），实现AI对话自动应答。

一、环境准备

服务器要求

操作系统：CentOS 7.x+、Ubuntu 20.04+、Debian 11+（任选其一）
配置要求：推荐4核4GB内存（确保OpenClaw及依赖服务稳定运行）
网络要求：具备公网IP，开放80、443、18789（OpenClaw WebUI端口）、3000（企业微信回调端口）

二、企业微信后台配置

创建企业微信机器人

登录企业微信管理后台（地址：https://work.weixin.qq.com/），使用企业管理员账号登录；
左侧导航栏依次点击：「安全与管理」→「管理工具」→「智能机器人」；
点击「创建机器人」，选择「API模式创建」，填写基础信息：
1. 机器人名称：如「OpenClaw智能助手」（可自定义）；
2. 简介：填写机器人功能，如「AI智能对话助手，快速响应咨询」；
3. 可见范围：选择可使用该机器人的部门或成员（确保测试账号在范围内）。
点击「随机获取」，生成Token和EncodingAESKey，务必妥善保存（后续对接需用到）；
填写「URL回调地址」：http://服务器IP:3000/wecom（替换为你的服务器公网IP），点击「保存」；
保存后，机器人创建完成，记录BotId（机器人ID，在机器人详情页查看）。

三、OpenClaw对接企业微信配置

3.1 安装企业微信插件

OpenClaw需安装企业微信插件，才能实现与企业微信的对接：

在智能体页面点击OpenClaw配置，选中企业微信，点击安装即可。

3.2 配置企业微信参数

1.在智能体页面，点击OpenClaw配置，选择企业微信频道。

2.填入之前获取的Bot ID 和密钥。

3.配置完成后点击保存，然后到企业微信里向你创建的机器人随意发一条信息，它会返回配对码，然后将配对码填写至配置页面，即可完成对接并开始对话。

四、对接验证与使用

4.1 验证回调连通性

登录企业微信管理后台，进入之前创建的机器人/自建应用详情页；
找到「回调配置」或「API接收消息」页面，点击「测试回调」按钮；
若提示「回调测试成功」，则说明OpenClaw与企业微信的回调连通正常；
若测试失败，排查以下问题：
1. 服务器3000端口是否开放（防火墙、安全组需放行）；
2. 回调URL、Token、EncodingAESKey是否与OpenClaw配置一致；
3. 查看OpenClaw日志（1Panel中openclaw应用→「日志」），排查错误信息。

4.2 测试对话功能

打开企业微信移动端（或PC端），进入「工作台」；
找到之前创建的OpenClaw机器人，点击进入对话窗口；
发送任意消息（如「你好」「介绍一下自己」），若OpenClaw能自动回复，则对接成功。

五、常见问题排查

问题1：企业微信收不到OpenClaw的回复

排查OpenClaw容器是否正常运行（1Panel中查看应用状态为「运行中」）；
检查模型API Key是否有效（可在OpenClaw WebUI中发送消息测试，若无法回复，说明API Key异常）；
确认企业微信机器人/应用的「可见范围」，确保测试账号在范围内；
重启OpenClaw服务和企业微信应用，重新测试。

问题2：企业微信回调地址验证失败

检查服务器防火墙、安全组，确保3000端口已开放（公网可访问）；
确认回调URL格式正确：http://服务器IP:3000/wecom，无多余空格、字符；
重新在企业微信后台生成Token和EncodingAESKey，同步更新到OpenClaw配置中，重启服务后再测试。

问题3：企业微信插件安装失败

检查服务器网络，确保能正常访问npm源（可执行ping npmjs.com测试）；
手动执行openclaw plugins install @openclaw-china/wecom-app，查看终端输出的错误日志，针对性排查；
升级OpenClaw到最新版本（1Panel中openclaw应用→「升级」），再重新安装插件。

问题4：OpenClaw WebUI无法访问

检查OpenClaw容器是否正常运行，18789端口是否开放；
确认访问地址格式正确：http://服务器IP:18789?token=你的Token（Token未填写或填写错误）；
查看OpenClaw日志，排查服务启动失败原因。

六、安全建议

企业微信的CorpID、Secret、Token、EncodingAESKey属于敏感信息，严禁泄露，配置文件（openclaw.json）权限设置为600（仅管理员可读写）；
服务器开启防火墙，仅放行必要端口（80、443、18789、3000），禁用公网直接访问PostgreSQL、Redis数据库；
定期更新1Panel、OpenClaw及依赖服务（PostgreSQL、Redis）的版本，修复安全漏洞；
定期备份OpenClaw配置文件和数据库，防止配置丢失或数据损坏。

七、补充说明

1. 若服务器已配置域名并备案，可将回调URL中的IP替换为域名（如http://xxx.com:3000/wecom），提升稳定性；

2. OpenClaw支持多渠道对接，除企业微信外，还可对接钉钉、飞书等，可在WebUI「Channels」中配置；

3. 若需调整OpenClaw的对话参数（如响应速度、上下文长度），可在WebUI「Settings」中配置。

OpenClaw对接企业微信渠道