1. 为什么在 Linux 上装 openclaw 总卡在第一步openclaw 这个项目最近改名比较频繁从早期的 clawbot 到现在的 openclawnpm 包名、安装脚本、初始化命令都换过一轮。很多人在 Linux 上第一次部署时照着搜索引擎第一条结果敲命令结果npm install -g clawbotlatest直接 404或者curl -fsSL https://openclaw.ai/install.sh | bash卡在npm install failed; cleaning up and retrying无限循环。我自己第一次装的时候也踩了这些坑后来发现其实核心就两条命令一条装、一条启动剩下的都是环境准备和模型接入的收尾工作。这篇面向的是在 Linux 上初次部署 openclaw 的开发者目标很明确用两条命令完成安装与启动然后通过 TaoToken 统一 Key/API 通道把模型服务接进来最后用 curl 验证服务真的通了。整个过程从零到可用一次跑通。你需要准备的东西不多一台能联网的 Linux 机器、Node 版本 22、一个 TaoToken 的 API Key。下面按顺序来每一步都给可复制的命令和预期结果。2. 前置准备Node 22 与 TaoToken 通道2.1 确认 Node 版本 22openclaw 对 Node 版本有硬性要求低于 22 会在安装阶段报各种奇怪的错。先查一下node -v如果输出是v22.x.x或更高直接跳到 2.2。如果低于 22用 nvm 装一个。注意如果你在 conda 环境里nvm 可能会和 conda 的 PATH 打架建议先conda deactivate退出再操作。curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash source ~/.bashrc nvm install 22 nvm use 22 nvm alias default 22执行完再node -v确认一次看到 v22 就对了。这一步别省我见过太多人因为 Node 版本不对后面安装脚本反复失败。2.2 拿到 TaoToken 的 API Keyopenclaw 本身是个 agent 框架它需要调用大模型才能干活。TaoToken 在这里的角色是统一 Key/API 通道你只需要一个 Key就能在 openclaw 里接入多种模型服务不用为每个模型单独配一套凭证。先去控制台创建一个 API Key# 打开控制台创建 Key浏览器访问 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_linux创建后把 Key 复制下来形如sk-xxxxxxxx。这个 Key 后面要写进 openclaw 的 config.toml。API 的基础地址是https://taotoken.net/api注意这个地址不带任何查询参数直接作为 base_url 用。如果你对模型对话本身感兴趣可以先在模型对话页试试手感https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_linux3. 两条命令安装与启动 openclaw3.1 第一条命令安装网上流传的curl -fsSL https://openclaw.ai/install.sh | bash在部分网络环境下会卡在 npm 阶段原因是脚本内部会去拉 GitHub 上的依赖超时后自动重试看起来像死循环。更稳的做法是直接用 npm 装并且加上--ignore-scripts跳过 llama.cpp 的编译脚本——那个脚本在多数 Linux 机器上会因为缺少编译工具链而失败。npm install -g openclawlatest --ignore-scripts这条命令执行完openclaw就装好了。验证一下openclaw --version能输出版本号就说明安装成功。如果 npm 下载很慢是 GitHub 链接的问题可以临时配一下 git 的 URL 替换仅用于加速拉取不涉及任何网络代理工具git config --global url.https://ghproxy.com/https://github.com/.insteadOf https://github.com/3.2 第二条命令启动并进入配置引导老版本的openclaw init已经被移除现在用的是onboardopenclaw onboard --install-daemon这条命令会做两件事启动配置引导并把 openclaw 注册成后台守护进程。引导过程中会问你模型选择、API Key、工作目录等。模型那一步先随便选一个比如 qwen因为后面我们要在 config.toml 里统一改成走 TaoToken 通道。引导走完服务就起来了。如果你不想交互式引导也可以先跳过直接手写 config.toml然后手动启动openclaw start4. 配置 config.toml把模型通道指向 TaoToken4.1 config.toml 骨架openclaw 的配置文件默认在~/.openclaw/config.toml部分版本在~/.config/openclaw/config.toml。用编辑器打开写入下面这个骨架# ~/.openclaw/config.toml [server] host 127.0.0.1 port 8080 [model] # 统一走 TaoToken 通道 provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 model gpt-4o-mini [agent] workspace /home/你的用户名/openclaw-workspace log_level info几个关键点说明一下。provider用openai-compatible因为 TaoToken 的 API 是 OpenAI 兼容格式openclaw 能直接识别。base_url填https://taotoken.net/api不要加多余的路径。api_key换成你刚才在控制台创建的那个。model可以先填一个你账号下有权限的模型名后面验证通了再换。4.2 参数对照表配置项作用推荐值provider模型服务协议类型openai-compatiblebase_urlAPI 基础地址https://taotoken.net/apiapi_key鉴权密钥控制台创建的 sk- 开头 Keymodel默认调用的模型按账号权限选port本地服务端口8080workspaceagent 工作目录自定义绝对路径改完保存重启服务让配置生效openclaw restart5. 验证用 curl 确认服务真的通了配置写完不代表通了得实际发一个请求验证。openclaw 启动后会在本地监听一个端口上面配的是 8080先确认进程在openclaw status看到running就继续。然后直接用 curl 打 TaoToken 的 API验证 Key 和通道是否可用curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -H Content-Type: application/json \ -d { model: gpt-4o-mini, messages: [{role: user, content: 说一句你好}], max_tokens: 20 }如果返回类似下面的 JSON说明通道完全通了{ choices: [ { message: { role: assistant, content: 你好 } } ] }再验证 openclaw 本地服务是否正常转发curl -X POST http://127.0.0.1:8080/v1/chat/completions \ -H Content-Type: application/json \ -d {messages:[{role:user,content:test}]}本地这条能返回内容就说明 openclaw 已经成功通过 TaoToken 通道调到了模型。到这一步从安装到可用就全部跑通了。6. 常见报错排查6.1 npm 404clawbot 找不到npm ERR! 404 Not Found - GET https://registry.npmjs.org/clawbot - Not found这是包名过时了。项目已从 clawbot 改名为 openclaw把命令里的clawbot全部换成openclaw即可。6.2 安装脚本卡在 npm install failed→ Installing OpenClaw 2026.2.6-3... → npm install failed; cleaning up and retrying..这是安装脚本内部拉依赖超时。别用脚本直接npm install -g openclawlatest --ignore-scripts跳过 llama.cpp 编译。6.3 llama.cpp 安装失败npm ERR! Failed to install llama.cpp--ignore-scripts就是为这个准备的。加上它npm 不会执行包里的编译脚本安装能直接过。openclaw 的核心功能不依赖本地 llama.cpp 编译。6.4 init 命令不存在Error: unknown command init新版本移除了init改用openclaw onboard --install-daemon。如果你看到某篇教程还在写openclaw init那篇文档已经过时了。6.5 配置改了但模型没生效先确认改的是正确的配置文件路径再openclaw restart。如果还不行检查base_url是不是多写了/v1——TaoToken 的基础地址就是https://taotoken.net/api路径部分由 openclaw 自己拼。6.6 401 鉴权失败curl 返回 401说明 Key 不对或没带上。检查Authorization: Bearer sk-xxx里的 Key 是否和控制台创建的一致注意不要有多余空格。如果 Key 没问题去控制台确认这个 Key 有没有被禁用或额度耗尽。7. 接下来怎么走安装和启动这两条命令跑通之后openclaw 就已经是一个可用的 agent 服务了。如果你打算长期用它做编码或跑 Agent 任务建议把模型通道固定下来别每次换模型都改配置。TaoToken 的 Coding Plan 适合这种长期编码场景一个 Key 覆盖多种模型省去反复配凭证的麻烦https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_linux如果你更想先把模型对话调顺或者需要管理多个 Key 做分流可以分别看这两个入口# 模型对话 https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_linux # API Keys 管理 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_linux接入过程中如果遇到 openclaw 侧的配置问题官方接入文档里有更细的参数说明https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentopenclaw_linux最后提醒一句openclaw 的文档和包名变动比较快遇到命令报错先确认你参考的文档是不是对应最新版本。两条命令的核心逻辑不会变——装用 npm启动用 onboard剩下的就是把模型通道指向 TaoToken然后用 curl 验证一次。跑通之后后面换模型、加 Agent 都是在这个基础上叠加。