简介
OpenClaw 是一款开源的 AI Agent 工具，但对初次接触的用户来说，完整跑通流程并不直观。本文以 Linux 环境为例，详细记录了 OpenClaw 的安装、初始化流程、模型选择、TUI 使用方式，以及 TUI 与 Web UI 认证不一致导致的常见问题与解决方法，帮助你最快速度把 OpenClaw 真正跑起来。
环境准备
首先需要安装 Node.js。推荐使用 NodeSource 源安装较新版本：
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt install -y nodejs
安装完成后验证版本：
node --version
# v22.22.0
安装 OpenClaw
使用 npm 全局安装最新版：
npm install -g openclaw@latest
验证安装：
openclaw --version
# 2026.2.25
初始化配置
运行 onboard 命令启动初始化向导：
openclaw onboard --install-daemon
为了快速上手，建议按以下逻辑操作：
- QuickStart: 直接选择快速开始模式。
- 模型选择: 默认 Qwen 配置（qwen-portal）通常指向国际版 API，适合开发者试用（如每天 2000 次请求）。虽然国内手机号登录不可用，但支持 Google/GitHub 账号注册。当前目标是快速跑通，故选择 Qwen。
- API Key 配置:
GOOGLE_PLACES_API_KEY: 查询现实地点信息，暂不需要，选否。GEMINI_API_KEY: 为 nano-banana-pro 设置密钥，暂不需要，选否。NOTION_API_KEY: 配置 Notion 权限，暂不需要，选否。ELEVENLABS_API_KEY: 文本转语音功能，暂不需要，选否。
配置完成后进行回归测试，确认机器人能正常响应中文指令。
接下来进入孵化小机器人的步骤，推荐使用 TUI（终端界面）完成最后一步配置。
系统会询问是否启用 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"
- 应用 Token
将参数补充到页面 URL 中，例如：
token=7da3f004ff2a1e700f229a87fb5ea12c150b37d58199295f
注：如果访问 http://127.0.0.1:18789/ 会自动跳转，可使用 & 将参数追加在后面。
此时页面应恢复正常，且之前控制台的聊天记录也会同步过来。
总结
本文在 Linux 下实现了 OpenClaw 的安装和基本流程搭建。后续可根据实际需求进一步发掘更多功能。