概述
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 配置指向国际版 API，需使用 Google 或 GitHub 账号注册登录。
- 跳过非必要 API 配置（如 Google Places, Gemini, Notion, ElevenLabs），当前目标为搭建基础流程。
配置完成后进行回归测试，确认支持中文交互。
继续完成机器人孵化步骤，推荐使用 TUI（Terminal UI）。
启用 Hooks 时选择 session-memory，使 AI 能记住对话上下文。
后续选项（Skills 等）按需配置，此处先跳过渠道配置以优先完成安装。
在控制台选择具体模型，推荐默认配置。
浏览器弹出登录页面，选择模型提供商（如 Qwen）以便快速测试。
页面配置
TUI 配置成功后，Web UI 可能报错，原因是两者使用独立的认证系统。需将 Token 注入 Web UI 参数。
- 获取 Token
cat ~/.openclaw/openclaw.json | grep -o '"token": "[^"]*"'
# token: "7da3f004ff2a1e700f229a87fb5ea12c150b37d58199295f"
- 补充参数到页面 URL
格式：
token=7da3f004ff2a1e700f229a87fb5ea12c150b37d58199295f
注：若访问 http://127.0.0.1:18789/ 自动跳转，请使用 & 追加参数。
此时页面正常，且控制台聊天记录已同步。
