1. 为什么要把 OpenClaw 搬到服务器上跑OpenClaw 是一个可以常驻运行、通过网关对外提供能力的 AI 助手框架适合个人开发者、小团队以及需要长期在线的自动化场景。它本身能对接多种模型通道也能挂载工作空间、频道和定时任务。问题在于很多人第一次用都是在本地电脑上跑笔记本一合盖、网络一断服务就没了。如果你希望它 24 小时在线随时响应消息、随时执行任务那就必须把它部署到服务器上。本地运行的局限很直接电脑关机就停、出门在外访问不了、团队没法共享、本机资源也有限。部署到服务器之后这些限制基本消失——服务常驻、随时随地可访问、多人可共用、后续还能按需升配。但真正上手后新的麻烦又来了API Key 分散在多个配置文件里换一个模型通道就要改一遍配置服务器重启后还得手动确认服务是否真的活着。这篇就围绕「OpenClaw 部署到服务器 24 小时在线」这个场景把 TaoToken 统一 Key 接入和config.toml配置骨架讲清楚让你从本地迁移到服务器时少踩坑。我试过把 Key 硬编码在多个地方结果一次通道切换改了三个文件还漏了一个服务起来后请求一直 401。后来统一走一个 Key 入口配置收敛到一份骨架里重启验证也变成固定动作才算是真正稳定下来。下面按步骤来。2. TaoToken 前置统一 Key 接入准备TaoToken 在这里扮演的角色是「统一 Key 入口」。你不需要在 OpenClaw 的每个 provider 里分别填不同厂商的 Key而是通过 TaoToken 拿到一个统一 Key再让 OpenClaw 指向 TaoToken 的 API 地址。这样通道切换、额度管理、Key 轮换都只在一个地方处理服务器上的配置文件也不会因为换模型而反复改动。先访问官网了解整体能力https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。注册登录后进入控制台创建 API Key控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。创建时建议给 Key 起一个能区分用途的名字比如openclaw-server方便以后在服务器上排查是哪个 Key 在发请求。拿到 Key 之后API 基地址用 https://taotoken.net/api 注意这个地址不带 UTM 参数直接写进配置即可。如果你后续要做模型对话调试可以用模型对话页面先验证 Key 是否可用https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。长期跑编码类或 Agent 类任务的话可以了解 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite API Keys 管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。注意Key 只创建一次、只存一份服务器上通过环境变量或配置文件引用不要把它提交到 Git 仓库也不要在多个 provider 段落里重复粘贴。3. 服务器环境与 OpenClaw 安装服务器选型不用太纠结1 到 5 人的小团队2 核 2G、40GB 存储、3Mbps 带宽就够跑起来。系统建议 Ubuntu 22.04 LTS镜像干净、依赖好装。买好实例后安全组至少放开 22 端口SSH和 OpenClaw 网关端口默认是 18789。连上服务器后先做基础配置创建普通用户而不是一直用 rootapt update apt upgrade -y adduser openclaw usermod -aG sudo openclaw su - openclaw sudo apt install -y curl git vim htop接着装 Node.js 22 及以上版本用 nvm 管理最省心curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash source ~/.bashrc nvm install 22 node --version npm --version国内服务器可以把 npm 镜像换成 npmmirror装包会快很多npm config set registry https://registry.npmmirror.com npm config get registry然后安装 OpenClawnpm install -g openclawlatest openclaw --version安装完成后先别急着跑引导因为我们要把配置直接写成config.toml骨架而不是让向导生成一堆分散的 JSON。OpenClaw 的配置目录通常在~/.openclaw/我们在这个目录下创建config.toml。4. config.toml 配置骨架可复制下面这份骨架把 TaoToken 统一 Key 接入、网关端口、工作空间、日志级别都收敛在一起。你可以直接复制把YOUR_TAOTOKEN_KEY替换成自己在控制台创建的 Key。# ~/.openclaw/config.toml # OpenClaw 服务器常驻配置骨架 [gateway] host 0.0.0.0 port 18789 # 对外访问鉴权建议开启 auth_mode token auth_token YOUR_GATEWAY_TOKEN [provider.taotoken] # 统一 Key 入口所有模型通道走这里 base_url https://taotoken.net/api api_key YOUR_TAOTOKEN_KEY # 默认使用的模型可按需替换 default_model claude-sonnet-4-20250514 timeout_seconds 120 max_retries 3 [workspace] # 工作空间目录持久化数据放这里 path /home/openclaw/.openclaw/workspace # 单文件大小上限单位 MB max_file_size 50 [logging] level info # 日志文件路径配合 logrotate 使用 file /home/openclaw/.openclaw/logs/openclaw.log rotate true max_days 7 [service] # 常驻模式配合 systemd 使用 mode daemon # 健康检查间隔单位秒 health_interval 30几个关键点说明一下。[provider.taotoken]这一段是核心base_url固定指向 TaoToken 的 API 地址api_key就是统一 Key。以后要换模型只改default_model一行不用动 Key。[gateway]里的auth_token是给外部访问用的和 API Key 不是一回事别混用。[workspace]和[logging]的路径都放在用户目录下权限清晰备份也方便。如果你更习惯用环境变量注入 Key可以把api_key写成引用形式然后在 systemd 服务里通过Environment传入。两种方式都行关键是 Key 只出现一次。5. systemd 常驻与重启后连通性验证配置写好后用 systemd 把 OpenClaw 拉起来实现开机自启和崩溃重启。创建服务文件sudo vim /etc/systemd/system/openclaw.service内容如下[Unit] DescriptionOpenClaw Gateway Afternetwork.target [Service] Typesimple Useropenclaw WorkingDirectory/home/openclaw/.openclaw ExecStart/usr/bin/openclaw gateway --config /home/openclaw/.openclaw/config.toml Restartalways RestartSec10 EnvironmentNODE_ENVproduction [Install] WantedBymulti-user.target然后重载并启动sudo systemctl daemon-reload sudo systemctl enable openclaw sudo systemctl start openclaw sudo systemctl status openclaw服务起来后做一次连通性验证。先看端口是否监听ss -tlnp | grep 18789再用 curl 打一下网关的健康接口确认服务真的在响应curl -s -o /dev/null -w %{http_code}\n http://127.0.0.1:18789/health返回 200 就说明网关活着。接着验证 TaoToken 通道是否通可以用一个最小请求测试模型调用curl -s https://taotoken.net/api/v1/models \ -H Authorization: Bearer YOUR_TAOTOKEN_KEY | head -c 300能返回模型列表说明 Key 和网络都没问题。最后模拟一次重启确认服务能自动恢复sudo systemctl restart openclaw sleep 15 sudo systemctl is-active openclaw curl -s -o /dev/null -w %{http_code}\n http://127.0.0.1:18789/healthis-active输出active、健康接口返回 200这套验证动作就算跑通了。以后每次改完配置都按这个顺序走一遍能省掉很多「以为起来了其实没起来」的排查时间。6. 本篇常见错排查报错一服务启动后立刻退出systemctl status显示 exit code 1。多半是config.toml语法错误或路径不存在。先用openclaw gateway --config ~/.openclaw/config.toml在前台跑一次看具体报错行。TOML 对引号和缩进敏感base_url和api_key都要用双引号包住。报错二健康接口返回 401 或 403。这是网关鉴权没配对。检查[gateway]里的auth_mode和auth_tokencurl 测试时带上-H Authorization: Bearer YOUR_GATEWAY_TOKEN。注意网关 token 和 TaoToken 的 API Key 是两个东西别拿错。报错三模型请求超时或 502。先确认服务器能出网curl -I https://taotoken.net/api看是否可达。如果网络正常检查timeout_seconds是否太短长任务可以调到 180。另外max_retries设成 3 能扛住偶发抖动。报错四重启后服务没起来。确认systemctl enable openclaw执行过否则开机不会自启。再看journalctl -u openclaw -n 100有没有端口占用或权限报错。18789 被占用时改config.toml里的port并同步改 systemd 和防火墙。报错五日志文件不写或写满磁盘。检查[logging]里的file路径目录是否存在openclaw用户有没有写权限。max_days 7配合 logrotate 能自动清理建议再单独配一份/etc/logrotate.d/openclaw避免日志把磁盘撑爆。排障时如果卡在接入层优先看 API Keys 管理页确认 Key 状态https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 接入细节对照文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。如果只是想先验证模型通不通用模型对话页面最快https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。长期跑编码和 Agent 任务建议直接上 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。最后补一句实操经验服务器上的时间同步别忽略timedatectl确认时区正确否则日志时间错乱会让排障很痛苦。配置改完后先在前台跑通再交给 systemd这个顺序能帮你把大部分问题挡在常驻之前。
平方复杂度无法被常规优化消除)
