大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



OpenClaw 是一款轻量高效的本地个人 AI 助手框架，可实现自动执行任务、调用工具、网页浏览、流程组合等功能，适配 Ubuntu 20.04 LTS 及以上所有主流版本（含 Server 版和 Desktop 版）。

1.1 系统环境预处理

无论选择哪种安装方式，先执行以下命令更新系统、安装基础依赖，解决大部分"依赖缺失"报错：

1.2安装 Node.js（核心依赖，必做）

OpenClaw 要求 Node.js 版本 ≥ 22.0.0，推荐使用 NodeSource 源安装（稳定且可快速升级），避免使用 Ubuntu 官方源的低版本 Node.js：

1.3 国内环境优化（可选，解决下载卡顿）

国内用户直接下载 OpenClaw 依赖可能卡顿，建议配置 npm 国内镜像（阿里云源），加速下载速度：

本文提供 3 种安装方案，覆盖不同用户需求：一键安装（新手首选，最简单）、npm 全局安装（灵活可控）、Docker 部署（适合开发者，隔离环境），任选其一即可，安装完成后功能完全一致。

方案一：一键安装（官方推荐，新手首选）

官方提供一键安装脚本，自动完成所有配置，无需手动操作，适合首次接触 OpenClaw 的新手：

1. 执行一键安装命令，脚本会自动下载、安装 OpenClaw 及所有依赖

   资源不可用就再去搜一下，只要是同步最新的github的就行

2. 安装过程说明：
3. 安装过程中会提示确认配置（如模型选择、Channel 配置），默认按 Enter 键即可，后续可在 UI 界面修改；
4. 若出现"权限不足"报错，在命令前添加 sudo（sudo curl -fsSL ... | bash）；
5. 安装耗时约 3-10 分钟，取决于网络速度，耐心等待，不要中途中断命令。
6. 验证安装成功：安装完成后，终端会显示"OpenClaw installed successfully"，并给出 Control UI 登录地址（默认 http://127.0.0.1:18789/openclaw），即表示安装成功。

方案二：npm 全局安装（灵活可控，适合进阶用户）

通过 npm 全局安装，可手动控制版本、灵活配置参数，适合需要自定义安装路径或版本的用户：

1. 执行 npm 安装命令，全局安装最新版 OpenClaw：
2. 解决下载卡顿问题：
3. 若命令执行后卡住（尤其是下载预编译二进制文件时），可中断命令（Ctrl+C），重新执行；
4. 若仍卡顿，可使用浏览器下载离线安装包（参考国内镜像站），再手动安装。
5. 验证安装成功：执行以下命令，显示版本号即正常：

安装完成后，需完成简单初始化配置（模型选择、Channel 配置、端口放行），才能正常使用 OpenClaw 的所有功能，以下步骤适配所有安装方式。

3.1 端口放行（必做，解决无法访问 UI 问题）

OpenClaw Gateway 默认监听 18789 端口，Ubuntu 防火墙（ufw）默认会拦截该端口，需手动放行：

3.2 启动 Gateway 服务

Gateway 是 OpenClaw 的核心服务，负责接收请求、调用工具，需确保其正常启动

一键安装/ npm 安装用户

3.3 配置 Control UI 可远程访问（可选）

默认情况下，Control UI 仅允许本地（127.0.0.1）访问，若你的 Ubuntu 是 Server 版（无桌面），或想从其他设备访问，需修改配置文件： /home/username/.openclaw/openclaw.json

1. 找到"gateway"配置项，修改为以下内容（自定义 token 和端口可按需调整）：
2. 保存配置并重启 Gateway 服务：
3. 编辑 OpenClaw 配置文件（路径固定，若执行命令提示"没有文件"，核心原因是 OpenClaw 首次安装后未生成配置文件，需先执行配置向导生成，步骤如下）：

   第一步：先执行配置向导，生成 /root/.openclaw 目录及 openclaw.json 配置文件（必做）： 执行后按终端提示完成基础配置（如模型选择、Channel 初始化），配置完成后会自动生成配置文件，此步骤是解决文件缺失的核心；

   第二步：再执行编辑命令，此时文件已存在，可正常编辑： 补充：若执行 openclaw setup 后仍提示无文件，可执行 openclaw configure 重新初始化配置，或手动创建目录后生成文件（命令如下）：

3.4 初始化向导配置

访问 Control UI 后，需完成简单向导配置，才能正常使用 AI 功能：

1. 访问 Control UI：
2. 本地访问（Ubuntu 有桌面）：打开浏览器，输入 http://127.0.0.1:18789/openclaw/#token=xxxxx ；
3. 远程访问（其他设备）：输入 http://Ubuntu 服务器 IP:18789/openclaw（服务器 IP 可通过 ip addr show eth0 查看，必须带完整路径）。
4. 完成向导配置：
5. 模型配置：选择适合自己的 AI 模型（按需选择，后续可修改）；

   OpenClaw 需要连接到大语言模型才能工作。Openclaw 比较费token，国外模型成本高，门槛也高，这里我选择国内的智谱的 GLM 4.7

   如果没有智谱的API Key，点击官方地址自己注册账号获取API key：https://www.bigmodel.cn/glm-coding?ic=RBSKXMPNJP

