简介
OpenClaw 是一款开源的 AI Agent 工具,但对初次接触的用户来说,完整跑通流程并不直观。本文以 Linux 环境为例,详细记录了 OpenClaw 的安装、初始化流程、模型选择、TUI 使用方式,以及 TUI 与 Web UI 认证不一致导致的常见问题与解决方法,帮助你最快速度把 OpenClaw 真正跑起来。
环境准备
首先需要安装 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
安装 OpenClaw
使用 npm 全局安装最新版:
npm install -g openclaw@latest
验证安装:
openclaw --version
# 2026.2.25
初始化配置
运行 onboard 命令启动初始化向导:
openclaw onboard --install-daemon
为了快速上手,建议按以下逻辑操作:
- QuickStart: 直接选择快速开始模式。
- 模型选择: 默认 Qwen 配置(qwen-portal)通常指向国际版 API,适合开发者试用(如每天 2000 次请求)。虽然国内手机号登录不可用,但支持 Google/GitHub 账号注册。当前目标是快速跑通,故选择 Qwen。
- API Key 配置:
GOOGLE_PLACES_API_KEY: 查询现实地点信息,暂不需要,选否。GEMINI_API_KEY: 为 nano-banana-pro 设置密钥,暂不需要,选否。NOTION_API_KEY: 配置 Notion 权限,暂不需要,选否。ELEVENLABS_API_KEY: 文本转语音功能,暂不需要,选否。
配置完成后进行回归测试,确认机器人能正常响应中文指令。

接下来进入孵化小机器人的步骤,推荐使用 TUI(终端界面)完成最后一步配置。

系统会询问是否启用 Hooks(插件),建议选择 session-memory,让 AI 记住之前的对话内容或项目上下文,即使关闭终端也能延续话题。后续选项如无特殊需求可全选跳过。








