概述
OpenClaw 是一款开源的 AI Agent 工具，但对初次接触的用户来说，完整跑通流程并不直观。本文以 Linux 环境为例，详细记录安装、初始化流程、模型选择策略，以及 TUI 与 Web UI 认证不一致导致的常见问题与解决方法，帮助你最快速度把 OpenClaw 真正跑起来。
环境准备
首先确保系统已安装 Node.js。推荐使用 LTS 版本，这里演示使用 Node 22.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
初始化配置
运行 onboard 命令启动初始化向导，并安装守护进程：
openclaw onboard --install-daemon
1. 基础模型选择 为了快速跑通，建议先选择 QuickStart。关于登录方式，由于 OpenClaw 作为开源工具，默认的 Qwen 配置（qwen-portal）通常指向国际版 API，因此支持 Google 账号或 GitHub 账号登录，暂不支持支付宝或国内手机号直接登录。如果没有相关账号，注册一个即可。
选择 Qwen 是因为门槛低且国际版往往提供针对开发者的免费试用额度（如每天 2000 次请求）。后续可以更换模型供应商，当前的目标是快速搭建并跑通流程。
2. 可选服务配置 接下来会询问是否配置其他第三方服务，根据实际需求选择：
- Google Places API：用于查询现实世界地点信息（如电影院、餐馆）。若不使用 Google 服务，选否。
- Gemini API Key：为
nano-banana-pro设置密钥。若无需该功能，选否。 - Notion API Key：配置 Notion 权限。Notion 是笔记和任务管理工具，若用不上，选否。
- ElevenLabs API Key：启用语音合成（TTS）功能。若当前只需文字交流，选否。
配置完成后，回归测试一下终端交互效果。
能说中文后，需要告诉机器人如何初始化，就像配置 TAS 一样。
此时可能会看到一些有趣的提示，比如类似终结者风格的视觉反馈，这属于正常现象。
继续完成孵化小机器人的步骤，推荐直接使用 TUI（Terminal UI）完成最后一步。
3. 插件与技能
- Hooks (钩子)：选择
session-memory，让 AI 记住之前的对话内容或项目上下文，即使关闭终端再打开也能延续话题。 - 其他选项：大部分可以先全选否，后续按需开启。
- Skills：选择'是'以启用技能模块。
- 渠道：这一步后面会详细描述，目前目标先完成安装，暂时跳过。
完成登录后回到控制台，选择具体模型，默认即可。
浏览器会自动弹出登录页面，选择模型提供商，为了快速测试，直接选择 Qwen 方便跑通流程。
Web UI 配置
如果 TUI 配置成功了，但在 Web UI 一直报错，这是因为 TUI 和 Web UI 使用的是两套完全独立的认证系统。需要将 Token 应用到页面上才能打通。
1. 获取 Token 在终端执行以下命令提取本地 Token：
cat ~/.openclaw/openclaw.json | grep -o '"token": "[^"]*"'
# 输出示例："token": "7da3f004ff2a1e700f229a87fb5ea12c150b37d58199295f"
2. 注入参数 将提取到的 token 补充到 Web 页面的参数中。例如：
token=7da3f004ff2a1e700f229a87fb5ea12c150b37d58199295f
注：如果访问 http://127.0.0.1:18789/ 会有自动跳转，可以使用 & 将参数补充在后面。
页面恢复正常后，之前在控制台的聊天记录也会同步过来。
总结
本文在 Linux 下实现了 OpenClaw 的安装，完成了基本流程的搭建。至于后续发掘更多功能，可基于此基础继续探索。
