概述
OpenClaw 是一款开源的 AI Agent 工具，但对初次接触的用户来说，完整跑通流程并不直观。本文以 Linux 环境为例，详细记录 OpenClaw 的安装、初始化流程、模型选择，以及 TUI 与 Web UI 认证不一致导致的常见问题与解决方法，帮助你快速把 OpenClaw 真正跑起来。
环境准备
首先确保系统已安装 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
初始化配置
执行初始化命令并启动守护进程：
openclaw onboard --install-daemon
进入交互向导后，为了快速跑通流程，建议按以下逻辑选择：
- QuickStart：直接选择快速开始模式。
- 模型选择：默认 Qwen（qwen-portal）指向国际版 API，适合开发者快速上手，通常提供试用额度。后续可更换供应商，当前目标优先搭建环境。
- API Key 配置：
- Google Places API：若不使用地图服务或无法访问 Google 服务，选否。
- Gemini API：若不需要该特定模型，选否。
- Notion API：无需集成笔记功能，选否。
- ElevenLabs API：暂不启用语音合成，选否。
完成基础配置后，终端会显示机器人状态。此时界面可能会展示一些趣味动画（如终结者形象），这属于前端交互效果，不影响核心功能。
接下来询问是否启用 Hooks，建议选择 session-memory，让 AI 记住之前的对话内容或项目上下文，即使关闭终端再重新打开也能延续话题。其他选项如 Skills 等可根据实际需求后续配置，本次先跳过渠道配置，专注于完成安装和跑通流程。
登录成功后回到控制台，选择默认模型即可。浏览器会自动弹出登录页面，再次确认模型提供商为 Qwen 以便快速测试。
Web UI 配置与认证修复
如果在 TUI 中配置成功，但访问 Web UI 时一直报错，这是因为 TUI 和 Web UI 使用的是两套完全独立的认证系统。需要将 TUI 生成的 Token 应用到页面上。
获取 Token
在终端执行以下命令查看本地配置文件中的 token：
cat ~/.openclaw/openclaw.json | grep -o '"token": "[^"]*"'
# 输出示例："token": "7da3f004ff2a1e700f229a87fb5ea12c150b37d58199295f"
