简介
OpenClaw 是一款开源的 AI Agent 工具，但对初次接触的用户来说，完整跑通流程并不直观。本文以 Linux 环境为例，详细记录了安装、初始化流程、模型选择，以及解决 TUI 与 Web UI 认证不一致导致的问题，帮助你快速部署。
环境准备
首先确保已安装 Node.js 环境。推荐使用 v22.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
执行初始化命令：
openclaw onboard --install-daemon
配置向导说明
运行初始化后，会进入交互式配置。以下是关键选项的处理建议：
- QuickStart: 选择快速启动模式，适合首次体验。
- 登录方式: 默认 Qwen 配置指向国际版 API，通常支持 Google 或 GitHub 账号登录，暂不支持支付宝或国内手机号。若无相关账号，需提前注册。选择 Qwen 是因为门槛较低且常提供开发者免费试用额度。
- Google Places API: 用于查询现实地点信息（如餐馆、影院）。若无需此功能或无法访问 Google 服务，选否。
- Gemini API Key: 为
nano-banana-pro设置密钥。若不使用该模型，选否。 - Notion API Key: 集成 Notion 笔记功能。暂不需要可跳过。
- ElevenLabs API Key: 启用文本转语音（TTS）功能。当前阶段先选否，后续可按需开启。
配置完成后，系统会提示回归测试。此时终端界面应能正常进行中文对话。
接下来需要孵化'小机器人'，推荐直接使用 TUI（Terminal UI）完成最后一步。
关于 Hooks（钩子/插件），建议启用 session-memory，让 AI 记住之前的对话内容或项目上下文，即使关闭终端也能延续话题。其他选项可视需求选择，初期建议先跳过。
