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

OpenClaw 部署指南

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

检查 CLI 版本确认安装成功：

openclaw --version
# 输出示例：2026.2.25

初始化与交互配置

运行 onboard 命令启动初始化向导，建议先选择 QuickStart 模式以快速跑通流程。

openclaw onboard --install-daemon

在交互过程中，你可能会遇到以下常见疑问：

• 为何没有支付宝或手机号登录？ 默认 Qwen 配置指向国际版 API，通常支持 Google 或 GitHub 账号登录。若无相关账号，可注册一个即可。
• 为何选择 Qwen？ 该模型门槛较低且国际版常提供开发者免费试用额度，适合快速搭建环境。后续可在设置中更换供应商。
• 是否配置 Google Places API？ 用于查询现实地点信息（如餐馆、影院）。若当前无需此类功能，选否。
• 是否配置 Gemini API？ 对应 nano-banana-pro 功能。若暂不使用，选否。
• 是否配置 Notion API？ Notion 是笔记协作软件，非核心依赖，选否。
• 是否配置 ElevenLabs API？ 用于文本转语音（TTS）功能。若仅需文字交流，选否。

完成基础配置后，继续按提示操作：

1. 角色设定：根据界面提示配置机器人行为，类似重新初始化系统参数。
2. 终端交互：选择使用 TUI（Terminal UI）完成最后一步孵化。
3. 插件启用：询问是否启用 Hooks。建议选择 session-memory，让 AI 记住对话上下文，即使关闭终端也能延续话题。