跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.jsAI

Linux 环境下 OpenClaw 安装、初始化与 Web UI 配置指南

综述由AI生成OpenClaw 是一款开源 AI Agent 工具。本文基于 Linux 环境,详细记录了从 Node.js 环境准备、OpenClaw 全局安装、初始化向导配置到最终 Web UI 访问的全流程。针对 TUI 与 Web UI 认证系统独立导致无法登录的问题,提供了从配置文件提取 Token 并注入 URL 参数的具体解决方案,帮助用户快速搭建并跑通基础功能。

竹影清风发布于 2026/3/26更新于 2026/5/2210 浏览
Linux 环境下 OpenClaw 安装、初始化与 Web UI 配置指南

概述

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)服务。非核心流程,先选否。

配置完成后,可通过终端进行回归测试。此时机器人应能正常响应中文指令。

OpenClaw 终端交互界面

接下来需要配置机器人行为,类似重新设定 TAS。继续按提示操作,选择推荐方式通过 TUI(Terminal UI)完成最后一步。

系统会询问是否启用 Hooks(插件),建议选择 session-memory,让 AI 记住对话上下文,即使关闭终端也能延续话题。其余选项可视需求跳过。

随后配置 Skills(技能),选择'是'。渠道配置暂时跳过,后续再详细展开。回到控制台选择默认模型提供商,确认后即可在浏览器弹出登录页面。

Web UI 登录入口

在页面中选择模型提供商,为快速测试可直接沿用 Qwen。

Web UI 认证问题处理

部分用户反馈 TUI 配置成功后,访问 Web UI 仍报错。这是因为 TUI 和 Web UI 使用了两套独立的认证系统。解决方法是将 TUI 生成的 Token 注入到 Web UI 中。

  1. 获取 Token 从本地配置文件中提取 Token:

    cat ~/.openclaw/openclaw.json | grep -o '"token": "[^"]*"'
    # 输出示例:"token": "7da3f004ff2a1e700f229a87fb5ea12c150b37d58199295f"
    
  2. 注入参数 将提取到的 Token 补充到 Web UI 地址参数中。例如: http://127.0.0.1:18789/?token=7da3f004ff2a1e700f229a87fb5ea12c150b37d58199295f

    注意:如果访问根路径会自动跳转,请使用 & 连接参数。

    Web UI 参数配置

配置完成后,页面应恢复正常,且之前的聊天记录也会同步过来。

总结

本文演示了在 Linux 下安装 OpenClaw 并完成基本流程搭建的方法。重点解决了 TUI 与 Web UI 认证不一致导致的访问问题。后续可根据实际需求进一步挖掘更多功能。

目录

  1. 概述
  2. 环境准备
  3. 输出示例:v22.22.0
  4. 输出示例:2026.2.25
  5. 初始化配置
  6. Web UI 认证问题处理
  7. 总结
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • Python 基础语法核心指南
  • LLM 继续预训练(Continue Pretrain)实践指南与经验总结
  • 自回归生成原理剖析:从零实现一个‘逐字生成‘的AI写作模型
  • Stable Diffusion 秋叶整合包安装与常用功能指南
  • Python act-atmos 大气数据处理工具包介绍
  • 前端 WebSocket 实时通信实战:连接管理与最佳实践
  • llama.cpp 本地部署性能调优指南:从启动瓶颈到推理效率优化
  • Mac M 系列芯片适配:mlc-llm 与 llama.cpp 对比
  • AI 生成图片提示词:新手入门指南与最佳实践
  • C++ 平面图算法设计与实现详解
  • AI 产品经理学习路线与面试指南
  • 大语言模型(LLM)基础概念与原理详解
  • Stable Diffusion 提示词编写指南:结构、权重与反向提示词
  • C++ 模板初阶
  • 大模型分布式训练与高效调参技术实战
  • C++ 手写线程池日志模块:基于策略模式实现
  • 非技术人员如何利用 AI 开发效率工具与智能体应用
  • 从语法纠错到项目重构:Python+Copilot 全流程开发效率提升指南
  • C++模板与泛型编程:构建灵活代码架构
  • Spring Boot + jQuery 前后端分离图书管理系统实战

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online