☰
2026年快速上手:在阿里云服务器上部署OpenClaw(Clawdbot)并接入TaoToken的详细教程
2026/9/27 19:29:16 网站建设 项目流程

1. 为什么要在阿里云 ECS 上跑 OpenClaw

OpenClaw(前身 Clawdbot)是一个开源、本地优先的 AI 助理框架,能 7×24 小时在线响应、执行多任务自动化、跨平台协同。它和普通聊天机器人的区别在于:你给它一句自然语言指令,它能真的去创建文件、整理日程、调用工具,把「对话」变成「动作」。适合个人办公、轻量团队协作,也适合想自己搭一套 Agent 跑自动化任务的人。

但很多人卡在第一步:本地电脑跑 OpenClaw,关机就断,网络一抖任务就挂。所以我更推荐把它放到阿里云 ECS 上,长期在线、公网可访问、稳定性高。这篇就聚焦阿里云 ECS 从零部署 OpenClaw 的完整链路,覆盖 ClawHub 拉取镜像、config.toml 骨架配置,以及接入 TaoToken 统一 Key/API 通道。全程给你可复制的配置片段、systemd 启动脚本和 curl 验证对话接口的实测动作,目标是 30 分钟内跑通第一个 Agent 任务。

先说清楚一个关键点:OpenClaw 本身不绑定任何一家模型,它通过统一的 API 通道去调用大模型。TaoToken 在这里扮演的就是「统一 Key + 统一 API 通道」的角色——你只需要在 config.toml 里填一次 TaoToken 的 Key 和 base_url,后面切换模型、换供应商都不用改代码。官网入口在 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ,API 地址是 https://taotoken.net/api ,注意 API 地址不带 UTM 参数。

下面按「准备 → 拉镜像 → 写配置 → 起服务 → 验证 → 排障」的顺序走,每一步都能直接抄。

2. 部署前的准备:ECS 规格、系统与 TaoToken Key

2.1 服务器规格怎么选

OpenClaw 对内存有硬性要求,低于 2GB 会直接启动失败。我实测下来,个人日常用 2vCPU + 4GiB 内存 + 40GiB ESSD 就够,团队协作建议 4vCPU + 8GiB + 80GiB ESSD。系统优先选 Alibaba Cloud Linux 3.2104 LTS 64 位,或者 Ubuntu 22.04 LTS 64 位,这两个我都跑过,依赖兼容性最好。

场景vCPU内存存储系统
个人测试22GiB40GiB ESSDAlibaba Cloud Linux 3 / Ubuntu 22.04
个人日常24GiB40GiB ESSD同上
团队协作48GiB80GiB ESSD同上

注意:内存是硬门槛,别为了省钱选 1GiB,服务起不来还查半天。

2.2 拿到 TaoToken 的 Key

登录 TaoToken 控制台,在 API Keys 页面创建一个新 Key。这个 Key 就是 OpenClaw 调用模型的唯一凭证,格式类似sk-xxxxxxxx。创建后立刻复制保存,页面通常只显示一次。

  • 控制台入口:https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=
  • API Keys 页面:https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=
  • 接入文档:https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=

如果你后面要长期跑编码类 Agent,可以顺手看下 Coding Plan 页面,按用量选套餐更划算:https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=

2.3 连上服务器

用 FinalShell 或 Xshell 连上 ECS,或者直接用阿里云控制台的远程连接。连上后先做一次环境预检:

# 查看系统版本 cat /etc/os-release # 查看内存(确认 >= 2GiB) free -h # 查看磁盘 df -h # 确认 18789 端口没被占用(OpenClaw 默认 Web 端口) ss -tlnp | grep 18789

如果 18789 被占用,先记下进程,后面排障会用到。

3. 用 ClawHub 拉取镜像并初始化目录

3.1 安装 ClawHub CLI

ClawHub 是 OpenClaw 的官方技能市场兼镜像管理工具,截至 2026 年已收录 5700+ 社区技能。先装 CLI:

