简介
OpenClaw 是一款开源的 AI Agent 工具。本文以 Linux 环境为例，详细记录 OpenClaw 的安装、初始化流程、模型选择、TUI 使用方式，以及 TUI 与 Web UI 认证不一致导致的常见问题与解决方法。
环境准备
- 安装 Node.js
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
验证版本：
node --version
# v22.22.0
- 安装 OpenClaw
npm install -g openclaw@latest
验证版本：
openclaw --version
# 2026.2.25
初始化 OpenClaw
运行初始化命令：
openclaw onboard --install-daemon
- 选择 QuickStart 模式快速启动。
- 模型选择：默认 Qwen 配置（qwen-portal）通常指向国际版 API，提供针对开发者的免费试用额度。后续可更换模型供应商。
- API 密钥配置：
- Google Places API：暂不需要，选否。
- Gemini API：暂不需要，选否。
- Notion API：暂不需要，选否。
- ElevenLabs API：暂不需要，选否。
完成基础配置后，继续下一步操作：
- 启用 Hooks：选择 session-memory，让 AI 记住之前的对话内容或项目上下文。
- 其他选项：根据需求跳过或配置。
- 配置 Skills：选择是。
- 渠道配置：暂时跳过，后续详细描述。
登录完成后回到控制台，选择具体模型，默认即可。随后浏览器会弹出登录页面，选择模型提供商（如 Qwen）以便快速跑通流程。
Web UI 配置
若 TUI 配置成功但 Web UI 报错，原因是 TUI 和 Web UI 使用两套完全独立的认证系统。需要将 Token 应用到页面上。
- 获取 Token
cat ~/.openclaw/openclaw.json | grep -o '"token": "[^"]*"'
# token: "YOUR_TOKEN_VALUE"
- 补充参数到页面
将提取的 Token 添加到 URL 参数中：token=YOUR_TOKEN_VALUE
注：如果访问 http://127.0.0.1:18789/ 会自动跳转，可使用 & 将参数补充在后面。
页面正常加载后，之前在控制台的聊天记录也会同步过来。
总结
本文在 Linux 下实现了 OpenClaw 的安装，并完成了基本流程的搭建。通过提取配置文件中的 Token 解决了 Web UI 认证问题，实现了本地 AI 代理的快速部署。
