用 OpenClaw 搭建企业微信 AI Agent:从零到自动化客服只需 30 分钟
本教程将指导您使用 OpenClaw 搭建一个企业微信 AI 客服,实现 7×24 小时自动回复。以阿里云为例,其他云服务商(如腾讯云)的流程也基本一致。
🎯 整体流程概览
- 准备账号:注册企业微信,并获取阿里云百炼大模型 API Key。
- 部署 OpenClaw:在云服务器上部署 OpenClaw 并接入大模型。
- 配置企业微信:创建应用或机器人,获取 CorpID、AgentID、Secret 等凭证。
- 打通连接:将企业微信的回调地址指向 OpenClaw 服务。
- 测试优化:在微信中测试对话,并通过优化知识库提升准确率。
🛠️ 一、准备工作 (约 5 分钟)
- 企业微信
- 注册并认证企业微信(个人也可免费创建用于测试)。
- 记录管理员账号,后续操作均需在管理后台进行。
- 阿里云账号
- 注册并完成实名认证。
- 开通「百炼大模型」服务,并创建一个 API Key,保存备用。
- 云服务器
- 推荐配置:2核CPU、2GB内存及以上,系统盘40GB+。
- 镜像选择:在轻量应用服务器中,搜索并选择 OpenClaw (原 Clawdbot/Moltbot) 官方镜像。
- 地域建议:选择中国香港、新加坡等免备案地域,方便外网访问。
- 安全组:创建实例后,在安全组规则中放行 TCP 18789 端口。
🚀 二、部署 OpenClaw (约 10 分钟)
方式一:使用官方镜像(推荐)
- 登录服务器通过 SSH 工具(如 FinalShell)连接到您的云服务器。
- 配置环境变量执行以下命令,编辑配置文件:bashcd /opt/openclawcp .env.example .envvim .env在
.env文件中填入以下内容(API Key 替换为您的百炼 Key):envALIYUN_BAILIAN_API_KEY=你的百炼APIKeyALIYUN_BAILIAN_MODEL=qwen3-maxPORT=18789
启动服务执行以下命令启动 OpenClaw:bash
安装依赖
npm install --production
后台启动
nohup npm run start > openclaw.log 2>&1 &检查服务是否正常运行:bashcurl http://127.0.0.1:18789/health若返回 {"status":"ok"},则表示部署成功。
方式二:Docker 部署(生产推荐)
bash
docker run -d \
--name openclaw \
-p 18789:18789 \
-e ALIYUN_BAILIAN_API_KEY=你的APIKey \
-e ALIYUN_BAILIAN_MODEL=qwen3-max \
--restart always \
openclaw/openclaw:2026-stable
🏢 三、配置企业微信
方案 A:自建应用 (功能更全)
- 创建应用登录企业微信管理后台 → 应用管理 → 自建应用 → 创建应用。填写名称(如“AI 客服中心”)、上传头像并设置可见范围。
- 获取凭证在应用详情页,记录以下三个关键信息:
- CorpID (企业 ID):位于「我的企业 → 企业信息」。
- AgentID (应用 ID)
- Secret (应用密钥):点击“查看”后,在企业微信客户端中复制。
- 设置回调进入应用详情 → 接收消息 → 设置 API 接收。
- URL:
http://你的服务器公网IP:18789/wecom/app - 点击“随机获取” Token 和 EncodingAESKey,并保存。
- URL:
方案 B:智能机器人 (配置简单)
- 创建机器人登录企业微信管理后台 → 安全与管理 → 管理工具 → 智能机器人 → 创建机器人 → API 模式创建。
- 获取凭证填写机器人名称、简介和可见范围。点击“随机获取” Token 和 EncodingAESKey,并保存。
- 设置回调
- URL:
http://你的服务器公网IP:18789/wecom/bot - 同样,先不要点击“创建”。
- URL:
🔗 四、打通 OpenClaw 与企业微信
方式一:命令行配置(推荐)
- 安装插件bashopenclaw plugin install @openclaw/channel-wecom
- 配置参数根据您选择的方案,执行相应命令。
- 自建应用配置bashopenclaw config set wecom.enabled trueopenclaw config set wecom.corpId 你的CorpIDopenclaw config set wecom.agentId 你的AgentIDopenclaw config set wecom.secret 你的Secretopenclaw config set wecom.token 你的Tokenopenclaw config set wecom.encodingAESKey 你的EncodingAESKey
- 智能机器人配置bashopenclaw config set wecom.enabled trueopenclaw config set wecom.botToken 你的Tokenopenclaw config set wecom.botEncodingAESKey 你的EncodingAESKey
- 重启服务bashopenclaw gateway restart
方式二:Web 控制台配置
- 访问
http://你的服务器IP:18789/admin。 - 进入 Channels → 企业微信。
- 根据您选择的方案,填入对应的 CorpID、AgentID、Secret、Token、EncodingAESKey 等信息。
- 启用通道并保存,然后重启网关服务。
✅ 五、测试与优化
- 完成配置返回企业微信后台,点击之前未完成的“保存”或“创建”按钮。如果提示“已成功”,则表示打通成功。
- 开始对话
- 自建应用:在企业微信客户端「工作台」找到并打开“AI 客服中心”应用。
- 智能机器人:在「通讯录」中找到机器人并进入聊天窗口。发送消息如“你好”、“你们支持退款吗?”,测试 AI 是否回复。
- 优化知识库如果 AI 回答不准确,可以创建知识库文件(如
faq.md),放入常见问题与标准答案,然后同步到 OpenClaw。AI 将优先从知识库中检索答案,大幅提升准确率。 - 设置人工兜底在知识库或系统提示词(SOUL.md)中设定,当 AI 无法回答或用户明确要求人工时,回复“正在为您转接人工客服,请稍候…”,并通知人工客服介入。