Linux 环境下 OpenClaw 安装、初始化与 Web UI 配置
OpenClaw 是一款开源 AI Agent 工具。本文记录在 Linux 环境下通过 Node.js 安装 OpenClaw 的步骤,包括初始化流程、模型选择(Qwen)、TUI 使用方式,以及解决 TUI 与 Web UI 认证不一致导致的问题。通过提取本地配置文件中的 Token 并填入 Web UI 参数,可实现完整功能跑通。

OpenClaw 是一款开源 AI Agent 工具。本文记录在 Linux 环境下通过 Node.js 安装 OpenClaw 的步骤,包括初始化流程、模型选择(Qwen)、TUI 使用方式,以及解决 TUI 与 Web UI 认证不一致导致的问题。通过提取本地配置文件中的 Token 并填入 Web UI 参数,可实现完整功能跑通。

OpenClaw 是一款开源的 AI Agent 工具。本文以 Linux 环境为例,详细记录 OpenClaw 的安装、初始化流程、模型选择、TUI 使用方式,以及 TUI 与 Web UI 认证不一致导致的常见问题与解决方法。
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt install -y nodejs
验证版本:
node --version
# v22.22.0
npm install -g openclaw@latest
验证版本:
openclaw --version
# 2026.2.25
运行初始化命令:
openclaw onboard --install-daemon
GOOGLE_PLACES_API_KEY:用于查询现实世界地点信息。若不使用 Google 服务,选否。GEMINI_API_KEY:用于 nano-banana-pro。若不使用 Google 服务,选否。NOTION_API_KEY:配置 Notion 权限。若不需要笔记功能,选否。ELEVENLABS_API_KEY:配置文本转语音(TTS)。若不需要语音交流,选否。
配置完成后进行回归测试,确认机器人支持中文交互。

接下来进入孵化小机器人步骤,推荐使用 TUI(Terminal UI)完成最后一步。

启用 Hooks(钩子/插件),选择 session-memory,让 AI 记住之前的对话内容或项目上下文。

其余选项暂时全选否,后续再配置。

跳过渠道配置,稍后详细描述。

配置 Skills,选择是。

回到控制台,选择具体模型,默认即可。

浏览器会弹出登录页面,选择模型提供商,为快速测试直接选择 Qwen。

若 TUI 配置成功但 Web UI 报错,是因为 TUI 和 Web UI 使用了两套独立的认证系统。需要将 Token 应用到页面上。
cat ~/.openclaw/openclaw.json | grep -o '"token": "[^"]*"'
# token: "7da3f004ff2a1e700f229a87fb5ea12c150b37d58199295f"
将 Token 填入页面参数中:token=7da3f004ff2a1e700f229a87fb5ea12c150b37d58199295f

注:如果访问 http://127.0.0.1:18789/ 会自动跳转,可使用 & 将参数补充在 URL 后面。
页面恢复正常,且之前在控制台的聊天记录已同步过来。


微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online
JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online
Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online