1. 为什么要在阿里云 ECS 上跑 OpenClawOpenClaw老名字 Clawdbot是一个可以自己部署的 AI 智能体框架能通过自然语言直接操作文件、检索信息、处理内容、跑自动化流程还带记忆和 Skills 插件扩展。它依赖 Node.js 运行既能放在云服务器上长期在线也能在本地离线跑数据默认落在自己机器上可控性比纯 SaaS 强不少。适合谁想给自己搭一个随时在线的私人助理、又不想把数据全交给第三方的人或者手上有一台阿里云 ECS想拿它当 7×24 小时的 Agent 宿主。场景很直接一台 2 核 2G 的 ECS装好 Node.js 22把 OpenClaw 网关跑起来再通过 TaoToken 的统一 Key 把模型通道接上浏览器打开 Web 控制台就能对话。这篇聚焦的是「阿里云 ECS TaoToken 统一 Key」这条链路目标 4 分钟跑通对话。我会把 config.toml 骨架、环境变量、启动命令、连通性验证和几个高频报错都摊开写命令可以直接复制。模型接入这块用 TaoToken 的 API 通道一个 Key 走多个模型省得在配置文件里来回换 base_url。2. 前置准备TaoToken 统一 Key 与 ECS 环境先说 TaoToken 这边。它的作用是给你一个统一的 API 入口和 KeyOpenClaw 里配置一次后面换模型只改 model 字段不用动鉴权。你需要先去官网注册账号然后到控制台生成 API Key。具体入口官网注册与总览https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content控制台生成 Keyhttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Keys 管理页https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewriteAPI 的基础地址是https://taotoken.net/api注意这个地址后面不加任何查询参数配置里直接写它就行。Key 生成后复制保存好后面写进环境变量。ECS 这边实例规格建议 2 核 2G 起步系统盘 40G 以上系统用 Alibaba Cloud Linux 3 或 Ubuntu 22.04 都行。安全组要放行两个端口一个是 OpenClaw 网关端口下面用 18789一个是 SSH 的 22。登录方式用 Web 终端或本地 SSH 工具都可以。注意内存低于 2G 时Node.js 装依赖和网关启动阶段容易 OOM服务会自己退出别省这一档。3. 可复制配置Node.js 22 OpenClaw config.toml3.1 系统更新与 Node.js 22 安装先更新系统、装基础工具sudo yum update -y sudo yum install -y curl git tar xz装 Node.js 22。用官方二进制包解压到 /usr/local再软链到 /usr/bincurl -fsSL https://nodejs.org/dist/v22.0.0/node-v22.0.0-linux-x64.tar.xz | sudo tar -xJ -C /usr/local sudo ln -sf /usr/local/node-v22.0.0-linux-x64/bin/node /usr/bin/node sudo ln -sf /usr/local/node-v22.0.0-linux-x64/bin/npm /usr/bin/npm验证一下node -v npm -v能打印出 v22.x 和对应 npm 版本就对了。如果提示 command not found多半是软链没建成功回头检查/usr/local/node-v22.0.0-linux-x64/bin/下有没有 node 可执行文件。3.2 配置 npm 镜像并安装 OpenClaw国内机器拉 npm 包慢先换镜像npm config set registry https://registry.npmmirror.com然后全局安装npm install -g openclaw装完执行openclaw --version确认命令可用。如果报openclaw: command not found通常是 npm 全局 bin 目录没进 PATH用npm bin -g看下路径手动加进环境变量。3.3 初始化与 config.toml 骨架先跑初始化向导openclaw onboard按提示走同意协议、选快速启动、模型配置这一步先跳过我们后面手写 config.toml、通道按需启用。初始化完成后配置文件默认在~/.openclaw/config.toml。下面是一份可直接改的 config.toml 骨架重点是 model 段对接 TaoToken[gateway] host 0.0.0.0 port 18789 [model] type openai base_url https://taotoken.net/api api_key ${TAOTOKEN_API_KEY} model_name claude-sonnet-4-20250514 max_tokens 2048 temperature 0.7 timeout 60 reasoning false [skills] enabled true这里type用openai是因为 TaoToken 的 API 走 OpenAI 兼容协议base_url填https://taotoken.net/apiapi_key用环境变量引用避免明文写死在文件里。model_name按你实际要用的模型填换模型只改这一行。3.4 环境变量与启动命令把 Key 写进环境变量推荐放到~/.bashrc里持久化echo export TAOTOKEN_API_KEY你的Key ~/.bashrc source ~/.bashrc确认一下echo $TAOTOKEN_API_KEY然后设置网关监听并启动openclaw config set gateway.host 0.0.0.0 openclaw config set gateway.port 18789 openclaw gateway start开机自启可以追加到 rc.localecho /usr/bin/openclaw gateway start | sudo tee -a /etc/rc.local sudo chmod x /etc/rc.local4. 验证请求确认对话链路真的通了服务起来后先看状态openclaw gateway status显示 running 就说明网关在跑。接着在 ECS 安全组放行 18789 端口浏览器打开http://你的ECS公网IP:18789能进 Web 控制台说明网关和前端都正常。接下来验证模型通道在控制台里发一句最简单的你好帮我列一下当前目录的文件如果模型正常返回内容说明 TaoToken 的 Key、base_url、model_name 三者都对上了对话链路打通。想更直接地验证 API 通道可以用 curl 打一次 TaoToken 的接口curl -s https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-20250514, messages: [{role: user, content: ping}], max_tokens: 32 }返回里带choices字段和内容就证明 Key 和通道没问题问题只可能在 OpenClaw 的配置层。这一步能把「网络/鉴权」和「框架配置」两类问题分开排障时特别省时间。5. 本篇常见报错排查5.1 服务启动后自动退出最常见的原因是内存不足。用free -h看下剩余内存2G 以下基本会 OOM。解决办法是升配到 2G 以上或者本地关掉占资源的进程。同时看日志定位openclaw logs --follow日志里如果有JavaScript heap out of memory就是内存问题无疑。5.2 无法访问 Web 控制台按顺序查三件事服务是否在跑openclaw gateway status、安全组是否放行 18789、监听地址是不是 0.0.0.0。如果本地 curlhttp://127.0.0.1:18789通、公网不通那就是安全组没放行。改完配置记得openclaw gateway restart。5.3 端口被占用lsof -i:18789 kill -9 进程ID或者直接改端口openclaw config set gateway.port 18790 openclaw gateway restart5.4 模型调用失败或回复为空先确认TAOTOKEN_API_KEY环境变量在当前 shell 里能 echo 出来再确认 config.toml 里base_url是https://taotoken.net/api不要多加斜杠或路径。回复为空时把reasoning设为 false 再重启这个字段在某些模型上会导致输出被吞。响应超时就调大timeout30→60或把max_tokens降到 1024。5.5 权限与写入问题Linux 下全局安装报权限不足用sudo npm install -g openclaw。配置文件写不进去检查当前用户对~/.openclaw/的读写权限必要时openclaw onboard --reset重新初始化。6. 后续怎么用模型对话、Coding Plan 与文档链路跑通后日常使用就是打开 Web 控制台直接下自然语言指令。想快速试不同模型的效果可以直接用模型对话页切换模型对话https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite如果你打算把 OpenClaw 当长期编码或 Agent 宿主频繁调用模型按次计费的 Coding Plan 会比按 token 更划算适合高频场景Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite配置过程中遇到鉴权、base_url、模型名对不上的问题直接翻接入文档最快接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewriteKey 管理和重新生成都在 API Keys 页API Keyshttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite最后补一句实操经验config.toml 改完一定要openclaw gateway restart光改文件不重启是不生效的这个坑我踩过不止一次。另外把 Key 放环境变量而不是写死在 toml 里换机器或轮换 Key 时只改一处省事也安全。
