Ubuntu 安装 OpenClaw：本地 AI 工作流第二步

Ubuntu 安装 OpenClaw：本地 AI 工作流第二步

上一篇完成了 Ollama 本地模型服务。本篇继续把 OpenClaw 安装起来，让你在本机获得一个可交互、可扩展的 AI 工作流入口。

安装目标

本篇完成后你将具备：

• 可用的 Node.js 运行时（OpenClaw 依赖）
• 已安装的 OpenClaw CLI
• 可访问的本地界面（默认 http://localhost:3000）

1) 安装 Node.js

OpenClaw 需要较新的 Node.js（建议 22+）。

sudo apt update
sudo apt install -y nodejs npm

验证版本：

node -v
npm -v

2) 安装 OpenClaw

使用 npm 全局安装：

npm install -g openclaw

检查安装结果：

openclaw --version

3) 启动 OpenClaw

openclaw

启动后在浏览器访问：

http://localhost:3000

首次打开页面时，通常会要求输入 Token。这个是正常的安全校验流程，不是启动失败。

3.1 获取并填写 Token

1. 保持 openclaw 进程在终端前台运行。
2. 在终端输出中查找启动日志里的 Token（通常会有类似“token”或“auth token”的提示）。
3. 复制该 Token，粘贴到浏览器登录框完成验证。

如果你关闭了终端或忘记了 Token，最简单的方法是直接查看本地配置文件 ~/.openclaw/openclaw.json，在 gateway.auth.token 字段中获取当前 Token（不要把该值提交到仓库或公开截图）。

完成 Token 验证后，能正常进入控制台即表示 OpenClaw 主进程运行正常。

常见问题

命令找不到

若提示 openclaw: command not found，通常是 npm 全局 bin 路径未加入环境变量，检查 npm config get prefix 与 PATH 配置。

端口被占用

如果 3000 被占用，先释放端口或在 OpenClaw 配置中调整启动端口。

Node 版本过低

旧版本 Node 会导致依赖安装失败或运行异常，建议升级到 LTS 新版本后重试。

浏览器要求 Token

这是 OpenClaw 的默认鉴权行为。优先检查：

• openclaw 启动日志是否有输出 Token
• 是否复制了完整 Token（避免首尾空格）
• 是否在同一次启动会话内使用该 Token（重启后旧 Token 可能失效）

小结

至此你已经在 Ubuntu 完成 OpenClaw 安装并启动。下一篇我们会把 OpenClaw 与本地 Ollama 连接起来，完成真正可用的本地 AI Agent 链路。