1. 先搞清楚 OpenClaw 到底是个啥，以及为什么要在 Ubuntu 上折腾它
OpenClaw 是一个可以长期跑在你自己电脑或服务器上的 AI 助手程序，和网页版对话工具最大的区别在于：它是个常驻进程，启动之后一直待命，你随时可以调用它干活，而不是每次都要打开浏览器重新开始。它适合谁？适合想把 AI 能力接到自己工作流里的人，比如自动处理消息、定时拉数据、调用接口做批处理，这些事网页版做不了，但一个跑在 Linux 上的常驻程序可以。
为什么选 Ubuntu？因为 OpenClaw 的官方 CLI 和后台守护进程在 Linux 环境下最稳，Ubuntu 的 apt 包管理又足够简单，小白照着敲命令基本不会卡在系统依赖上。Windows 不是不能跑，但路径、权限、后台服务这几块容易出玄学问题，第一遍搭建建议直接用 Ubuntu，2 核 CPU + 4G 内存的云服务器就够，本地虚拟机也行。
这篇教程的目标就一个：不报错、不理解原理也没关系，先把第一个 OpenClaw 实例跑起来。整条路径分三段——Linux 环境准备、Node.js/npm 安装、项目启动与验证。我会把每一步的命令、预期输出、以及卡住时该看哪里都写清楚，你照着复制粘贴就能走完。
2. 动手前先把 TaoToken 的 Key 和接入信息准备好
OpenClaw 本身是个壳，它要调用大模型才能干活，所以你需要一个能用的 API 入口。我这边一直用 TaoToken 来做模型接入，它的 API 地址是 https://taotoken.net/api ，兼容常见的 OpenAI 风格调用方式，配置起来不用改太多东西。你先把 Key 拿到手，后面 OpenClaw 初始化时会用到。
具体操作：打开 https://taotoken.net/api-keys ，登录后创建一个 API Key，复制出来存好，注意别泄露。如果你还没想好要用哪个模型，可以先到 https://taotoken.net/models 看看当前支持的模型列表，选一个适合日常对话或编码的就行。对于长期跑编码任务或者 Agent 场景，可以了解一下 Coding Plan：https://taotoken.net/coding-plan ，它针对持续调用做了额度上的优化，比按次计费更适合常驻程序。
注意：API Key 只在创建时完整显示一次，关掉页面就看不到了，建议先粘到本地记事本里备用。
拿到 Key 之后，你手里应该有三样东西：一台能 SSH 的 Ubuntu 机器、一个 TaoToken API Key、以及下面要装的 Node.js 环境。这三样凑齐，后面就是纯执行了。
3. 从零配置 Ubuntu 环境与 Node.js 的完整可复制命令
3.1 连上服务器并更新系统
用 Xshell、FinalShell 或 Termius 连上你的 Ubuntu 机器，成功后会看到类似root@server:~#的提示符。第一件事是更新软件源：
sudo apt update sudo apt upgrade -y屏幕滚动大量文字是正常的，别中断。更新完之后装基础工具，OpenClaw 安装过程会用到 git、curl、unzip：
sudo apt install -y git curl unzip如果中途问 Y/n，直接回车。
3.2 用 nvm 装 Node.js 18
这一步是关键，Node 版本不对后面一定失败。先装 nvm：
curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash source ~/.bashrc然后用 nvm 安装 Node 18 并设为默认：
nvm install 18 nvm use 18 nvm alias default 18验证一下：
node -v npm -v预期看到v18.x.x和9.x.x这样的输出。如果不是 18，回到nvm install 18重来。
3.3 安装 OpenClaw CLI
用 npm 全局安装：
npm install -g openclaw等 1 到 2 分钟，完成后检查版本：
openclaw --version能看到版本号就说明 CLI 装好了。如果提示command not found，多半是 npm 全局路径没进 PATH，执行npm config get prefix看看路径，再把它加到~/.bashrc里。
3.4 初始化并启动核心服务
这一步最容易卡，很多人失败是因为中途 Ctrl+C 或者跳过了。执行：
openclaw onboard --install-daemon它会做三件事：创建运行配置、启动 Gateway 核心服务、把 OpenClaw 注册成后台常驻程序。中途有提示直接回车。初始化过程中会要求填 API 信息，把 TaoToken 的地址https://taotoken.net/api和你的 Key 填进去。
完成后检查服务状态：
openclaw gateway status看到status: running就成功了。如果不是 running，看日志：
openclaw gateway logs小白最常见的原因就三个：Node 版本不对、上一步没跑完、中途被打断。回到 3.4 重来一次即可。
3.5 打开 Dashboard 控制台
OpenClaw 自带网页控制台：
openclaw dashboard看到Dashboard running on http://localhost:xxxx就说明起来了。如果你在云服务器上，需要在浏览器访问http://服务器IP:端口，记得在云服务器安全组里放行对应端口，本机防火墙也别拦。
4. 验证请求是否真的跑通：从命令行到 Dashboard 的实测动作
光看status: running还不够，得实际发一次请求确认模型能通。OpenClaw 提供了命令行对话入口，直接跑：
openclaw chat "你好，请用一句话介绍你自己"如果配置正确，你会看到模型返回的内容。这一步能通，说明从 OpenClaw 到 TaoToken 再到模型这条链路是活的。如果报错，重点看两个地方：一是openclaw gateway logs里的错误信息，二是确认 API Key 和地址有没有填错。
再验证一下 Dashboard。浏览器打开控制台地址后，你应该能看到服务状态、已加载的 Skill 列表、以及对话入口。在 Dashboard 里发一条消息，如果也能收到回复，说明前后端都正常。
到这里，你实际上已经完成了：装好 Node.js、装好 OpenClaw、初始化 Agent、启动核心服务、打开管理界面。哪怕你完全不懂 Agent 原理，这套跑通已经超过很多人了。
5. 本篇常见报错排查：command not found、gateway 不是 running、dashboard 打不开
报错一：openclaw: command not found说明 npm 全局包路径没生效。先确认npm -v能正常输出，然后执行npm config get prefix，把返回的路径加到~/.bashrc的 PATH 里，再source ~/.bashrc。如果npm -v本身就找不到，说明 Node 没装好，回到 3.2 重装。
报错二：gateway status不是 running先看日志openclaw gateway logs。如果是 Node 版本问题，日志里会有版本不兼容的提示，用nvm use 18切回去再重新 onboard。如果是端口被占用，日志会显示 bind 失败，换个端口或者杀掉占用进程。如果是 onboard 没跑完，直接重新执行openclaw onboard --install-daemon。
报错三：Dashboard 打不开分两种情况。本地机器上打不开，检查命令是否还在前台运行，Ctrl+C 会把它停掉。云服务器上打不开，先确认安全组放行了端口，再检查系统防火墙sudo ufw status，必要时sudo ufw allow 端口。另外确认你访问的是http://而不是https://，本地 Dashboard 默认不走 TLS。
报错四：chat 命令返回鉴权失败多半是 API Key 填错或者地址写成了带路径的完整 URL。TaoToken 的 API 地址就是https://taotoken.net/api，不要在后面多加/v1之类的后缀，具体以接入文档为准：https://taotoken.net/doc 。Key 如果泄露过，到 https://taotoken.net/api-keys 重新生成一个。
6. 跑通之后：把 OpenClaw 接进日常工作的下一步
第一个实例跑起来之后，你可以开始加 Skill 了。Skill 就是 OpenClaw 能做的事列表，比如查信息、发消息、调接口、读数据，它不会乱做事，只能做你允许的 Skill。刚开始不用自己写，先用官方自带的练手。
如果你打算让它长期跑编码或 Agent 任务，建议把模型调用切到 Coding Plan，额度更耐用：https://taotoken.net/coding-plan 。日常调试模型效果可以直接用模型对话页面：https://taotoken.net/chat 。需要管理多个 Key 或查看用量，控制台在 https://taotoken.net/console 。
我自己的习惯是：每次改完配置先跑一次openclaw gateway status和一条openclaw chat测试，确认链路没断再去做别的。这个习惯帮我省了很多“以为在跑其实早就挂了”的时间。
