简介
OpenClaw 是一款开源的 AI Agent 工具。本文以 Linux 环境为例，详细记录 OpenClaw 的安装、初始化流程、模型选择、TUI 使用方式，以及 TUI 与 Web UI 认证不一致导致的常见问题与解决方法。
环境准备
1. 安装 Node.js
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 install -g openclaw@latest
验证版本：
openclaw --version
# 2026.2.25
初始化 OpenClaw
运行初始化命令：
openclaw onboard --install-daemon
- 快速启动：选择 QuickStart。
- 登录方式说明：默认 Qwen 配置（qwen-portal）通常指向国际版 API，支持 Google 账号或 GitHub 账号登录，暂不支持支付宝或国内手机号直接登录。若无账号，需先注册一个账号。
- 模型选择：选择 Qwen 以降低门槛，利用国际版开发者免费试用额度（如每天 2000 次请求）。后续可更换模型供应商。
- API 密钥配置：
GOOGLE_PLACES_API_KEY：用于查询现实世界地点信息。若不使用 Google 服务，选否。GEMINI_API_KEY：用于 nano-banana-pro。若不使用 Google 服务，选否。NOTION_API_KEY：配置 Notion 权限。若不需要笔记功能，选否。ELEVENLABS_API_KEY：配置文本转语音（TTS）。若不需要语音交流，选否。
配置完成后进行回归测试，确认机器人支持中文交互。
接下来进入孵化小机器人步骤，推荐使用 TUI（Terminal UI）完成最后一步。
