1. 为什么零基础也要把 OpenClaw 接进微信小程序OpenClaw社区里也常被叫 Clawdbot本质是一个可自托管的 AI 助手服务它能接收消息、调用大模型、再把结果回传。很多人第一次接触它是冲着「在微信里直接跟自己的 AI 助手对话」这个场景来的。但真正动手时卡点往往不在 OpenClaw 本身而在两件事一是服务器上 Docker 环境怎么配二是多个 AI 工具的 Key 分散在各处、根本管不过来。这篇就按「零技术、零基础」的路线走一遍在阿里云 ECS 上用 Docker 部署 OpenClaw用 TaoToken 统一管理模型 Key最后把微信小程序侧的接口联调跑通形成「小程序发消息 → OpenClaw 处理 → 结果回传」的闭环。适合谁适合没写过几行后端代码、但愿意照着命令敲、想拥有一个自己可控 AI 入口的人。全程我会把配置骨架和验证动作都给全你复制改改就能用。需要提前说明微信小程序调用外部服务必须走已备案域名 HTTPS这是平台规则不是本文能绕过的。所以下面的链路里我会用 Nginx 做一层反向代理把 OpenClaw 的 HTTP 服务包成 HTTPS小程序才能合法请求。2. 前置准备TaoToken 统一 Key 与阿里云环境2.1 为什么用 TaoToken 统一 KeyOpenClaw 支持配置多个模型提供方。如果你同时用几家模型Key 就会散落在不同文件里改一次要翻半天。TaoToken 的思路是给你一个统一入口把模型调用收敛到一套 Key 上OpenClaw 里只认这一个地址和这一把 Key后面换模型、加模型都在 TaoToken 侧调整容器里的配置不用动。对零基础用户来说这能省掉大量「这个 Key 填哪、那个 Key 又填哪」的混乱。你需要先去控制台创建一把 API Key地址是 https://taotoken.net/api-keys 创建后复制保存后面 config.toml 里要用。想先看看模型对话效果可以打开 https://taotoken.net/model-chat 试几句确认 Key 能用再往下走。接口文档在 https://taotoken.net/doc 遇到参数不确定时对照查。2.2 阿里云 ECS 基础环境登录阿里云控制台创建一台 ECS配置不用太高2 核 4G、CentOS 9.x 或 Ubuntu 22.04 都行系统盘 40G 起步分配公网 IP。安全组里放行 22SSH、80、443 三个端口OpenClaw 的 3000 端口不要直接对公网开放我们通过 Nginx 转发。创建完成后用 SSH 登录先装 Docker 和 Docker Compose# 更新系统 sudo yum update -y # 安装 Docker sudo yum install -y yum-utils sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo sudo yum install -y docker-ce docker-ce-cli containerd.io # 启动并设置开机自启 sudo systemctl start docker sudo systemctl enable docker # 验证 docker --versionDocker Compose 现在推荐用插件形式安装sudo yum install -y docker-compose-plugin docker compose version看到版本号输出就说明环境就绪。如果你用的是 Ubuntu把 yum 换成 apt 即可命令结构一致。3. 可复制配置config.toml 骨架与 Docker Compose3.1 OpenClaw 的 config.toml 骨架先在服务器上建工作目录mkdir -p /opt/openclaw cd /opt/openclaw创建config.toml这是 OpenClaw 的核心配置。下面这份骨架把模型调用统一指向 TaoToken你只需要替换 Key# /opt/openclaw/config.toml [server] host 0.0.0.0 port 3000 log_level info [model] # 统一走 TaoToken换模型只改这里 provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model gpt-4o-mini timeout 300 [wechat] # 微信小程序侧校验用自定义一串足够长的随机字符 verify_token 换成你自己的随机字符串 # 消息加密密钥小程序后台配置需保持一致 encoding_aes_key 换成43位随机字符串 [storage] data_dir /app/data这里有几个点要注意。base_url填https://taotoken.net/api不要带多余路径api_key就是你在控制台创建的那把model可以先填一个通用模型后面在 TaoToken 侧切换即可。verify_token和encoding_aes_key是给微信小程序消息校验用的自己生成、记牢两边必须一致。3.2 Docker Compose 配置片段在同目录创建docker-compose.ymlversion: 3.8 services: openclaw: image: openclaw/openclaw:latest container_name: openclaw-core restart: unless-stopped ports: - 127.0.0.1:3000:3000 volumes: - ./config.toml:/app/config.toml - ./data:/app/data environment: - NODE_ENVproduction - LOG_LEVELinfo networks: - openclaw-net networks: openclaw-net: driver: bridge注意端口映射写的是127.0.0.1:3000:3000意思是只允许本机访问 3000公网进不来安全得多。启动docker compose up -d docker compose logs -f日志里没有 ERROR、出现服务监听 3000 的提示就说明容器起来了。3.3 Nginx 反向代理 HTTPS小程序要求 HTTPS所以用 Nginx 把 443 转到本机 3000。先装 Nginxsudo yum install -y nginx sudo systemctl start nginx sudo systemctl enable nginx准备证书可以用阿里云免费证书下载后上传到服务器然后配置# /etc/nginx/conf.d/openclaw.conf server { listen 443 ssl; server_name your-domain.com; ssl_certificate /etc/nginx/ssl/your-cert.pem; ssl_certificate_key /etc/nginx/ssl/your-key.key; location / { proxy_pass http://127.0.0.1:3000; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } }重载 Nginxsudo nginx -t sudo systemctl reload nginx到这里https://your-domain.com就能访问到 OpenClaw 了。4. 验证请求从容器健康检查到小程序消息收发4.1 服务健康检查先在服务器本地验证 OpenClaw 是否正常curl http://127.0.0.1:3000/health返回类似{status:ok}就说明服务活着。再验证外网 HTTPScurl https://your-domain.com/health如果这一步失败多半是 Nginx 配置或证书问题回到上一节检查。4.2 验证模型调用链路在服务器上直接向 OpenClaw 发一条测试消息确认它能通过 TaoToken 调通模型curl -X POST https://your-domain.com/api/chat \ -H Content-Type: application/json \ -d {message:你好请回复一句话}如果返回里有模型生成的文本说明 config.toml 里的 TaoToken 配置生效了。这一步是整个链路的关键模型不通后面小程序再对也没用。4.3 微信小程序侧接口联调在小程序后台「开发管理 → 开发设置 → 服务器域名」里把https://your-domain.com加入 request 合法域名。然后在小程序代码里发起请求// pages/index/index.js Page({ data: { reply: }, sendMessage() { wx.request({ url: https://your-domain.com/api/chat, method: POST, header: { Content-Type: application/json }, data: { message: 帮我写一句产品介绍 }, success: (res) { this.setData({ reply: res.data.reply }); }, fail: (err) { console.error(请求失败, err); } }); } });如果小程序后台配置了消息推送还需要在 OpenClaw 侧实现校验接口把verify_token和encoding_aes_key对上。校验通过后用户在微信里发的消息会推到你的服务器OpenClaw 处理后回传形成完整闭环。4.4 成功结果长什么样联调通过后你在小程序里点一下按钮几秒内就能看到模型返回的文本在微信对话里发消息也能收到 AI 回复。服务器上docker compose logs -f会实时打印请求日志能看到每条消息的进出记录。到这一步从容器启动到小程序消息收发的闭环就跑通了。5. 本篇常见错排查5.1 容器启动后立刻退出先看日志docker compose logs openclaw常见原因是 config.toml 格式错误比如 TOML 里字符串没加引号、缩进用了 Tab。TOML 对格式敏感建议用python -c import tomllib; tomllib.load(open(config.toml,rb))校验一下。5.2 模型调用返回 401 或 403说明 TaoToken 的 Key 有问题。检查 config.toml 里api_key是否复制完整、有没有多余空格确认base_url是https://taotoken.net/api。如果还不行去控制台重新生成一把 Key 再试。5.3 小程序请求被拒报「不在以下 request 合法域名列表中」就是小程序后台没加域名或者域名没备案、证书无效。HTTPS 证书必须是受信任的 CA 签发自签证书小程序不认。5.4 Nginx 502 Bad Gateway说明 Nginx 连不上本机 3000。先确认容器在跑docker compose ps再确认端口映射是127.0.0.1:3000:3000最后看 Nginx 的proxy_pass地址对不对。三者一致基本就能解决。5.5 消息能发出去但收不到回复多半是微信侧的消息校验没通过。检查verify_token和encoding_aes_key是否与小程序后台完全一致注意大小写和长度。校验接口返回的 echostr 必须原样返回否则微信会判定失败。6. 后续怎么用把 Key 管理和编码任务都收进来链路跑通之后你会发现真正省心的地方在于 Key 统一了。以后想换模型不用动服务器上的 config.toml直接在 TaoToken 侧调整就行。如果你后面要长期做编码类任务、跑 Agent 流程可以看看 Coding Plan地址是 https://taotoken.net/coding-plan 它更适合持续性的开发场景。日常想快速验证某个模型效果用模型对话页 https://taotoken.net/model-chat 就够了。接入过程中遇到参数或报错对照接入文档 https://taotoken.net/doc 查基本都能定位。最后留一个我踩过的坑第一次部署时我把 3000 端口直接开在公网安全组里结果被扫描到、日志里一堆异常请求。后来改成只监听 127.0.0.1、统一走 Nginx世界就清净了。你如果也打算长期跑这一步别省。
