概述
OpenClaw 是一款开源的 AI Agent 工具。对于初次接触的用户,完整跑通流程可能略显复杂。本文以 Linux 环境为例,记录安装、初始化、模型选择及 TUI 与 Web UI 认证差异的解决方案,帮助快速搭建并运行。
环境准备
首先确保系统已安装 Node.js。推荐使用 LTS 或当前稳定版(如 v22)。
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 模式。关于配置项的说明如下:
- 登录方式:默认配置通常指向国际版 API(如 Qwen Portal),支持 Google 或 GitHub 账号登录,暂不支持支付宝或国内手机号。若无相关账号,需提前注册。
- 模型选择:初期推荐选择 Qwen,门槛较低且通常提供开发者免费试用额度,便于快速验证流程。后续可更换供应商。
- 第三方集成:
GOOGLE_PLACES_API_KEY:用于查询现实地点信息。若无需此功能,选否。GEMINI_API_KEY:对应nano-banana-pro服务。非必需,选否。NOTION_API_KEY:Notion 权限配置。暂不需要,选否。ELEVENLABS_API_KEY:文本转语音(TTS)服务。非核心流程,先选否。
配置完成后,可通过终端进行回归测试。此时机器人应能正常响应中文指令。

接下来需要配置机器人行为,类似重新设定 TAS。继续按提示操作,选择推荐方式通过 TUI(Terminal UI)完成最后一步。
系统会询问是否启用 Hooks(插件),建议选择 session-memory,让 AI 记住对话上下文,即使关闭终端也能延续话题。其余选项可视需求跳过。
随后配置 Skills(技能),选择'是'。渠道配置暂时跳过,后续再详细展开。回到控制台选择默认模型提供商,确认后即可在浏览器弹出登录页面。




