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

简介

OpenClaw 是一款开源的 AI Agent 工具，对于初次接触的用户来说，完整跑通流程可能并不直观。本文以 Linux 环境为例，详细记录 OpenClaw 的安装、初始化流程、模型选择、TUI 使用方式，以及 TUI 与 Web UI 认证不一致导致的常见问题与解决方法，帮助你最快速度把 OpenClaw 真正跑起来。

环境准备

首先确保系统已安装 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 命令启动初始化向导：

openclaw onboard --install-daemon

配置选项说明

QuickStart：为快速跑通流程，建议直接选择 QuickStart 模式。
登录方式：默认 Qwen 配置（qwen-portal）通常指向国际版 API，因此支持 Google 账号或 GitHub 账号登录，暂不支持支付宝或国内手机号。若无相关账号，注册一个即可。
模型选择：选择 Qwen 是因为门槛较低，且国际版往往提供针对开发者的免费试用额度（如每天 2000 次请求）。后续可更换模型供应商，当前目标是快速搭建并跑通流程。
可选服务：
- GOOGLE_PLACES_API_KEY：用于查询现实世界地点信息。若不使用 Google 服务或不在当前流程范围内，选否。
- GEMINI_API_KEY：为 nano-banana-pro 设置密钥。若无法使用 Google 服务，选否。
- NOTION_API_KEY：配置 Notion 权限。Notion 是文档协作软件，若用不上则选否。
- ELEVENLABS_API_KEY：启用文本转语音（TTS）功能。若仅需文字交流，先选否。