简介
OpenClaw 是一款开源的 AI Agent 工具，对于初次接触的用户来说，完整跑通流程可能并不直观。本文以 Linux 环境为例，详细记录 OpenClaw 的安装、初始化流程、模型选择、TUI 使用方式，以及 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 命令启动初始化向导：
openclaw onboard --install-daemon
配置选项说明
- QuickStart：为快速跑通流程，建议直接选择 QuickStart 模式。
- 登录方式：默认 Qwen 配置（qwen-portal）通常指向国际版 API，因此支持 Google 账号或 GitHub 账号登录，暂不支持支付宝或国内手机号。若无相关账号，注册一个即可。
- 模型选择：选择 Qwen 是因为门槛较低，且国际版往往提供针对开发者的免费试用额度（如每天 2000 次请求）。后续可更换模型供应商，当前目标是快速搭建并跑通流程。
- 可选服务：
GOOGLE_PLACES_API_KEY：用于查询现实世界地点信息。若不使用 Google 服务或不在当前流程范围内，选否。GEMINI_API_KEY：为 nano-banana-pro 设置密钥。若无法使用 Google 服务，选否。NOTION_API_KEY：配置 Notion 权限。Notion 是文档协作软件，若用不上则选否。ELEVENLABS_API_KEY：启用文本转语音（TTS）功能。若仅需文字交流，先选否。
配置完成后，终端会显示欢迎界面，确认机器人已能正常响应中文指令。
接下来需要告诉机器人如何'孵化'，推荐直接使用 TUI（Terminal UI）完成最后一步。
高级设置
- Hooks（钩子）：选择
session-memory，让 AI 记住之前的对话内容或项目上下文，即使关闭终端再重新打开，也能延续话题。 - 其他插件：除
skills外，其余选项可视需求跳过，建议先完成基础安装。 - 渠道配置：此处暂时跳过，后续会在 Web UI 中详细描述。
完成登录后回到控制台，选择具体模型，默认配置即可。
浏览器会自动弹出登录页面，选择模型提供商（为快速测试，推荐 Qwen）。
Web UI 配置与问题排查
部分用户反馈 TUI 配置成功后，Web UI 仍报错。这是因为 TUI 和 Web UI 使用的是两套完全独立的认证系统。需要将 TUI 生成的 token 应用到页面上。
获取 Token
在终端执行以下命令提取 token：
cat ~/.openclaw/openclaw.json | grep -o '"token": "[^"]*"'
# 输出示例："token": "7da3f004ff2a1e700f229a87fb5ea12c150b37d58199295f"
应用 Token
将提取到的 token 补充到 Web UI 页面的参数中：
token=7da3f004ff2a1e700f229a87fb5ea12c150b37d58199295f
访问 http://127.0.0.1:18789/ 时，如果发生自动跳转，可使用 & 将参数追加在 URL 后面：
http://127.0.0.1:18789/?token=...
配置完成后，页面应恢复正常，且之前在控制台的聊天记录也会同步过来。
总结
本文在 Linux 下实现了 OpenClaw 的安装，并完成了基本流程的搭建。至于后续发掘更多功能，可根据实际需求进一步探索。
