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
向导选择建议
- QuickStart：直接选择快速启动模式，适合首次体验。
- 登录方式：默认 Qwen 配置指向国际版 API，通常支持 Google 或 GitHub 账号登录。若需国内手机号登录，可能需要后续切换供应商。当前目标是快速跑通流程，建议优先使用现有账号。
- 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。
解决 TUI 与 Web UI 认证不一致问题
部分用户反馈 TUI 配置成功但 Web UI 报错。这是因为两者使用了独立的认证系统。需要将 TUI 生成的 Token 同步到 Web 端。
获取 Token
在终端执行以下命令提取 token：
cat ~/.openclaw/openclaw.json | grep -o '"token": "[^"]*"'
# 输出示例："token": "7da3f004ff2a1e700f229a87fb5ea12c150b37d58199295f"
应用 Token
将提取到的 Token 参数追加到 Web UI 地址后。例如访问 http://127.0.0.1:18789/ 时，若发生自动跳转，可使用 & 符号拼接参数：
http://127.0.0.1:18789/?token=7da3f004ff2a1e700f229a87fb5ea12c150b37d58199295f
配置成功后，Web 页面应恢复正常，且之前的聊天记录会同步显示。
至此，OpenClaw 的基础环境已在 Linux 下完成搭建，后续可根据业务需求进一步挖掘其功能。