1. 为什么要在 Linux 服务器上折腾 OpenClawOpenClaw 是一个可以跑在服务器上的 AI 网关/控制台类工具简单说就是给你一个 Web UI把大模型的对话、渠道、技能这些配置集中管理起来。它适合谁适合手里有一台闲置 Linux 服务器、想自己搭一个 AI 控制台、又不想在每台电脑上重复配置模型 Key 的人。我这次用的是一台 Ubuntu 24.04 64 位、2 核 2G 的云服务器纯新机器什么都没装过正好用来演示从零部署到干净卸载的全流程。很多人第一次装 OpenClaw 会卡在依赖上。官方安装脚本curl -fsSL https://openclaw.ai/install.sh | bash会自动帮你装 Node.js、Git 这些但在部分精简系统上缺少build-essential和python3会导致编译环节失败而且失败日志可能是空的让人一头雾水。我实测下来先补系统依赖再跑安装脚本成功率会高很多。部署完成之后还有一个关键动作模型接入。OpenClaw 本身不生产模型它需要你填一个兼容 OpenAI 协议的 Base URL 和 API Key。这里我用 TaoToken 作为统一通道一个 Key 就能对接多种模型省得在 OpenClaw 里来回切换配置。TaoToken 的 API 地址是https://taotoken.net/api官网在https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content注册后在控制台生成 Key 即可。这篇文章会按「装依赖 → 跑安装 → 配模型 → 验证连通 → 卸载清理」的顺序走一遍每一步都给可复制的命令和配置片段。卸载部分我会额外做残留检查因为npm rm -g之后有些配置目录还在重装时可能读到旧配置导致行为异常。如果你只是想快速体验也可以直接跳到第 3 节的配置部分但建议按顺序来避免踩我踩过的坑。2. 部署前的环境准备与 TaoToken Key 获取先说服务器环境。我用的镜像是 Ubuntu 24.04 64 位登录方式用 root 或带 sudo 的普通用户都行。第一步永远是更新包索引这一步别省否则后面apt install可能找不到包sudo apt update sudo apt upgrade -y接着装编译工具链和 Python3。OpenClaw 安装过程中有些 npm 包需要本地编译缺build-essential会直接失败而失败日志有时是空的很难排查sudo apt install -y build-essential python3 curl git装完可以验证一下版本确认环境就绪node -v 2/dev/null || echo node 未安装安装脚本会处理 python3 --version gcc --version | head -n 1如果node没装不用慌官方安装脚本会自动装 Node.js。但 Python3 和 gcc 建议提前装好这是我从三次失败里总结出来的经验第一次直接跑脚本卡在编译第二次换了 npm 镜像源还是失败第三次先补build-essential python3才成功。然后是 TaoToken 的 Key。打开官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content注册登录后进入控制台在 API Keys 页面创建一个新 Key。这个 Key 就是后面填进 OpenClaw 的凭证格式通常是一串sk-开头的字符串。创建后先复制保存页面刷新后可能不再完整显示。TaoToken 在这里扮演的是「统一模型通道」的角色。OpenClaw 支持配置多个模型提供商但如果你每个提供商都要单独申请 Key、单独填 Base URL管理起来很碎。用 TaoToken 的话Base URL 统一填https://taotoken.net/apiKey 填你刚创建的那一个模型 ID 按需选择即可。这样 OpenClaw 里只需要维护一份凭证。需要提前确认的信息我列个表方便你对照准备项目值说明Base URLhttps://taotoken.net/api兼容 OpenAI 协议API Key控制台生成sk-开头Model ID按需选择如对话类、编码类模型服务器端口18789OpenClaw 默认 Web UI 端口系统依赖build-essential、python3编译必需把这些准备好后面的安装和配置就会顺很多。特别提醒Key 不要直接提交到 Git 仓库后面我会用环境变量的方式引用。3. 可复制的安装命令与模型接入配置环境就绪后执行官方安装脚本curl -fsSL https://openclaw.ai/install.sh | bash脚本运行过程中会出现几个交互选项。第一个选项问是否继续用左右方向键选yes回车。第二个选项选QuickStart这是最省事的模式。接着会让你选择大模型提供商这里先随便选一个跳过也行因为我们后面要手动改成 TaoToken 的配置。渠道和 skills 那一步选Skip for now最后选Open the web UI。安装完成后终端会打印一段 Dashboard 链接和 SSH 隧道命令类似这样Dashboard link (with token): http://127.0.0.1:18789/#tokenXXXXXXXXXXXXXXXX ssh -N -L 18789:127.0.0.1:18789 rootxxx.xx.xx.xxx注意这里的 IP 是私网 IP在本地 Windows 上是连不通的需要把root后面的地址改成服务器的公网 IP。改完后在本地终端执行这条 SSH 隧道命令输入 root 密码隧道就建好了。然后浏览器打开http://127.0.0.1:18789/#token...就能看到 Web UI。接下来是关键的模型接入配置。OpenClaw 的配置文件通常位于~/.openclaw/config.json或安装目录下的config文件夹具体路径以安装脚本提示为准。我用的是 JSON 格式把模型提供商指向 TaoToken{ providers: { taotoken: { baseUrl: https://taotoken.net/api, apiKey: ${TAOTOKEN_API_KEY}, models: [ { id: your-model-id, name: TaoToken 统一通道模型, provider: taotoken } ] } }, defaultModel: your-model-id }这里apiKey用了环境变量${TAOTOKEN_API_KEY}避免明文写进配置文件。在服务器上设置环境变量export TAOTOKEN_API_KEYsk-你的Key echo export TAOTOKEN_API_KEYsk-你的Key ~/.bashrc source ~/.bashrc如果你更习惯用 TOML 格式OpenClaw 部分版本也支持等价写法如下[providers.taotoken] baseUrl https://taotoken.net/api apiKey ${TAOTOKEN_API_KEY} [[providers.taotoken.models]] id your-model-id name TaoToken 统一通道模型 provider taotoken [default] model your-model-id配置里的三件套必须齐全Base URL 填https://taotoken.net/apiKey 填 TaoToken 控制台生成的Model ID 填你要用的模型标识。三者缺一请求就会报错。改完配置后重启 OpenClaw 服务让配置生效openclaw restart如果命令不存在用openclaw --help看下可用子命令或者直接pkill -f openclaw后重新启动。重启后在 Web UI 里应该能看到新配置的模型出现在下拉列表里。4. 验证请求与成功结果确认配置改完最怕的是「看起来配好了但请求不通」。所以别急着在 UI 里点对话先用命令行做一次最小化验证。OpenClaw 一般会提供 CLI 调用方式或者你可以直接用 curl 打 TaoToken 的接口确认 Key 和 Base URL 本身是通的curl -s https://taotoken.net/api/v1/models \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json | head -c 500如果返回一段包含模型列表的 JSON说明 Key 和通道没问题。如果返回 401说明 Key 错了或没生效如果返回连接超时检查服务器出网是否正常。接着在 OpenClaw 里发一条测试消息。打开 Web UI在对话框输入「你好请回复一句话」观察返回。成功的话你会看到模型正常回复同时服务器终端可能有请求日志。我实测下来第一次请求偶尔会慢几秒因为要建立连接之后就正常了。如果你想更严谨地验证可以看 OpenClaw 的日志文件通常在~/.openclaw/logs/下tail -f ~/.openclaw/logs/*.log在 UI 里发消息的同时观察日志能看到请求的 URL、状态码和耗时。如果日志里出现reading choices相关的报错多半是返回结构解析问题通常是 Base URL 末尾多了或少了/v1导致的。TaoToken 的 Base URL 用https://taotoken.net/api即可OpenClaw 会自动拼接路径。成功的结果应该满足这几点UI 里模型下拉框能选到 TaoToken 的模型发消息有正常回复日志里状态码是 200没有local proxy failed之类的报错。这四条都过了说明部署和接入都成功了。顺便说下端口和防火墙。OpenClaw 默认监听127.0.0.1:18789只允许本机访问这是安全的默认值。我们通过 SSH 隧道访问不需要在云服务器安全组里开放 18789 端口。如果你非要直接暴露务必加认证否则等于把控制台公开在公网上风险很大。5. 卸载 OpenClaw 与残留清理排查学习阶段难免要重装卸载干净很重要。官方文档给的两个命令是openclaw uninstall npm rm -g openclaw先执行openclaw uninstall它会停掉服务、清理部分运行时数据。然后npm rm -g openclaw卸载全局 npm 包。但这两步之后配置目录和缓存往往还在重装时可能读到旧配置导致「明明卸载了但行为还是旧的」。我建议手动检查这几个位置ls -la ~/.openclaw 2/dev/null ls -la ~/.config/openclaw 2/dev/null ls -la /root/.openclaw 2/dev/null npm ls -g --depth0 | grep openclaw如果~/.openclaw还在里面通常有config.json、logs/、data/等。确认不需要后删除rm -rf ~/.openclaw rm -rf ~/.config/openclaw再检查有没有残留进程ps aux | grep -i openclaw | grep -v grep有的话用kill -9 PID结束。端口也要确认释放ss -tlnp | grep 18789没有输出说明端口已释放。最后确认全局包真的没了which openclaw || echo openclaw 已卸载这里列几个卸载和重装时常见的报错对照排查报错/现象原因处理401 UnauthorizedKey 错误或未生效重新source ~/.bashrc确认环境变量local proxy failed出网异常或 Base URL 错检查https://taotoken.net/api是否可达reading choices解析失败返回结构不匹配确认 Base URL 不带多余/v1OAuth 授权卡住选错了提供商模式改用 API Key 模式填 TaoToken重装后配置仍旧残留目录未删删~/.openclaw后重装端口 18789 被占用旧进程未退出kill旧进程再启动卸载完想重装直接回到第 3 节的安装命令即可流程一致。我建议每次重装前都跑一遍上面的残留检查能省掉很多「为什么配置不生效」的困惑。6. 长期使用建议与统一 Key 接入入口如果你只是偶尔体验按前面的流程走一遍就够了。但如果打算长期在服务器上跑 OpenClaw把它当成日常的 AI 控制台有几个点值得注意。第一Key 的管理。用 TaoToken 统一通道的好处是一个 Key 管所有模型但也要注意别把 Key 写死在配置文件里。用环境变量或系统的 secret 管理方式换 Key 时只改一处。第二日志和磁盘。OpenClaw 的日志会持续增长2 核 2G 的小机器磁盘有限建议定期清理~/.openclaw/logs/下的旧日志或者配置日志轮转。第三服务保活。默认启动方式在 SSH 断开后可能退出长期运行建议用systemd或tmux托管具体方式看 OpenClaw 文档里的服务化说明。模型接入这块TaoToken 的入口我整理一下方便你按需取用。需要生成和管理 Key 的去 API Keys 页面想先在线试试模型效果的用模型对话打算长期跑编码或 Agent 任务的看 Coding Plan接入过程中遇到问题查接入文档。这几个入口分别对应不同阶段的需求不用一上来就全配齐。API Keys 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content模型对话体验https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentCoding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content最后说个实用技巧重装 OpenClaw 之前先把~/.openclaw/config.json备份出来卸载清理完再放回去这样模型配置不用重新填。但前提是你确认旧配置没问题否则会把之前的错误一起带回来。我一般会在备份文件名里加日期比如config.json.bak.20250101方便回溯。整套流程走下来从裸机到可用大概十几分钟卸载清理也就两三分钟关键是别漏掉残留目录那一步。
