前言
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
接着全局安装 OpenClaw：
npm install -g openclaw@latest
检查安装结果：
openclaw --version
# 2026.2.25
初始化 OpenClaw
运行初始化命令：
openclaw onboard --install-daemon
为了快速跑通，建议先选择 QuickStart。 这里会涉及几个配置项的选择：
- 登录方式：默认 Qwen 配置指向国际版 API，支持 Google 或 GitHub 账号登录。如果没有国内手机号登录需求，注册一个国际账号即可。选择 Qwen 是因为门槛低，且国际版通常提供针对开发者的免费试用额度。
- Google Places API：用于查询现实世界地点信息。如果暂时不需要此功能，选否。
- Gemini API：为名为 nano-banana-pro 的服务设置密钥。若不使用 Google Gemini 服务，选否。
- Notion API：配置 Notion 权限。Notion 是笔记协作软件，用不上则选否。
- ElevenLabs API：开启语音合成（TTS）。当前流程暂不需要语音交互，选否。
配置完成后，可以回归测试一下终端交互：
确认能正常对话后，需要进一步配置机器人行为，类似重新设定系统参数：
接下来询问是否启用 Hooks（插件），选择 session-memory 让 AI 记住之前的对话上下文，即使关闭终端也能延续话题：
后续选项如 Skills 等，建议先选'是'以启用基础技能，渠道配置可稍后处理，目标是先完成安装并跑通流程：
