OpenClaw 部署指南
OpenClaw 是一款开源的 AI Agent 工具。对于初次接触的用户，完整跑通流程可能不够直观。本文以 Linux 环境为例，详细记录安装、初始化流程、模型选择、TUI 使用方式，以及解决 TUI 与 Web UI 认证不一致导致的问题，帮助你快速将 OpenClaw 运行起来。
环境准备
1. 安装 Node.js
OpenClaw 基于 Node.js 开发，首先需要确保环境已就绪。推荐使用 NodeSource 源安装较新版本：
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 全局安装最新版：
npm install -g openclaw@latest
验证安装：
openclaw --version
# 输出示例：2026.2.25
初始化配置
运行 onboard 命令启动初始化向导，并安装守护进程：
openclaw onboard --install-daemon
向导选项说明
进入交互界面后，建议按以下逻辑选择以快速跑通流程：
- QuickStart：选择快速启动模式，适合初次体验。
- 登录方式：默认 Qwen 配置指向国际版 API，通常支持 Google 或 GitHub 账号登录。若无需支付宝或国内手机号登录，直接使用现有账号即可。
- 模型选择：Qwen 门槛较低且国际版常提供开发者免费试用额度，适合作为初始模型。后续可在设置中更换供应商。
- API Key 配置：
GOOGLE_PLACES_API_KEY：用于查询现实地点信息（如餐馆、影院）。若暂不需要此功能，选否。GEMINI_API_KEY：用于特定模型插件。非必需，选否。NOTION_API_KEY：集成 Notion 笔记/数据库功能。暂不使用时选否。ELEVENLABS_API_KEY：启用文本转语音（TTS）功能。初期可跳过，选否。
完成基础配置后，系统会进入控制台。此时可选择具体模型，默认配置即可。随后浏览器会自动弹出登录页面，确认模型提供商为 Qwen 以便快速测试。
TUI 进阶设置
回到控制台后，继续完成终端界面（TUI）的最后一步配置：
- Hooks（钩子/插件）：推荐启用
session-memory。这能让 AI 记住之前的对话内容或项目上下文，即使关闭终端重新打开，也能延续话题。 - 其他插件：除上述外，其余选项可视需求暂时跳过。
- Skills（技能）：建议选择'是'，以启用更多自动化能力。
- 渠道配置：此处可先跳过，后续再根据实际业务场景详细描述。
Web UI 配置与问题排查
完成 TUI 配置后，访问本地 Web 界面时可能会遇到报错。这是因为 TUI 和 Web UI 使用的是两套完全独立的认证系统。
