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

OpenClaw Linux 部署指南

OpenClaw 是一款开源的 AI Agent 工具，但在初次部署时，完整跑通流程往往需要一些细节调整。本文以 Linux 环境为例，记录从 Node.js 环境搭建、OpenClaw 安装、模型初始化到 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

确认 CLI 版本正常：

openclaw --version
# 输出示例：2026.2.25

初始化配置

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

openclaw onboard --install-daemon

向导选择建议

1. QuickStart：直接选择快速启动模式，适合首次体验。
2. 登录方式：默认 Qwen 配置指向国际版 API，通常支持 Google 或 GitHub 账号登录。若需国内手机号登录，可能需要后续切换供应商。当前目标是快速跑通流程，建议优先使用现有账号。
3. API Key 配置：
   • GOOGLE_PLACES_API_KEY：用于查询现实地点信息（如餐馆、影院）。若暂无需求可跳过。
   • GEMINI_API_KEY：为特定模型设置密钥。非必须项，暂选否。
   • NOTION_API_KEY：集成 Notion 笔记功能。根据实际需求决定是否启用。
   • ELEVENLABS_API_KEY：启用文本转语音（TTS）功能。初期建议先专注于核心对话逻辑，此项可选。

完成基础配置后，可通过终端界面（TUI）进行回归测试。此时机器人应能识别中文指令。

进阶设置

在 TUI 中继续配置以下选项：

• Hooks（插件）：推荐启用 session-memory，让 AI 记住上下文，即使关闭终端也能延续话题。
• Skills（技能）：选择启用，赋予模型更多操作能力。
• 渠道（Channels）：暂时跳过，后续可在控制台详细配置。

完成后回到控制台选择默认模型，浏览器会自动弹出登录页面。为快速测试，模型提供商建议选择 Qwen。