简介
OpenClaw 是一款开源的 AI Agent 工具。本文以 Linux 环境为例，详细记录 OpenClaw 的安装、初始化流程、模型选择、TUI 使用方式，以及 TUI 与 Web UI 认证不一致导致的常见问题与解决方法。
环境准备
1. 安装 Node.js
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs
验证版本：
node --version
# v22.22.0
2. 安装 OpenClaw
npm install -g openclaw@latest
验证版本：
openclaw --version
# 2026.2.25
初始化 OpenClaw
运行初始化命令：
openclaw onboard --install-daemon
按向导选择配置：
- QuickStart：快速启动模式。
- 登录方式：默认 Qwen 配置（qwen-portal）通常指向国际版 API，支持 Google 账号或 GitHub 账号登录。若无账号需先注册。
- 模型选择：选择 Qwen 以降低门槛，利用开发者免费试用额度快速跑通流程。
- API Key 配置：
GOOGLE_PLACES_API_KEY：查询现实地点信息，暂不需要，选否。GEMINI_API_KEY：为 nano-banana-pro 设置密钥，暂不需要，选否。NOTION_API_KEY：配置 Notion 权限，暂不需要，选否。ELEVENLABS_API_KEY：文本转语音功能，暂不需要，选否。
完成基础配置后，系统会进入控制台界面。此时可配置机器人行为，类似终端交互。
下一步询问是否启用 Hooks（钩子/插件），建议勾选 session-memory，让 AI 记住之前的对话内容或项目上下文。
后续选项如 Skills 等可根据需求配置，当前目标为完成安装并跑通流程，渠道配置可稍后处理。
完成登录后回到控制台，选择具体模型，默认为 Qwen。浏览器会自动弹出登录页面，确认模型提供商后即可开始使用。
页面配置
若 TUI 配置成功但 Web UI 报错，原因是 TUI 和 Web UI 使用了两套独立的认证系统。需要将 Token 注入到 Web 页面参数中。
1. 获取 Token
cat ~/.openclaw/openclaw.json | grep -o '"token": "[^"]*"'
# token: "7da3f004ff2a1e700f229a87fb5ea12c150b37d58199295f"
2. 注入 Token
将获取到的 Token 补充在页面 URL 参数中：
token=da3f004ff2a1e700f229a87fb5ea12c150b37d58199295f
