环境准备
OpenClaw 基于 Node.js 构建,首先需要确保系统已安装 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
初始化过程中会引导选择 QuickStart 模式。关于模型选择,默认配置(qwen-portal)通常指向国际版 API,支持 Google 账号或 GitHub 账号登录,适合快速上手并获取开发者免费试用额度。后续可更换模型供应商。
在配置辅助服务时,若当前无需 Google Places、Gemini 或 Notion 等特定功能,可直接跳过。ElevenLabs 语音合成服务可根据需求后续开启。
完成基础配置后,进入 TUI(终端界面)进行最后一步孵化。建议启用 session-memory 钩子,让 AI 记住对话上下文。Skills 配置可选择开启,渠道部分若暂时不需要可跳过。



常见问题:Web UI 认证同步
如果在 TUI 中配置成功,但访问 Web UI 时报错,通常是因为 TUI 和 Web UI 使用了两套独立的认证系统。需要将 TUI 生成的 token 传递给 Web 页面。
- 获取 Token
cat ~/.openclaw/openclaw.json | grep -o '"token": "[^"]*"'
# 输出示例:"token": "7da3f004ff2a1e700f229a87fb5ea12c150b37d58199295f"
- 补充参数到 URL




