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

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

确认版本信息：

openclaw --version
# 输出示例：2026.2.25

初始化配置

运行 onboard 命令启动初始化向导，并安装守护进程：

openclaw onboard --install-daemon

在交互过程中，为了快速验证功能，建议按以下逻辑选择：

1. QuickStart：直接选择快速启动模式。
2. 模型选择：默认 Qwen 配置（qwen-portal）通常指向国际版 API，适合开发者试用。若需国内手机号登录，后续可切换供应商。
3. API Key 配置：
   • Google Places API：暂不需要，选否。
   • Gemini API：暂不需要，选否。
   • Notion API：非核心依赖，选否。
   • ElevenLabs API：语音合成非当前目标，选否。

完成基础配置后，进入终端界面（TUI）进行进一步设置。此时机器人已支持中文交互，可根据提示继续配置。

高级选项

• Hooks（钩子）：推荐启用 session-memory，让 AI 记住上下文，即使关闭终端也能延续话题。
• Skills（技能）：根据需求开启，初期建议先跳过渠道配置，聚焦核心流程。
• 模型提供商：在控制台选择默认模型即可，后续可在 Web UI 中调整。

Web UI 配置与认证修复

完成 TUI 登录后，浏览器会自动弹出 Web UI 页面。初次访问时可能会遇到认证报错，这是因为 TUI 和 Web UI 使用了两套独立的认证系统。

要解决这个问题，需要将 TUI 生成的 Token 注入到 Web UI 请求中。

获取 Token

执行以下命令查看本地配置文件中的 Token：

cat ~/.openclaw/openclaw.json | grep -o '"token": "[^"]*"'

输出类似：

"token": "<YOUR_TOKEN>"

应用 Token

将提取到的 Token 追加到访问地址参数中。例如：