# 方式一:npm 安装 npm install -g clawhub # 方式二:yarn 安装(依赖管理更稳) yarn global add clawhub # 验证 clawhub --version

如果提示command not found: clawhub,执行source ~/.bashrc刷新环境变量再试。

3.2 拉取 OpenClaw 镜像

# 从 ClawHub 拉取 2026 版 OpenClaw 镜像 clawhub pull openclaw:2026.1.25 # 查看本地已有镜像 clawhub images # 初始化 OpenClaw 工作目录 mkdir -p ~/.openclaw/{logs,skills,data}

拉取完成后,OpenClaw 的主程序和依赖都在镜像里,不需要你手动装 Node、Python 那一堆。

3.3 生成 config.toml 骨架

OpenClaw 的核心配置是~/.openclaw/config.toml。先让它生成一份默认骨架:

openclaw init --config ~/.openclaw/config.toml

生成的骨架大概长这样,你可以直接编辑:

[gateway] host = "0.0.0.0" port = 18789 token = "" [models] default = "taotoken-gpt" [models.providers.taotoken] base_url = "https://taotoken.net/api" api_key = "" model = "gpt-4o" [skills] dir = "~/.openclaw/skills" [log] level = "info" dir = "~/.openclaw/logs"

4. 可复制的 config.toml 与 systemd 启动脚本

4.1 填入 TaoToken 统一通道

把api_key换成你在 TaoToken 控制台创建的 Key,base_url保持https://taotoken.net/api。完整配置如下,可直接复制:

[gateway] host = "0.0.0.0" port = 18789 token = "your-gateway-token" [models] default = "taotoken-gpt" [models.providers.taotoken] base_url = "https://taotoken.net/api" api_key = "sk-你的TaoToken密钥" model = "gpt-4o" [models.providers.taotoken-claude] base_url = "https://taotoken.net/api" api_key = "sk-你的TaoToken密钥" model = "claude-3-5-sonnet" [skills] dir = "/root/.openclaw/skills" [log] level = "info" dir = "/root/.openclaw/logs"

这里我配了两个 provider,都指向同一个 TaoToken 通道,只是 model 不同。这样你在 OpenClaw 里切换模型时,不用改 base_url 和 Key,只改models.default就行。这就是「统一 Key/API 通道」的实际价值。

注意:gateway.token是 Web 控制台的访问令牌,自己设一个复杂点的字符串,别留空。

4.2 写 systemd 启动脚本

为了让 OpenClaw 开机自启、崩溃自动重启,用 systemd 托管。创建服务文件:

sudo vim /etc/systemd/system/openclaw.service

内容如下:

[Unit] Description=OpenClaw Gateway Service After=network.target [Service] Type=simple User=root WorkingDirectory=/root/.openclaw ExecStart=/usr/local/bin/openclaw gateway --config /root/.openclaw/config.toml Restart=always RestartSec=5 StandardOutput=append:/root/.openclaw/logs/stdout.log StandardError=append:/root/.openclaw/logs/stderr.log [Install] WantedBy=multi-user.target

然后重载并启动:

sudo systemctl daemon-reload sudo systemctl enable openclaw sudo systemctl start openclaw # 查看状态 sudo systemctl status openclaw # 看日志 sudo journalctl -u openclaw -f

如果ExecStart里的路径不对,用which openclaw查一下真实路径替换。

4.3 放行端口

在阿里云控制台的安全组里放行 18789 端口,协议 TCP,源地址按需填0.0.0.0/0或你的固定 IP。服务器内部防火墙也要放行:

# Alibaba Cloud Linux / CentOS sudo firewall-cmd --add-port=18789/tcp --permanent sudo firewall-cmd --reload # Ubuntu sudo ufw allow 18789/tcp

5. 验证请求:curl 打通对话接口

服务起来后,先用 curl 直接打 OpenClaw 的对话接口,确认整条链路通。

