1. 先搞清楚 OpenClaw 到底是个啥以及为什么要在 Ubuntu 上折腾它OpenClaw 是一个可以长期跑在你自己电脑或服务器上的 AI 助手程序和网页版对话工具最大的区别在于它是个常驻进程启动之后一直待命你随时可以调用它干活而不是每次都要打开浏览器重新开始。它适合谁适合想把 AI 能力接到自己工作流里的人比如自动处理消息、定时拉数据、调用接口做批处理这些事网页版做不了但一个跑在 Linux 上的常驻程序可以。为什么选 Ubuntu因为 OpenClaw 的官方 CLI 和后台守护进程在 Linux 环境下最稳Ubuntu 的 apt 包管理又足够简单小白照着敲命令基本不会卡在系统依赖上。Windows 不是不能跑但路径、权限、后台服务这几块容易出玄学问题第一遍搭建建议直接用 Ubuntu2 核 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 Planhttps://taotoken.net/coding-plan 它针对持续调用做了额度上的优化比按次计费更适合常驻程序。注意API Key 只在创建时完整显示一次关掉页面就看不到了建议先粘到本地记事本里备用。拿到 Key 之后你手里应该有三样东西一台能 SSH 的 Ubuntu 机器、一个 TaoToken API Key、以及下面要装的 Node.js 环境。这三样凑齐后面就是纯执行了。3. 从零配置 Ubuntu 环境与 Node.js 的完整可复制命令3.1 连上服务器并更新系统用 Xshell、FinalShell 或 Termius 连上你的 Ubuntu 机器成功后会看到类似rootserver:~#的提示符。第一件事是更新软件源sudo apt update sudo apt upgrade -y屏幕滚动大量文字是正常的别中断。更新完之后装基础工具OpenClaw 安装过程会用到 git、curl、unzipsudo apt install -y git curl unzip如果中途问 Y/n直接回车。3.2 用 nvm 装 Node.js 18这一步是关键Node 版本不对后面一定失败。先装 nvmcurl -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 初始化并启动核心服务这一步最容易卡很多人失败是因为中途 CtrlC 或者跳过了。执行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 打不开分两种情况。本地机器上打不开检查命令是否还在前台运行CtrlC 会把它停掉。云服务器上打不开先确认安全组放行了端口再检查系统防火墙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测试确认链路没断再去做别的。这个习惯帮我省了很多“以为在跑其实早就挂了”的时间。
