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

简介

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

为了快速上手，建议按以下逻辑操作：

1. QuickStart: 直接选择快速开始模式。
2. 模型选择: 默认 Qwen 配置（qwen-portal）通常指向国际版 API，适合开发者试用（如每天 2000 次请求）。虽然国内手机号登录不可用，但支持 Google/GitHub 账号注册。当前目标是快速跑通，故选择 Qwen。
3. API Key 配置:
   • GOOGLE_PLACES_API_KEY: 查询现实地点信息，暂不需要，选否。
   • GEMINI_API_KEY: 为 nano-banana-pro 设置密钥，暂不需要，选否。
   • NOTION_API_KEY: 配置 Notion 权限，暂不需要，选否。
   • ELEVENLABS_API_KEY: 文本转语音功能，暂不需要，选否。

配置完成后进行回归测试，确认机器人能正常响应中文指令。

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

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