前言
OpenClaw 是一款开源的 AI Agent 工具，但对于初次接触的用户来说，完整跑通流程可能并不直观。本文以 Linux 环境为例，详细记录 OpenClaw 的安装、初始化流程、模型选择、TUI 使用方式，以及 TUI 与 Web UI 认证不一致导致的常见问题与解决方法，帮助你最快速度把 OpenClaw 真正跑起来。
环境准备
1. 安装 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
2. 安装 OpenClaw
通过 npm 全局安装最新版：
npm install -g openclaw@latest
验证 CLI 版本：
openclaw --version
# 输出示例：2026.2.25
初始化 OpenClaw
运行初始化命令并启动守护进程：
openclaw onboard --install-daemon
1. 快速启动模式
为尽快跑通流程，建议先选择 QuickStart。
- 关于登录方式：作为开源工具，默认 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：赋予 OpenClaw 语音合成能力（TTS）。若仅需文字交流，选否。
配置完成后，可进行回归测试。界面应支持中文交互。
此时需要告诉机器人进行初始化配置，类似于重新设定系统参数。
