1. 为什么要在阿里云上跑 OpenClaw以及它到底解决什么问题OpenClaw早期叫 Clawdbot是一个可以本地部署、带记忆和插件扩展机制的 AI 智能体框架。简单说它像一个「能动手的助手」你用自然语言下指令它去帮你整理文件、检索信息、做内容摘要、跑自动化流程而这些能力靠 Skills 不断扩展。它依赖 Node.js 运行既能跑在本地 Windows11、macOS、Linux也能长期挂在阿里云 ECS 上数据优先落在自己机器里可控性比纯云端 SaaS 强不少。这篇面向零基础用户目标很明确在阿里云 ECS 上完成 OpenClaw 的本地与云端集成部署8 分钟内跑通并且用 TaoToken 统一 Key 接入模型通道最后验证 Skills 是否真的加载生效。适合谁第一次接触智能体框架、手里有一台阿里云轻量服务器、想用一套 Key 管住所有模型调用的人。我会把 Node.js 环境准备、config.toml 与 settings.json 骨架、Skills 验证这几块拆成可直接复制的步骤你照着敲就行。需要先说明一点模型调用这一层我统一走 TaoToken 的 API 通道官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 。这样做的原因是OpenClaw 本身不绑定某一家模型你只要给它一个兼容的 base_url 和 Key它就能工作而统一 Key 能省掉在多个平台之间来回切换的麻烦。2. 部署前的前置准备TaoToken 统一 Key 与阿里云环境2.1 先拿到 TaoToken 的 Key 和通道地址在开始装 OpenClaw 之前先把模型通道准备好否则后面配置完发现调不通会来回折腾。打开 TaoToken 控制台创建 API Key地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。创建完把 Key 复制保存好它通常以固定前缀开头后面配置里要用。如果你还不确定该用哪个模型可以先到模型对话页面试一下手感https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。想确认 Key 是否可用也可以直接在 API Keys 管理页核对https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 遇到字段不确定时对着看。注意Key 只保存在你自己的服务器或本地配置文件里不要贴到公开仓库或聊天记录中。2.2 阿里云 ECS 的基础配置实例规格建议 1 核 2GB 内存起步系统盘 40GB 以上系统用 Alibaba Cloud Linux 3 或 Ubuntu 22.04 都行。安全组里放行 18789 端口这是 OpenClaw Web 控制台的默认端口。登录方式用 Web 终端或 SSH 都可以。登录服务器后先做一次系统更新和基础依赖安装sudo yum update -y sudo yum install -y curl git tar xzUbuntu/Debian 用户把上面换成sudo apt update sudo apt install -y curl git tar xz2.3 安装 Node.js 22OpenClaw 要求 Node.js 22.x 及以上。用官方二进制包安装最省事curl -fsSL https://nodejs.org/dist/v22.0.0/node-v22.0.0-linux-x64.tar.xz -o node22.tar.xz sudo tar -xJf node22.tar.xz -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/路径是否存在。3. 可复制配置安装 OpenClaw 并写入 config.toml 与 settings.json3.1 安装与初始化先把 npm 镜像切到国内源安装会快很多npm config set registry https://registry.npmmirror.com npm install -g openclaw安装完成后执行初始化向导openclaw onboard按提示走同意协议、选择快速启动、模型配置这一步先跳过我们后面手动写配置文件、启用全部通道。初始化会在用户目录下生成配置骨架Linux 下通常是~/.openclaw/。3.2 config.toml 骨架配置OpenClaw 的主配置用 TOML 格式路径在~/.openclaw/config.toml。下面是一份可直接复制的骨架重点是 gateway 和 model 两段[gateway] host 0.0.0.0 port 18789 token 换成你自己的访问Token [model] provider openai-compatible base_url https://taotoken.net/api api_key 你的TaoToken Key model_name claude-sonnet-4-5 max_tokens 2048 temperature 0.7 timeout 60 reasoning false [skills] auto_load true path ~/.openclaw/skills几个关键点解释一下。gateway.host设成0.0.0.0是为了让公网能访问 Web 控制台model.base_url指向 TaoToken 的 API 地址api_key填你刚才创建的 Keyprovider用openai-compatible是因为 TaoToken 的通道兼容 OpenAI 风格的请求格式OpenClaw 直接就能对接。reasoning设成 false 可以避免部分模型返回空内容的情况。3.3 settings.json 补充配置有些运行时参数放在~/.openclaw/settings.json里和 config.toml 分工不同。骨架如下{ runtime: { log_level: info, data_dir: ~/.openclaw/data, memory_enabled: true }, channels: { web: { enabled: true }, cli: { enabled: true } }, model_fallback: { enabled: true, retry: 2 } }memory_enabled打开后 OpenClaw 会保留对话记忆model_fallback在模型偶发超时时自动重试对稳定性有帮助。两个文件都改完后重启网关让配置生效openclaw gateway restart4. 验证请求确认模型通道与 Skills 都真的生效4.1 启动服务并访问控制台openclaw gateway start openclaw gateway status状态显示 running 后浏览器打开http://你的服务器公网IP:18789输入 config.toml 里设置的 token 进入对话页面。如果打不开先确认安全组 18789 已放行再确认服务确实在跑。4.2 发一条测试指令验证模型通道在 Web 控制台里输入一句简单指令比如「帮我总结一下今天要做的三件事」。如果模型正常返回内容说明 TaoToken 的 Key 和 base_url 配置正确。返回为空的话先把reasoning确认为 false再重启服务。想更直接地验证 API 通道可以用 curl 打一次curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer 你的TaoToken Key \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-5, messages: [{role: user, content: ping}] }能返回 JSON 结构且带 content 字段就说明通道没问题问题只可能在 OpenClaw 的配置层。4.3 安装并验证 SkillsSkills 是 OpenClaw 的能力扩展先装技能管理工具npm install -g clawhub然后按需安装常用技能clawhub install tavily-search clawhub install agent-browser clawhub install summarize clawhub install skill-vetter装完后查看列表和状态openclaw skill list openclaw skill status summarize最后重启网关让技能加载openclaw gateway restart重启后在控制台里让 OpenClaw 执行一个依赖技能的任务比如「用 summarize 技能把这段文字压缩成三句话」。如果它能调用对应技能并返回结果说明 Skills 集成生效。这一步是整个部署里最能体现「集成成功」的验证动作。5. 本篇常见错排查从 command not found 到技能不加载5.1 openclaw: command not found多半是 npm 全局 bin 目录没进 PATH。执行npm config get prefix看路径然后把它加到 PATH 里或者直接用完整路径调用。重装一次npm install -g openclaw也常能解决。5.2 服务启动后自动退出最常见原因是内存不足。1 核 1GB 的实例跑 OpenClaw 会比较吃力建议升到 2GB。用openclaw logs看具体报错如果是 OOM 相关关掉服务器上其他占内存的进程。5.3 无法访问 Web 控制台按顺序排查openclaw gateway status确认服务在跑阿里云安全组确认 18789 放行gateway.host是否为0.0.0.0本地访问用http://127.0.0.1:18789。端口被占用的话lsof -i:18789 kill -9 进程ID5.4 模型调用失败或返回为空先确认 Key 没写错、账号额度充足、model_name拼写正确。返回空内容时在 config.toml 的 model 段加reasoning false再重启。响应超时就把timeout从 60 调到 90同时把max_tokens降到 1024 试试。5.5 技能安装后不生效clawhub命令不可用就重装npm install -g clawhub安装失败先切镜像npm config set registry https://registry.npmmirror.com装完不生效就openclaw gateway restart再用openclaw skill list确认技能在列表里。如果技能路径不对检查 config.toml 里skills.path是否指向实际目录。5.6 权限与配置文件写入问题Linux/macOS 下全局安装报权限错误加 sudosudo npm install -g openclaw。Windows 下执行策略拦脚本用管理员 PowerShell 跑Set-ExecutionPolicy RemoteSigned -Scope CurrentUser。配置文件写不进去检查当前用户对~/.openclaw/的读写权限必要时openclaw onboard --reset重新初始化。6. 后续怎么用把统一 Key 和 Skills 变成日常习惯部署跑通只是起点。日常使用里我建议把模型调用统一收口到 TaoToken 这一层OpenClaw 的 config.toml 里只维护一个 base_url 和一个 Key换模型时改model_name就行不用动其他配置。如果你打算长期跑编码类或 Agent 类任务可以了解下 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 按次计费对高频调用更友好。Skills 这块别一次装太多先装两三个高频用的跑顺了再加。每次装完技能记得openclaw gateway restart然后用openclaw skill status确认状态。日志用openclaw logs --follow实时看出问题第一时间能定位。最后留一个实用习惯把 config.toml 和 settings.json 备份一份到本地服务器重装或迁移时直接覆盖省得重新配。整套流程走下来8 分钟跑通不是夸张真正花时间的是排错而排错的关键就是按上面第 5 节的顺序逐层确认——服务在不在、端口通不通、Key 对不对、技能加载没加载。