概述
OpenClaw 是一款开源 AI Agent 工具。本文以 Linux 环境为例,详细记录 OpenClaw 的安装、初始化流程、模型选择及 TUI 与 Web UI 认证同步方法。
环境准备
- 安装 Node.js
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
验证版本:
node --version
# v22.22.0
- 安装 OpenClaw
npm install -g openclaw@latest
验证版本:
openclaw --version
# 2026.2.25
初始化配置
执行初始化命令并安装守护进程:
openclaw onboard --install-daemon
按向导完成以下配置:
- QuickStart: 选择快速启动模式。
- 登录方式: 默认 Qwen 配置指向国际版 API,需使用 Google 或 GitHub 账号注册。
- Google Places API: 暂不需要,选否。
- Gemini API Key: 暂不需要,选否。
- Notion API Key: 暂不需要,选否。
- ElevenLabs API Key: 暂不需要,选否。
完成基础配置后,继续后续步骤:
- Hooks: 启用 session-memory 以保留对话上下文。
- Skills: 选择是。
- 渠道: 暂时跳过,后续再配置。
- 模型提供商: 选择 Qwen 以便快速测试。

浏览器将弹出登录页面,确认模型后即可进入控制台。
Web UI 认证同步
若 TUI 配置成功但 Web UI 报错,通常是因为两者使用独立的认证系统。需将 Token 同步至 Web 端。
- 获取 Token
cat ~/.openclaw/openclaw.json | grep -o '"token": "[^"]*"'
# token: "7da3f004ff2a1e700f229a87fb5ea12c150b37d58199295f"



