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

Ubuntu 部署 OpenClaw 实战指南

Ubuntu 22.04 服务器部署 OpenClaw 智能体的完整流程。涵盖 Node.js 环境搭建、npm 镜像配置及官方脚本安装。重点解决 PATH 环境变量缺失导致的命令不可用问题,并通过 SSH 隧道实现 Web 控制界面的远程访问。包含安全初始化建议与基础功能测试步骤。

极光发布于 2026/3/29更新于 2026/7/1133 浏览
Ubuntu 部署 OpenClaw 实战指南

环境信息

  • 系统: Ubuntu 22.04 LTS
  • 配置: 4 核 8GB 内存,100M 带宽
  • 类型: CPU

一、安装依赖

1.1 更新系统包索引
sudo apt update
1.2 安装 curl
sudo apt install -y curl
1.3 通过 NodeSource 安装最新稳定 LTS 版本

添加 NodeSource 仓库并安装:

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

安装完成后验证版本:

node -v
npm -v

实际输出示例:

v24.14.0
11.9.0
1.4 设置淘宝镜像(最常用)
npm config set registry https://registry.npmmirror.com
npm config get registry

验证输出:

https://registry.npmmirror.com

二、安装 OpenClaw

执行官方安装脚本。注意:安装过程中若提示确认,请勾选 yes。

curl -fsSL https://openclaw.ai/install.sh | bash

关键日志摘要:

安装过程会自动检测环境、配置 npm 全局路径及 systemd 服务。重点关注以下两点:

  1. 安装成功提示:OpenClaw installed successfully (版本号)!
  2. PATH 警告:如果看到 PATH missing npm global bin dir,说明命令无法在终端直接调用,需按后续步骤修复。

安全提示:

OpenClaw 默认是个人助手模式,涉及文件读取和工具执行权限。生产环境部署前请务必阅读安全文档,建议开启 Pairing/Allowlists 并最小化工具权限。


三、解决 PATH 问题

安装完成后,如果执行 which openclaw 找不到命令,需要手动配置环境变量。

# 检查 openclaw 是否在 PATH 中
which openclaw


npm prefix -g


 






  >> ~/.bashrc


 ~/.bashrc


  | grep npm
# 如果找不到,查看 npm 全局安装目录
# 查看当前 shell 类型
echo
$SHELL
# 根据 shell 类型编辑配置文件
# 如果是 /bin/bash,编辑 ~/.bashrc
# 如果是 /bin/zsh,编辑 ~/.zshrc
# 将 npm 全局 bin 目录添加到 PATH
echo
'export PATH="$(npm prefix -g)/bin:$PATH"'
# 重新加载配置文件
source
# 验证添加是否成功
echo
$PATH

四、访问控制界面

4.1 本地 SSH 连接服务器

在本地电脑执行以下命令,建立端口转发隧道:

ssh -NL 18789:127.0.0.1:18789 ubuntu@你的云主机 IP

输入远程 Linux 云主机密码即可建立连接。

4.2 访问 OpenClaw Web UI

携带部署过程中生成的 Dashboard Token 在本地浏览器访问:

http://localhost:18789/#token=你的 token

Web UI 登录界面

4.3 测试
  1. 询问模型:确认后端模型配置正确(如 glm-4.7)。
  2. 修改名称:给 AI 助手起名为'大衍 AI',切换界面等待生效。

AI 助手设置界面

生效后的界面


五、总结

本文详细记录了在 Ubuntu 22.04 服务器上从零部署 OpenClaw 的完整流程:

  • 环境准备:Node.js LTS 安装与 npm 镜像配置
  • OpenClaw 安装:通过官方脚本一键安装,处理 PATH 配置问题
  • 初始化配置:QuickStart 模式、Z.AI 模型接入
  • 远程访问:通过 SSH 隧道访问 Web 控制界面进行问答

完成上述步骤后,即可开始体验基于本地部署的 AI 智能体功能。

目录

  1. 环境信息
  2. 一、安装依赖
  3. 1.1 更新系统包索引
  4. 1.2 安装 curl
  5. 1.3 通过 NodeSource 安装最新稳定 LTS 版本
  6. 1.4 设置淘宝镜像(最常用)
  7. 二、安装 OpenClaw
  8. 三、解决 PATH 问题
  9. 检查 openclaw 是否在 PATH 中
  10. 如果找不到,查看 npm 全局安装目录
  11. 查看当前 shell 类型
  12. 根据 shell 类型编辑配置文件
  13. 如果是 /bin/bash,编辑 ~/.bashrc
  14. 如果是 /bin/zsh,编辑 ~/.zshrc
  15. 将 npm 全局 bin 目录添加到 PATH
  16. 重新加载配置文件
  17. 验证添加是否成功
  18. 四、访问控制界面
  19. 4.1 本地 SSH 连接服务器
  20. 4.2 访问 OpenClaw Web UI
  21. 4.3 测试
  22. 五、总结
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

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

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

更多推荐文章

查看全部
  • C++ 哈希表原理与线性探测、哈希桶模拟实现
  • Java synchronized 关键字详解:从入门到原理
  • 渗透测试常见面试题与核心知识点解析
  • 基于大模型的 Agent 智能体架构与实现解析
  • Python 进程概念与多进程使用详解
  • Python 进阶:模块、包和异常处理
  • C++ STL 排序及相关操作详解
  • AI Agent 开发工程师岗位解析与技能路径
  • 低空无人机 AI 算法详解:覆盖公安、消防及多行业应用场景
  • MySQL 解压版安装与配置指南
  • 深度解析 DeepSeek-V3 技术架构与性能表现
  • 基于 Rokid 眼镜的 AI 天气应用、GPS 定位与旅游规划实现
  • DeepSeek 系列模型版本演进与核心特性对比
  • 大模型技术解析:定义、架构与发展趋势
  • Python 本地 DocsGPT 集成开发:构建智能代码编辑器
  • Android CameraX 与 Camera2 框架机制及性能差异分析
  • GOPLA框架在Stretch 3机器人上实现空间常识突破
  • Android 插件化框架 DynamicLoadApk 源码解析(上)
  • 本地部署开源语言大模型 Llama3 及中文微调版教程
  • 2026 牛客寒假算法基础集训营 5 题解(BDFGJ)

相关免费在线工具

  • RSA密钥对生成器

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

  • Mermaid 预览与可视化编辑

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

  • 随机西班牙地址生成器

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

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online