Linux 下 OpenClaw 安装、初始化及 Web UI 配置指南

Linux 下 OpenClaw 安装、初始化及 Web UI 配置指南

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

初始化配置

运行 onboard 命令启动初始化向导：

openclaw onboard --install-daemon

基础选项说明

1. QuickStart：为了快速跑通流程，直接选择 QuickStart。
2. 登录方式：默认配置指向国际版 API（如 Qwen-Portal），通常支持 Google 或 GitHub 账号登录，暂不支持支付宝或国内手机号。若无账号，注册一个即可。
3. 模型选择：Qwen 门槛较低且常提供开发者免费试用额度，适合快速搭建。后续可更换供应商。
4. 可选服务：
   • Google Places API：用于查询现实地点信息，若不使用 Google 服务可跳过。
   • Gemini API：用于特定模型调用，非必需，选否。
   • Notion API：用于笔记管理，当前流程不需要，选否。
   • ElevenLabs API：用于语音合成（TTS），暂时不需要，选否。

配置完成后，建议回归测试一下终端交互效果。

TUI 进阶设置

接下来进入机器人孵化流程，推荐直接使用 TUI（Terminal UI）完成最后一步配置。

1. Hooks：询问是否启用插件。建议选择 session-memory，让 AI 记住之前的对话内容或项目上下文，即使关闭终端也能延续话题。
2. 其他插件：其余选项先全选否，后续可按需补充。
3. Skills：选择'是'以配置技能集。
4. 渠道：此处先跳过，后续会详细描述，当前目标是完成安装并跑通流程。

完成登录后回到控制台，选择具体模型，默认配置即可。随后浏览器会自动弹出登录页面。