6. Channel 配置：Channel 是 OpenClaw 的交互接口，可配置常用聊天工具，实现手机/电脑远程控制；
7. Skill 配置：安装所需的技能插件（如文件处理、网页浏览等），按需勾选即可。
8. 登录验证：若配置了 token，在登录界面输入自定义 token，即可进入 Control UI 主界面，完成初始化配置。

4.1 启动 OpenClaw

• npm 安装 + PM2 守护：无需手动启动，系统重启后会自动运行，可通过 pm2 status openclaw 查看状态；重点提醒：不要重复执行 pm2 start 命令，否则会启动多个openclaw进程，导致端口冲突、UI无法访问 ；若出现多个进程，执行 清理重启；若服务一直重启，优先执行 查看错误日志，定位重启原因；
• 一键安装用户：默认已配置开机自启，若未启动，执行 openclaw gateway start；若一直重启，执行 前台运行，查看实时报错；
• Docker 用户：执行 sudo docker compose up -d openclaw-gateway 启动，sudo docker compose stop 停止；若容器一直重启，执行 查看错误日志，多数为配置错误或端口占用导致。

4.2 基础使用操作

1. 进入 Control UI 主界面，点击"New Chat"创建新对话；
2. 输入指令测试（如"你好，你是？""检查 Channel 配置是否正确"），OpenClaw 会自动执行并反馈结果；
3. 配置 Channel 后，可通过常用聊天工具远程发送指令，控制 OpenClaw 执行任务（如文件处理、网页摘要等）；
4. 查看日志：执行 openclaw gateway --verbose 可查看实时运行日志，排查使用中的问题（尤其适合排查服务重启问题）。

1. 安装时卡住，提示"node-gyp rebuild"失败

原因：缺少 Python 和 C++ 编译工具，或 Node.js 版本过低。

解决方案：重新安装基础依赖，确保 Node.js 版本 ≥22.0.0：

2. 启动 Gateway 后，无法访问 18789 端口

原因：防火墙未放行端口，或 Gateway 未正常启动，或配置文件中 bind 未设为 lan。

解决方案：

补充：重点解决「pm2 status 出现两个openclaw进程+UI访问不到」联动问题（高频场景），按以下步骤排查，先解决进程冲突，再排查UI问题：

1. 进程冲突原因：多次执行 pm2 start 命令，导致重复启动openclaw进程，抢占18789端口，进而导致UI无法加载（端口被占用，服务无法正常监听）；
2. 彻底清理冗余进程（必做）：执行上述 pm2 stop + pm2 delete 命令后，再执行 pm2 status 确认只有1个openclaw进程（状态为online）；若仍有多个，执行 终止所有pm2管理的进程，再重新启动openclaw；
3. 端口冲突排查：清理进程后，执行 ，确保只有1个node进程（对应openclaw）监听18789端口；若仍有其他进程占用，执行 释放端口，再重启openclaw；
4. UI访问补充排查：清理进程、重启服务后，必须输入完整地址 http://127.0.0.1:18789/openclaw；若仍无法访问，确认配置中 ，执行 修复UI资源，重启服务即可。

3. 访问 Control UI 报错，提示"Missing config"

原因：未完成初始化配置，或配置文件损坏。

解决方案：执行配置向导，重新生成配置文件（同时解决"openclaw.json 没有文件"的问题）： 补充：若执行 openclaw setup 无反应，可替换为 openclaw configure 命令（功能一致，均能生成配置文件）；若仍无法生成，可手动创建目录后重新执行向导，命令如下：

4. 下载依赖卡顿，无法完成安装

原因：网络问题，或未配置国内镜像。

解决方案：配置 npm 国内镜像，或使用kx上网，重新执行安装命令（若仍提示"没有文件"，替换为国内镜像命令）：

5. OpenClaw 一直重启（高频新增问题）

核心原因：分两种安装场景，共4类高频原因（优先级：日志报错 > 配置错误 > 端口/进程冲突 > 依赖/版本问题），先查看错误日志，再针对性解决，避免盲目操作。

场景 1：npm 安装/一键安装用户（PM2 管理）

1. 第一步：查看错误日志（核心，必做），定位重启根源：

   `# 查看 PM2 管理的 openclaw 错误日志（实时刷新，按 Ctrl+C 退出） # 若 PM2 异常，用前台启动查看更详细报错（直接显示启动失败原因） ``

   常见日志报错对应原因：

   1. "port in use"：18789 端口被占用（其他进程或重复的 openclaw 进程）；
   2. "invalid config"/"config not found"：配置文件错误（修改后未保存、格式错误）或未生成；
   3. "missing dependency"：依赖缺失（安装不完整，或 Node.js 版本不匹配）；
   4. "out of memory"：内存不足（低于 4GB 最低要求，优先扩容或关闭其他占用内存的进程）。
2. 第二步：针对性解决（按日志报错选择，无需全部执行）：
   1. 解决端口/进程冲突（最高频）：
   2. 解决配置文件错误：
   3. 解决依赖/版本问题：
   4. 解决内存不足：
3. 第三步：验证是否恢复正常：

补充：若以上步骤仍无法解决，执行"彻底重置"操作（备份配置后），重新安装初始化：

常用命令汇总

 
Skill依赖安装
 参考:https://www.cnblogs.com/databank/p/