5.1 健康检查

curl -s http://127.0.0.1:18789/health

返回{"status":"ok"}就说明网关活着。

5.2 发一条对话请求

curl -s -X POST http://127.0.0.1:18789/v1/chat \ -H "Content-Type: application/json" \ -H "Authorization: Bearer your-gateway-token" \ -d '{ "model": "taotoken-gpt", "messages": [ {"role": "user", "content": "你好,帮我创建一个名为 openclaw_test.txt 的文件,内容写 2026 部署成功"} ] }'

如果返回里带了模型回复,并且~/.openclaw/data下真的出现了openclaw_test.txt,说明从 OpenClaw → TaoToken 通道 → 模型 → 工具执行,整条链路都通了。

5.3 验证模型切换

把请求里的model换成taotoken-claude,再发一次:

curl -s -X POST http://127.0.0.1:18789/v1/chat \ -H "Content-Type: application/json" \ -H "Authorization: Bearer your-gateway-token" \ -d '{ "model": "taotoken-claude", "messages": [{"role": "user", "content": "用一句话介绍你自己"}] }'

两次都正常返回,说明 TaoToken 统一通道下多模型切换没问题。你也可以直接在模型对话页面手动测一下模型可用性:https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=

5.4 装一个技能跑真实任务

# 搜索基础工具包 clawhub search basic-utils # 安装 clawhub install basic-utils # 重启服务让技能生效 sudo systemctl restart openclaw

然后发一条指令让它处理文件,比如「把 openclaw_test.txt 转成 PDF」,看技能是否被正确调用。

6. 本篇常见错排查

6.1 服务起不来,日志报内存不足

现象:systemctl status openclaw显示 failed,日志里有out of memory。原因是 ECS 内存低于 2GiB。解决:升配到 4GiB,或者加 swap:

sudo fallocate -l 2G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

6.2 curl 返回 401

现象:{"error":"unauthorized"}。原因是Authorization头里的 token 和 config.toml 里的gateway.token不一致。解决:核对两处字符串,重启服务。

6.3 模型调用超时

现象:对话请求卡住,日志报connect timeout。先测 TaoToken 通道连通性:

curl -s -o /dev/null -w "%{http_code}" https://taotoken.net/api

返回 200/401 都说明网络通,401 只是没带 Key。如果连不上,检查 ECS 出网是否正常、安全组是否限制了出方向。

6.4 18789 端口被占用

现象:服务启动失败,日志报address already in use。查占用进程:

ss -tlnp | grep 18789

找到 PID 后kill -9 PID,或者改 config.toml 里的gateway.port换一个端口。

6.5 clawhub 命令找不到

现象:command not found: clawhub。原因是全局安装路径没进 PATH。解决:

npm config get prefix # 把输出的路径/bin 加到 PATH export PATH=$PATH:$(npm config get prefix)/bin source ~/.bashrc

6.6 技能装了不生效

现象:clawhub install成功,但指令不触发技能。原因是没重启服务。执行sudo systemctl restart openclaw,再确认config.toml里skills.dir指向的目录和实际安装目录一致。

7. 下一步:把 OpenClaw 接进你的工作流

跑通第一个 Agent 任务后,你可以继续做三件事。第一,把models.default换成你常用的模型,TaoToken 通道下切换只改一行。第二,用clawhub install按场景装技能,比如日程管理、邮件整理、代码审查,别一次装太多,容易冲突。第三,如果要长期跑编码类 Agent,去 Coding Plan 页面按用量选套餐,比按次调用更省:https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=

接入过程中遇到报错,优先看 API Keys 和接入文档两处,大部分配置问题都能对上:https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 和 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=

最后提醒一句:config.toml里的 Key 和gateway.token别提交到 Git,也别贴到公开群里。定期备份~/.openclaw/config.toml,服务器重置前先拷出来,能省掉重新配置的半小时。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询