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

环境准备

1. 安装 Node.js

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

验证版本：

node --version
# 输出示例：v22.22.0

2. 安装 OpenClaw

npm install -g openclaw@latest

验证版本：

openclaw --version
# 输出示例：2026.2.25

初始化 OpenClaw

运行初始化命令并选择 QuickStart 模式：

openclaw onboard --install-daemon

配置说明：

• 模型选择：默认选择 Qwen（qwen-portal），因其门槛低且通常提供开发者免费试用额度。后续可更换供应商。
• Google Places API：若无需查询现实地点信息，选否。
• Gemini API Key：若不使用 Google Gemini 服务，选否。
• Notion API Key：若不集成 Notion，选否。
• ElevenLabs API Key：若暂不需要语音合成能力，选否。

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

1. 确认机器人配置，使用 TUI（Terminal UI）完成最后一步孵化。
2. 启用 Hooks（插件），选择 session-memory 以保留对话上下文。
3. Skills 配置：选择是。
4. 渠道配置：暂时跳过，后续详细配置。

在浏览器弹出登录页面后，选择模型提供商（建议快速测试选 Qwen）。

Web UI 配置

若 TUI 配置成功但 Web UI 报错，通常是因为两者认证系统独立。需将 CLI 生成的 token 注入 Web UI。

1. 获取 Token

cat ~/.openclaw/openclaw.json | grep -o '"token": "[^"]*"'
# 输出示例："token": "7da3f004ff2a1e700f229a87fb5ea12c150b37d58199295f"

2. 注入 Token

在 Web UI 参数中补充 token：

token=7da3f004ff2a1e700f229a87fb5ea12c150b37d58199295f

如果访问 http://127.0.0.1:18789/ 自动跳转，可使用 & 追加参数：

http://127.0.0.1:18789/?token=...

配置完成后，Web UI 应恢复正常，并可同步之前的聊天记录。