概述
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 一样。
此时可能会看到一些有趣的提示，比如类似终结者风格的视觉反馈，这属于正常现象。
