前言
OpenClaw 是一款开源的 AI Agent 工具，但对于初次接触的用户来说，完整跑通流程并不直观。本文以 Linux 环境为例，详细记录安装、初始化流程、模型选择、TUI 使用方式，以及 TUI 与 Web UI 认证不一致导致的常见问题与解决方法，帮助你最快速度把 OpenClaw 真正跑起来。
环境准备
首先确保系统已安装 Node.js。推荐使用较新版本以获得更好的兼容性。
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
运行初始化命令启动守护进程：
openclaw onboard --install-daemon
进入向导后，为了快速上手，建议直接选择 QuickStart。关于常见选项的配置逻辑如下：
- 登录方式：默认配置通常指向国际版 API，可能不支持支付宝或国内手机号登录，建议使用 Google 账号或 GitHub 账号注册。
- 模型选择：初期建议选择 Qwen，门槛较低且国际版往往提供针对开发者的免费试用额度，便于快速验证流程。后续可更换供应商。
- Google Places API：用于查询现实世界地点信息。若当前无需此功能，选否。
- Gemini API：为特定模型设置密钥。暂不需要则选否。
- Notion API：配置笔记权限。非必需项，选否。
- ElevenLabs API：启用文本转语音（TTS）。暂时跳过，后续按需开启。
配置完成后，进行回归测试。此时终端应能正常进行中文对话。
接下来需要告诉机器人如何'孵化'。直接选择推荐方式，使用 TUI（Terminal UI）完成最后一步配置。
系统会询问是否启用 Hooks（插件），建议选择 session-memory，让 AI 记住之前的对话内容或项目上下文，即使关闭终端重新打开也能延续话题。
后续选项如渠道配置等，若暂时不需要可先跳过，目标是先完成安装并跑通流程。
完成登录后回到控制台，选择具体模型，默认即可。随后浏览器会自动弹出登录页面。
模型提供商选择 Qwen 以便快速测试。
页面配置与认证修复
如果在 TUI 配置成功后，访问 Web UI 一直报错，通常是因为 TUI 和 Web UI 使用的是两套完全独立的认证系统。需要将 TUI 生成的 Token 应用到页面上。
-
获取 Token 从本地配置文件中提取 Token：
cat ~/.openclaw/openclaw.json | grep -o '"token": "[^"]*"'输出示例：
"token": "7da3f004ff2a1e700f229a87fb5ea12c150b37d58199295f" -
注入 Token 将提取到的 Token 补充到 Web 页面参数中，格式为
token=你的 Token。
注：如果访问
http://127.0.0.1:18789/会自动跳转，请使用&将参数追加在 URL 后面。
页面恢复正常后，之前在控制台的聊天记录也会同步过来。
总结
本文在 Linux 下实现了 OpenClaw 的安装，完成了基本流程的搭建。后续可根据需求进一步发掘更多功能。
