1. 为什么小白在阿里云 ECS 上部署 OpenClaw 会卡在 Key 配置OpenClaw原 Clawdbot也用过 Moltbot 这个名字是一个开源的 AI 智能体平台能接工具、跑任务、做自动化适合想给自己搭一个能干活的专属助理的人。它本身不绑定某一家模型而是通过配置文件去连模型服务所以部署链路里真正容易翻车的不是装软件而是模型通道怎么填。我见过太多人在阿里云 ECS 上把 OpenClaw 跑起来了Web 界面也打开了结果一对话就报 401、超时、或者模型列表为空。原因基本集中在三处一是 Key 散落在多个工具里Cline、CC Switch、OpenClaw 各配一份改一次要改三遍二是settings.json和config.toml两个文件的字段名记混base_url 少写一段路径三是安全组只放了 22 和 80忘了 OpenClaw 默认的 18789 端口。这篇就按零基础在阿里云 ECS 上部署 OpenClaw这个场景走一遍重点放在TaoToken 统一 Key/API 通道的配置上给你可以直接复制的settings.json与config.toml骨架再补上 CC Switch / Cline 的接入步骤最后做一次对话连通性验证。全程不需要你懂容器编排照着填就行。适合谁看手里有一台阿里云 ECS2 核 2G 起步、想用统一 Key 管理多个 AI 工具、又不想每次换模型都重配一遍的人。下面所有配置里的地址统一用 TaoToken 的 API 入口https://taotoken.net/apiKey 在控制台生成一次后面所有工具复用。2. 部署前把 TaoToken 统一 Key 准备好在动 ECS 之前先把钥匙拿到手这样后面配置文件里填什么心里有数。TaoToken 的作用可以理解成一个统一的模型接入层你只维护一份 Key 和一个 base_urlOpenClaw、Cline、CC Switch 都指向它换模型时只改一个 model 字段不用挨个工具去翻配置。第一步打开控制台创建 API Key。地址走这个https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentconsole登录后在 API Keys 页面点新建复制出来的字符串形如sk-xxxxxxxx只显示一次先粘到本地记事本。这个 Key 就是后面settings.json和config.toml里要填的凭证。第二步确认你要用的模型名。OpenClaw 的配置里 model 字段要写具体模型标识建议先在模型对话页试一条确认通道通、模型可用再去填配置文件能省掉一轮排查https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentmodels第三步把接入文档开着当参照。字段名、base_url 拼法、常见返回码都在里面配置时对照着看比猜快得多https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentdoc注意Key 等同于账号权限不要写进会提交到 Git 的公开仓库也不要在截图里露出完整字符串。轮换周期建议按季度走一次。到这里前置就齐了一个 Key、一个确认可用的模型名、一份文档。接下来上 ECS。3. 阿里云 ECS 上的 OpenClaw 安装与端口放通登录阿里云控制台创建一台 ECS 实例。规格上 2 vCPU 2GB 内存是底线低于 2GB 在拉依赖和跑智能体任务时容易 OOM。系统选 Ubuntu 22.04 或 24.04 都行下面命令按 Ubuntu 写。创建时在安全组里放通这几个端口22SSH、18789OpenClaw Web 界面。如果你后面要对接钉钉、飞书这类平台做回调回调地址会用到公网 IP 18789所以这个端口必须开。80/443 可选看你要不要挂反向代理。用 SSH 连上实例后先更新系统并装基础依赖sudo apt update sudo apt upgrade -y sudo apt install -y curl git build-essential装 Node.js。OpenClaw 的运行依赖 Node 环境建议用 NodeSource 装 20.x LTScurl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt install -y nodejs node -v npm -vnode -v输出v20.x.x就说明装好了。接着拉 OpenClaw 源码并安装依赖git clone https://github.com/openclaw/openclaw.git cd openclaw npm install如果你的部署方式是用官方镜像或计算巢模板这一步会被自动完成你只需要跳到配置环节。手动部署的话npm install跑完会生成node_modules第一次会慢一点耐心等。安装完成后先别急着启动因为默认配置里没有模型通道直接起会连不上。下一步就是写配置文件。4. settings.json 与 config.toml 骨架配置核心OpenClaw 的配置分两处settings.json管应用层行为config.toml管模型通道和运行时参数。两个文件都在项目根目录或~/.openclaw/下具体路径以你拉下来的版本为准找不到就用find . -name settings.json定位。先写settings.json。这个文件控制界面、会话、工具开关模型相关的凭证不写这里保持干净{ server: { host: 0.0.0.0, port: 18789, accessToken: 换成你自己生成的一串随机字符 }, agent: { name: my-openclaw, language: zh-CN, maxSteps: 20 }, tools: { webSearch: true, codeRunner: true, fileAccess: true }, logging: { level: info } }几个字段说明host写0.0.0.0才能从公网访问写127.0.0.1就只能在服务器本机开port保持 18789和安全组放通的端口一致accessToken是登录 Web 界面用的自己生成一串随机字符别用弱口令。再写config.toml这是模型通道的关键TaoToken 的 base_url 和 Key 都填在这里[model] provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model 你的模型名 timeout 120 [model.params] temperature 0.7 max_tokens 4096 [runtime] workspace ./workspace auto_approve falseprovider用openai-compatible是因为 TaoToken 走的是兼容 OpenAI 的接口形态这样 OpenClaw 不用改代码就能接。base_url结尾不要多加/v1具体以接入文档为准多写或少写一段路径是最常见的 404 来源。api_key填第 2 步拿到的 Key。model填你在模型对话页验证过的那个名字。注意config.toml里如果同时存在base_url和api_base两个字段以你版本实际读取的为准改完用启动日志确认别两个都填。配置写完给文件收一下权限避免同机其他用户读到 Keychmod 600 config.toml5. CC Switch 与 Cline 接入同一套 KeyOpenClaw 跑起来之后你大概率还会在本地用 Cline 写代码、用 CC Switch 切模型。既然 TaoToken 是统一通道这三个工具就共用同一个 Key 和 base_url改一处即可。Cline 接入在 VS Code 里打开 Cline 设置API Provider 选OpenAI CompatibleBase URL 填https://taotoken.net/apiAPI Key 填同一个sk-开头的字符串Model ID 填你验证过的模型名。保存后发一条测试消息能回就通了。CC Switch 接入打开 CC Switch 的配置界面新增一个 provider类型选兼容 OpenAI 的通道把 base_url 和 api_key 填成和config.toml里一致的值。CC Switch 的好处是可以在多个 provider 之间一键切换你把 TaoToken 配成一个 provider 后以后换模型只改 model 字段不用重配 Key。如果你后面要长期跑编码类任务、或者把 OpenClaw 当 Agent 常驻用可以看一下 Coding Plan它更适合高频调用场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentcoding-plan三个工具指向同一个 base_url 后你维护的凭证就只有一份。哪天 Key 要轮换改三处配置里的 api_key 字段就行模型名和地址都不用动。6. 启动 OpenClaw 并验证对话连通性配置齐了启动服务cd openclaw npm run start或者用后台方式跑避免 SSH 断开就停nohup npm run start openclaw.log 21 tail -f openclaw.log日志里看到监听 18789、模型通道初始化成功就说明起来了。如果日志里出现401或invalid api key回到config.toml检查 api_key 有没有多余空格出现404或model not found检查 base_url 和 model 字段。浏览器打开http://你的ECS公网IP:18789输入settings.json里设置的 accessToken 登录。进到对话界面后发一条最简单的消息比如你好报一下你当前使用的模型名。能正常返回说明从 ECS 到 TaoToken 再到模型的整条链路是通的。再做一个稍微复杂点的验证确认工具调用没被挡住发帮我列一下当前工作目录下的文件。如果settings.json里fileAccess开着智能体会调用文件工具并返回结果。这一步能过说明不只是对话通工具链也活了。验证通过后建议把启动命令做成 systemd 服务开机自启、崩溃自动拉起sudo tee /etc/systemd/system/openclaw.service /dev/null EOF [Unit] DescriptionOpenClaw Agent Afternetwork.target [Service] WorkingDirectory/root/openclaw ExecStart/usr/bin/npm run start Restartalways Userroot [Install] WantedBymulti-user.target EOF sudo systemctl daemon-reload sudo systemctl enable --now openclaw sudo systemctl status openclawWorkingDirectory换成你自己的项目路径。systemctl status显示active (running)就稳了。7. 本篇常见报错排查401 Unauthorized九成是 api_key 填错或带了空格。用cat -A config.toml | grep api_key看有没有隐藏字符。也可能是 Key 被禁用或额度用尽去控制台确认状态。404 Not Foundbase_url 路径写错。TaoToken 的入口是https://taotoken.net/api不要自作主张加/v1或/chat/completionsOpenClaw 会自己拼。改完重启服务。连接超时 / timeoutECS 出网被安全组或网络 ACL 挡了。在服务器上直接curl -I https://taotoken.net/api测一下能不能通不通就是出网问题检查安全组出方向规则。Web 界面打不开先确认服务在跑systemctl status openclaw再确认安全组放通了 18789最后确认settings.json里 host 是0.0.0.0不是127.0.0.1。三个都对还打不开看服务器本地curl http://127.0.0.1:18789有没有响应。模型列表为空model 字段填的模型名不在通道支持范围内。去模型对话页确认可用模型名复制准确的标识填回去。改了配置不生效OpenClaw 有些版本会缓存配置改完必须重启进程。sudo systemctl restart openclaw再试。端口被占用lsof -i:18789看谁占着杀掉旧进程或换端口换端口记得同步改安全组。8. 后续维护与 Key 管理建议跑通之后日常维护其实很轻。Key 轮换时去控制台新建一个然后改config.toml、Cline、CC Switch 三处的 api_key重启 OpenClaw 即可base_url 和 model 都不用动这就是统一通道省事的地方。新建 Key 的入口还是控制台https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentapi-keys如果你打算把 OpenClaw 接到钉钉、飞书做团队助理回调地址用公网IP:18789记得在平台侧配好白名单。中国内地地域的服务器在联网搜索类功能上可能受限需要完整能力的话选香港或海外地域。最后提醒一句settings.json里的 accessToken 和config.toml里的 api_key 是两把不同的钥匙前者管界面登录后者管模型调用别混用。两个都收好这台 ECS 上的 OpenClaw 就能长期稳定替你干活了。