[AI实战]Ubuntu 下安装OpenClaw——从零搭建你的专属AI助理

优质文章学习记录

— 6 min read
[AI实战]Ubuntu 下安装OpenClaw——从零搭建你的专属AI助理

[AI实战]Ubuntu 下安装OpenClaw——从零搭建你的专属AI助理

前言

OpenClaw是一款功能强大的AI助理框架，支持自定义技能、多模型接入，并能通过聊天软件与你交互。本文将手把手带你在Ubuntu系统上完成OpenClaw的安装与配置，并实现外部安全访问。无论你是AI爱好者还是开发者，都能通过本文快速拥有一个属于自己的AI助理。

环境准备：

  • 操作系统：Ubuntu 20.04 / 22.04 / 24.04（本文以24.04为例）
  • 权限：需要使用root或拥有sudo权限的用户
  • 网络：能够访问GitHub及npm源（建议使用国内镜像加速）

一、升级Node.js至v22+

OpenClaw要求Node.js版本≥22.0.0，低版本会导致npm安装失败。若系统已安装其他版本，请务必升级。

方法一：使用nvm（推荐，便于多版本管理）

1. 安装nvm

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh |bash

安装完成后，重新加载环境变量：

source ~/.bashrc # 若使用bash# source ~/.zshrc # 若使用zsh

2. 安装Node.js v22并设为默认

nvm install22 nvm alias default 22 nvm use 22

3. 验证版本

node-v# 应显示 v22.x.xnpm-v# 检查npm版本

方法二：使用NodeSource官方仓库（系统级安装）

如果你希望直接覆盖系统Node版本，可以使用以下命令（以Ubuntu/Debian为例）：

curl-fsSL https://deb.nodesource.com/setup_22.x |bash - apt-getinstall-y nodejs

CentOS/RHEL用户请使用：

curl-fsSL https://rpm.nodesource.com/setup_22.x |bash - yum install-y nodejs

方法三：手动下载二进制包

从 Node.js官网 下载Linux二进制包，解压后配置PATH即可。

二、安装OpenClaw

1. 一键安装（官方推荐）

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

若网络不稳定，也可以直接使用npm全局安装（避免脚本问题）：

npminstall-g openclaw@latest

2. 验证安装

openclaw --version

出现版本号即表示安装成功。

3. 初始化配置

openclaw onboard

此命令将引导你完成基础配置，包括：

  • 选择AI模型（可跳过，后续添加）
  • 配置聊天渠道（如Telegram、飞书等，可跳过）
  • 安装基础技能（建议全选）

跳过模型配置： 若暂时没有API Key，可以选择跳过，后续随时补充。

在这里插入图片描述


选择Open the Web UI：

在这里插入图片描述

4. 修改配置文件以实现外部访问

OpenClaw默认只监听本地（127.0.0.1），如需从局域网其他设备访问Web控制台，需修改配置文件。

配置文件位于 ~/.openclaw/openclaw.json，编辑该文件：

nano ~/.openclaw/openclaw.json

找到 gateway 部分，将 bind 的值改为 "lan"（监听所有网络接口），并确保端口为 18789。

在这里插入图片描述

修改后重启Gateway服务：

openclaw gateway restart

5. 防火墙放行端口

根据你的防火墙工具，开放18789端口（注意：生产环境建议限制来源IP）：

# ufw ufw allow 18789/tcp # firewalld firewall-cmd --add-port=18789/tcp --permanent&& firewall-cmd --reload# iptables iptables -A INPUT -p tcp --dport18789-j ACCEPT

验证监听状态：

ss -untlp|grep18789

应显示类似 0.0.0.0:18789 的监听记录。

在这里插入图片描述

6. 安全访问：使用SSH隧道（推荐）

由于Web控制台基于HTTP且未配置HTTPS，直接暴露可能带来安全风险。最安全的方式是通过SSH隧道将远程端口映射到本地。

在宿主机（你的物理机）上执行：

ssh-L8888:localhost:18789 root@<虚拟机IP>
在这里插入图片描述
  • 8888：本地监听端口，可自定义
  • <虚拟机IP>：Ubuntu虚拟机的实际IP地址

保持此终端窗口打开，然后打开宿主机浏览器，访问 http://localhost:8888。此时相当于本地访问，完美满足浏览器的“安全上下文”要求，且所有流量均通过SSH加密。

在这里插入图片描述
优点：无需修改OpenClaw配置、无需开放防火墙、流量加密。
缺点：每次访问需保持SSH连接。

三、常见问题与解决

Q1：安装时npm报错“node-domexception”等警告

这是正常现象，不影响使用，可忽略。

Q2：无法从外部访问Web控制台

  • 检查 bind 是否设置为 "lan" 或 "0.0.0.0"（注意新版需用 lan 模式）。
  • 确认防火墙已放行18789端口。
  • 尝试使用SSH隧道方式。

Q3：浏览器报“origin not allowed”

在配置文件中添加 controlUi.allowedOrigins，例如：

"controlUi":{"allowedOrigins":["http://你的宿主机IP:18789"]}

然后重启Gateway。

Q4：浏览器提示“需要安全上下文”

这是因为通过HTTP访问非本地地址。解决方案：

  • 使用SSH隧道（推荐）
  • 或配置HTTPS（如使用Tailscale Serve）
  • 或在配置中设置 allowInsecureAuth: true（仅限测试环境）

四、进阶：配置模型与技能

1. 添加AI模型密钥

通过Web控制台或命令行添加：

openclaw config set models.providers.openai.apiKey sk-xxxxxx openclaw models set openai/gpt-4

2. 安装新技能

使用官方工具 clawhub：

