Linux 下 OpenClaw 快速安装、初始化与 Web UI 配置指南

OpenClaw 是一款开源的 AI Agent 工具，但对于初次接触的用户来说，完整跑通流程可能并不直观。本文以 Linux 环境为例，详细记录安装、初始化流程、模型选择、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 install -g openclaw@latest

检查安装后的版本信息：

openclaw --version
# 输出示例：2026.2.25

初始化 OpenClaw

执行初始化命令并启动守护进程：

openclaw onboard --install-daemon

交互配置说明

进入初始化向导后，建议按以下逻辑选择以快速跑通流程：

QuickStart：直接选择快速启动模式。
登录方式：默认 Qwen 配置（qwen-portal）通常指向国际版 API，支持 Google 或 GitHub 账号登录。若没有相关账号，需先注册一个。选择 Qwen 是因为门槛较低，且国际版往往提供针对开发者的免费试用额度（如每天 2000 次请求），适合快速搭建。
Google Places API：询问是否配置用于查询现实世界地点信息的 API。如果当前不需要该功能或无法访问 Google 服务，选否。
Gemini API Key：询问是否为 nano-banana-pro 设置密钥。同样，若无需使用此特定模型或无法访问，选否。
Notion API Key：Notion 是笔记和协作软件，若暂不需要集成，选否。
ElevenLabs API Key：用于文本转语音（TTS）。若只需文字交流，暂时选否。