概述
OpenClaw 是一款开源 AI Agent 工具。对于初次接触的用户，完整跑通流程可能不够直观。本文基于 Linux 环境，详细记录安装、初始化流程、模型选择，以及 TUI 与 Web UI 认证不一致导致的常见问题与解决方法。
环境准备
首先确保系统已安装 Node.js。推荐使用 v22 版本。
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 onboard --install-daemon
进入向导后，建议按以下步骤操作：
- 快速启动：选择 QuickStart 模式以最快体验核心功能。
- 模型选择：默认配置指向国际版 API（如 Qwen）。由于国内手机号或支付宝登录通常受限，建议使用 Google 或 GitHub 账号注册。Qwen 对开发者友好，且常提供试用额度，适合快速搭建。后续可更换供应商。
- 可选服务：
- Google Places API：用于查询现实地点信息。若无需此功能或无法访问 Google 服务，选否。
- Gemini API：为特定模型设置密钥。暂不需要则选否。
- Notion API：集成笔记管理。非当前需求，选否。
- ElevenLabs API：启用语音合成（TTS）。暂时跳过，先聚焦文本交互。
配置完成后，可通过终端查看机器人状态。此时基本配置已结束，下一步将使用 TUI（终端用户界面）完成孵化。
关于插件与钩子（Hooks）：
- Session Memory：建议选择。这能让 AI 记住对话上下文，即使关闭终端也能延续话题。
- 其他插件：如无特殊需求，可暂时跳过。
- Skills：建议开启，以增强能力。
- 渠道配置：此处可稍后处理，优先保证安装跑通。
登录成功后，在控制台选择默认模型提供商（推荐 Qwen），浏览器会自动弹出登录页面。完成登录后，安装即告完成。
解决 TUI 与 Web UI 认证不一致问题
如果在 TUI 中配置成功，但访问 Web UI 时一直报错，原因是两者使用了独立的认证系统。需要将 TUI 生成的 Token 注入到 Web UI 中。
- 获取 Token 从配置文件读取 Token：
cat ~/.openclaw/openclaw.json | grep -o '"token": "[^"]*"'
输出类似："token": "7da3f004ff2a1e700f229a87fb5ea12c150b37d58199295f"