npminstall-g clawhub clawhub install tavily-search # 安装联网搜索技能

3. 使用本地模型

如果你有本地部署的模型（如Ollama、vLLM），可通过自定义模型提供商接入，参考[官方文档]( Model Providers - OpenClaw )。

五、总结

通过本文，你已经在Ubuntu上成功搭建了OpenClaw AI助理，并掌握了通过SSH隧道安全访问Web控制台的方法。OpenClaw的强大之处在于其可扩展性——你可以随时添加新技能、接入不同模型，甚至开发自己的插件。

友情提示：建议创建普通用户运行OpenClaw，避免使用root带来安全风险。

如果你在安装过程中遇到任何问题，欢迎在评论区留言交流！

Read more

PEEK取代金属：精密注塑齿轮蜗杆驱动机器人灵巧手技术与成本革新

PEEK取代金属：精密注塑齿轮蜗杆驱动机器人灵巧手技术与成本革新

当人形机器人灵巧手从实验室走向千行百业，轻量化、低成本、低噪音的核心传动部件成为技术普及的关键瓶颈。传统金属齿轮蜗杆虽然性能可靠，却因重量大、加工复杂、摩擦噪音需求高等限制难以突破，而一场聚焦于灵巧手精密齿轮蜗杆传动部件革新的探索，正悄然推动技术边界的拓展。 特种工程塑料加工助力人形机器人迈向新高度 对于机器人核心零部件，PEEK本身具备独特的综合性能，其加工结合了注塑工艺的高可重现性和设计自由度，这为PEEK齿轮蜗杆应用于灵巧手中带来了明显好处。例如： （1）极致轻量化与惯量降低：采用PEEK材料注塑加工的齿轮蜗杆能显著减轻传动系统重量，从而降低灵巧手运动惯量，提升响应速度与操作精度，并减轻电机负载，优化整体能耗。 （2）降噪减振与运行静谧：阻尼特性是PEEK固有的，结合精密注塑所能实现的最佳齿形与表面质量，可有效吸收和衰减齿轮啮合产生的振动与噪音，使得灵巧手运行更加安静顺滑。 （3）集成化设计与功能整合：注塑工艺允许将传统需要多个金属零件组装而成的复杂齿轮组、蜗杆蜗轮副，甚至与轴承座、连接结构等，一次成型为一个高度集成的多功能部件。这极大减少了零件数量与装配工序，降低了因
【论文笔记】ST-GS: Vision-Based 3D Semantic Occupancy Prediction with Spatial-Temporal Gaussian Splatting

【论文笔记】ST-GS: Vision-Based 3D Semantic Occupancy Prediction with Spatial-Temporal Gaussian Splatting

原文链接：https://arxiv.org/abs/2509.16552v1 1. 概述 ST-GS通过引入时空信息增强基于高斯的占用预测范式。 1. 给定 τ \tau τ帧连续的环视图像 { I t } t = 1 τ \{I^t\}_{t=1}^\tau {It}t=1τ ，首先使用共享的图像编码器提取多视图2D特征 { X t } t = 1 τ \{X^t\}_{t=1}^\tau {Xt}t=1τ 。 2. 生成一组3D高斯嵌入 { Q t } t = 1 τ \{Q^

一文说清ESP32固件库下载在智能家居中的作用

为什么说“下载一个固件库”能决定你家智能设备的成败？ 你有没有过这样的经历：买了一个号称“全屋智能”的灯泡，结果手机App连不上Wi-Fi；或者花了几百块买的温控插座，隔三差五断连、响应迟钝？ 问题可能不在硬件，也不在路由器——而在于那颗小小的主控芯片里， 有没有用对固件库 。 今天我们就来聊点硬核但实用的话题：当你在开发或调试ESP32这类物联网芯片时，“esp32固件库下载”这个动作，到底意味着什么？它不只是复制粘贴几行代码那么简单，而是决定了你的智能家居系统是 稳定流畅还是频繁崩溃的关键一步 。 从一块开发板说起：没有固件库的ESP32什么都不是 ESP32很火，这是事实。双核处理器、Wi-Fi + 蓝牙双模、几十个GPIO口，价格还不到一杯奶茶钱。但你知道吗？刚出厂的ESP32芯片其实是个“空壳子”。它不会自动连Wi-Fi，也不能处理MQTT消息，甚至连最基础的GPIO控制都需要外部程序驱动。 换句话说： 硬件只是躯体，固件库才是灵魂 。 而所谓“esp32固件库下载”，本质上就是为这具躯体注入神经系统的过程——让你可以用几行代码完成复杂的网络连接、协议通信和任务
【FPGA/EDA】Quartus 18.0 软件安装及 ModelSim 环境配置

【FPGA/EDA】Quartus 18.0 软件安装及 ModelSim 环境配置

最近在上《EDA技术》这门电气专业的任选课，用到了Quartus 18.0和ModelSim软件工具进行波形图仿真，安装及配置教程十分曲折晦涩，故作此篇笔记用以记录。 软件资源及安装方法大纲由以下链接提供，以此为基准，本文只重点说明其中可能会遇到的问题及如何配置内部ModelSim波形图仿真工具。 在此感谢这位作者为大众提供了安装包资源及非常详细的安装教程！微信公众平台https://mp.weixin.qq.com/s?__biz=MzA4MjU4MTg2Ng==&mid=2247552337&idx=4&sn=c743d0f98c0b1be42fa7e92f9ea4f51a&chksm=9f81cd54a8f64442c4e7cc206e0907e56feee88ed8b30cb00ea7a72b797d4bbe406219c962d1&scene=178&cur_album_id=3421644748383879180&search_click_id=#rd  一、Quartus 18.0 软件安装中可能会遇到的问题