1. 为什么要在阿里云上跑 OpenClaw 并接企业微信OpenClaw前身 Clawdbot是一个轻量级的 AI 任务自动化框架它能把你日常重复的办公动作——生成周报、整理表格、自动回复客户咨询——变成一句指令就能触发的工作流。而把它部署在阿里云 ECS 上再接入企业微信本质上是给团队装了一个“随叫随到的 AI 助理”员工在企业微信里发一句话OpenClaw 在云端跑完任务结果直接推回聊天窗口。这套组合适合谁一是没有专职运维、但想让团队用上 AI 自动化的小团队二是已经在用企业微信做内部协同、希望把 AI 能力嵌进现有办公流程的公司三是想自己掌控数据、不想把业务指令发到第三方 SaaS 的开发者。我实测下来从零到企业微信能收发消息核心工作量集中在三块ECS 环境准备、OpenClaw 容器部署、企业微信回调配置。其中最容易卡住的是回调 URL 验证和统一 Key 的配置方式——这也是本篇重点要讲清楚的部分。和旧版教程不同2026 年的 OpenClaw 在配置层做了收敛模型调用统一走config.toml企业微信连接器走settings.json两者解耦后排查问题会清晰很多。下面按“环境 → 部署 → Key 配置 → 企业微信接入 → 验证 → 排障”的顺序走一遍命令都可以直接复制。2. 前置准备阿里云 ECS 与 TaoToken 统一 Key2.1 ECS 实例规格与安全组先创建一台 ECS。地域选离团队办公地近的华东1、华南1 都行降低企业微信回调的往返延迟。规格上2 核 4G 是能跑起来的底线如果同时接多个群、任务并发高建议 4 核 8G。镜像用 CentOS 9.x 或 Ubuntu 22.04 都可以下面命令以 CentOS 9 为例。安全组需要放行这几个端口22SSH、80/443如果后面要上 HTTPS、3000OpenClaw 服务端口。企业微信的回调必须走公网可达地址所以 ECS 要分配公网 IP带宽 4Mbps 起步。登录服务器后先把基础环境铺好# 更新系统 yum update -y # 安装 Docker yum install -y yum-utils device-mapper-persistent-data lvm2 yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo yum install -y docker-ce docker-ce-cli containerd.io systemctl start docker systemctl enable docker # 安装 Docker Compose curl -L https://github.com/docker/compose/releases/download/v2.25.0/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose chmod x /usr/local/bin/docker-compose docker-compose --version2.2 为什么用 TaoToken 统一 KeyOpenClaw 本身不绑定某一家模型它通过一个统一的 API 入口去调用底层模型。TaoToken 在这里扮演的就是“统一 Key 网关”的角色你只需要在 TaoToken 控制台创建一个 API Key然后在 OpenClaw 的config.toml里填一次后面切换模型、调整参数都不用改代码。具体操作登录 TaoToken 控制台进入 API Keys 页面创建一个新 Key复制保存。这个 Key 就是后面config.toml里api_key字段的值。如果你还没决定用哪个模型可以先在模型对话页面测一下效果确认响应正常再写进配置。注意API Key 只显示一次创建后立刻保存到密码管理器或服务器环境变量里不要直接提交到 Git。3. 可复制配置config.toml 与 settings.json 骨架3.1 部署目录与 docker-compose.yml先建工作目录把容器编排文件写好mkdir -p /opt/openclaw cd /opt/openclaw tee docker-compose.yml -EOF version: 3.8 services: openclaw: image: openclaw/openclaw:2026-stable container_name: openclaw-core restart: unless-stopped ports: - 3000:3000 environment: - NODE_ENVproduction - PORT3000 - LOG_LEVELinfo volumes: - ./data:/app/data - ./config:/app/config networks: - openclaw-network networks: openclaw-network: driver: bridge EOF注意这里多挂了一个./config:/app/config因为 2026 版把模型配置和企业微信配置都放在这个目录下持久化后重启容器不会丢。3.2 config.toml模型与统一 Key在/opt/openclaw/config/下创建config.toml这是 OpenClaw 的主配置[server] port 3000 log_level info task_timeout 300 [model] provider taotoken api_base https://taotoken.net/api api_key 你的TaoToken_API_Key default_model claude-sonnet max_tokens 4096 temperature 0.7 [cache] enable true expire 3600 type localapi_base填 TaoToken 的 API 地址api_key填你在控制台创建的那串 Key。default_model可以按需改OpenClaw 会把请求转发到 TaoToken由它路由到对应模型。3.3 settings.json企业微信连接器同一个目录下创建settings.json专门管企业微信通道{ wework: { enabled: true, corpId: 你的企业ID, agentId: 你的应用AgentId, secret: 你的应用Secret, token: 回调Token, encodingAESKey: 回调EncodingAESKey, webhookPath: /wework/webhook, autoReply: true, allowedDepartments: [], adminUserIds: [] } }corpId在企业微信管理后台“我的企业 → 企业信息”里看agentId和secret在自建应用详情页。token和encodingAESKey是你在配置“接收消息服务器”时自己生成的两边必须完全一致。4. 启动服务与连通性验证4.1 拉起容器cd /opt/openclaw docker-compose up -d docker-compose logs -f openclaw日志里看到Server listening on port 3000且没有 ERROR就说明服务起来了。再本地探一下健康检查curl http://localhost:3000/health # 期望输出{status:ok}4.2 验证 TaoToken Key 是否生效这一步很关键很多人企业微信配好了但 AI 不回复其实是 Key 没通。用一条测试请求确认curl -X POST http://localhost:3000/api/chat \ -H Content-Type: application/json \ -d {message:你好测试一下连通性,model:claude-sonnet}如果返回一段正常的模型回复说明config.toml里的 TaoToken Key 配置正确。如果返回 401 或 403回到第 5 节排查。4.3 企业微信回调 URL 验证进入企业微信管理后台找到你创建的自建应用在“接收消息”里设置URLhttp://你的ECS公网IP:3000/wework/webhookToken与settings.json里的token一致EncodingAESKey与settings.json里的encodingAESKey一致加密方式兼容模式点“保存”时企业微信会向这个 URL 发一个验证请求OpenClaw 收到后自动解密并回显验证通过就说明回调链路通了。如果提示“回调失败”先确认 ECS 安全组放行了 3000 端口再用curl -I http://你的公网IP:3000/health从外网测一下可达性。5. 本篇常见错排查5.1 企业微信消息发出去没反应先分层排查。第一层看网络在 ECS 上执行curl -I https://qyapi.weixin.qq.com确认能访问企业微信接口。第二层看日志docker exec -it openclaw-core tail -f /app/data/logs/wework.log如果日志里出现invalid signature说明token或encodingAESKey对不上出现ip not in whitelist去企业微信后台把 ECS 公网 IP 加进“可信 IP”。5.2 config.toml 改了不生效OpenClaw 启动时读取一次配置改完config.toml必须重启容器docker-compose restart。另外注意 TOML 对缩进和引号敏感api_key值要用英文双引号包住别用中文引号。5.3 容器启动后立刻退出多半是端口占用或配置文件语法错误。先docker-compose logs openclaw看报错行如果是port 3000 already in use用lsof -i:3000找到占用进程处理掉如果是 TOML 解析错误把config.toml贴到在线 TOML 校验器里过一遍。5.4 企业微信 URL 验证一直失败除了端口和 IP 白名单还有一个容易忽略的点企业微信要求回调 URL 在 5 秒内响应。如果 ECS 到企业微信的网络抖动验证会超时。可以在settings.json里把webhookPath单独暴露一个轻量健康检查路由或者临时把 ECS 带宽升到 5Mbps 以上再试。6. 跑通之后把 Key 和通道管起来部署完成只是起点。日常运维里我建议把 TaoToken 的 Key 和 OpenClaw 的配置分开管理Key 放在服务器环境变量或 TaoToken 控制台轮换config.toml里只引用变量名这样换 Key 不用动配置文件。企业微信这边定期检查“可信 IP”列表ECS 换公网 IP 后记得同步更新。如果你后续要接更多模型或调整调用参数直接去 TaoToken 的模型对话页面试好效果再改config.toml里的default_model字段重启容器即可。需要长期跑编码类或 Agent 类任务的话可以了解下 Coding Plan 的额度方案比按次调用更划算。接入过程中遇到签名或回调问题接入文档里有各语言的验签示例对着改settings.json就行。
