OpenClaw 是一款开源的 AI Agent 工具，但在 Linux 环境下完整跑通流程需要一些细致的配置。本文记录了从环境准备到初始化、模型选择，以及解决 TUI 与 Web UI 认证不一致问题的全过程。
环境准备
首先确保系统已安装 Node.js。推荐使用 v22.x 版本：
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt install -y nodejs
验证安装结果：
node --version
# 输出示例：v22.22.0
接着通过 npm 全局安装 OpenClaw：
npm install -g openclaw@latest
确认版本信息：
openclaw --version
# 输出示例：2026.2.25
初始化配置
运行 onboard 命令启动初始化向导，并安装守护进程：
openclaw onboard --install-daemon
在交互过程中，为了快速验证功能，建议按以下逻辑选择：
- QuickStart：直接选择快速启动模式。
- 模型选择：默认 Qwen 配置（qwen-portal）通常指向国际版 API，适合开发者试用。若需国内手机号登录，后续可切换供应商。
- API Key 配置：
- Google Places API：暂不需要，选否。
- Gemini API：暂不需要，选否。
- Notion API：非核心依赖，选否。
- ElevenLabs API：语音合成非当前目标，选否。
完成基础配置后，进入终端界面（TUI）进行进一步设置。此时机器人已支持中文交互，可根据提示继续配置。
高级选项
- Hooks（钩子）：推荐启用
session-memory，让 AI 记住上下文，即使关闭终端也能延续话题。 - Skills（技能）：根据需求开启，初期建议先跳过渠道配置，聚焦核心流程。
- 模型提供商：在控制台选择默认模型即可，后续可在 Web UI 中调整。
Web UI 配置与认证修复
完成 TUI 登录后，浏览器会自动弹出 Web UI 页面。初次访问时可能会遇到认证报错，这是因为 TUI 和 Web UI 使用了两套独立的认证系统。
要解决这个问题，需要将 TUI 生成的 Token 注入到 Web UI 请求中。
获取 Token
执行以下命令查看本地配置文件中的 Token：
cat ~/.openclaw/openclaw.json | grep -o '"token": "[^"]*"'
输出类似：
"token": "<YOUR_TOKEN>"
应用 Token
将提取到的 Token 追加到访问地址参数中。例如：
http://127.0.0.1:18789/?token=<YOUR_TOKEN>
如果访问根路径自动跳转，使用 & 符号连接参数即可。配置完成后，Web UI 应能正常加载，且同步之前的聊天记录。
结语
至此，OpenClaw 在 Linux 下的基础环境搭建完毕。后续可根据实际需求扩展模型供应商或集成更多插件。