前言
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 记住之前的对话内容或项目上下文，即使关闭终端重新打开也能延续话题。
