在Ubuntu上部署OpenClaw

环境信息
系统: Ubuntu 24.04 LTS
配置: >2核 4GB内存

一、安装依赖

1.1 更新系统包索引

# 更新系统包列表
sudo apt update

# 安装curl
sudo apt install -y curl

# 如需要，安装并启动 OpenSSH 服务（方便通过 PC 远程管理）
sudo apt install -y openssh-server

1.2 设置淘宝镜像（最常用）

npm config set registry https://registry.npmmirror.com 

# 查询是否配置成功
npm config get registry

二、安装OpenClaw

方法一：推荐安装脚本（一键式）

脚本自动完成 Node.js 检测/安装、CLI 全局安装、启动引导向导，是最省心的方式。

标准安装

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

或使用 curl -fsSL https://molt.bot/install.sh | bash

方法二：npm /pnpm 手动安装

适合已安装 Node.js 22+ 且希望自主管理安装流程的用户。

操作系统提示：
macOS：如果仅使用命令行和网关功能，Node.js足够。若要构建桌面应用，需安装Xcode或 Command Line Tools。
Windows：强烈推荐使用 WSL2（建议Ubuntu）。原生Windows环境未经充分测试，可能会遇到更多兼容性问题。请先安装 WSL2，然后在 WSL 内部进行以下所有操作。

前置步骤：Node.js 22+ 安装（若未安装）
Ubuntu 24.04.4 默认源可能无 Node.js 22，推荐通过 NodeSource 安装：

更新包并检查Node.js版本
在终端输入以下命令，确认 Node 版本在 22 或以上：

# 1. 更新包索引并安装基础依赖
sudo apt update
sudo apt install -y curl

# 2. 添加 NodeSource 22.x 仓库
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

# 3. 安装 Node.js（含 npm）
sudo apt install -y nodejs

# 4. 验证安装
node -v  # 应输出 v22.x.x
npm -v   # 验证 npm 版本

npm全局安装OpenClaw

为避免sudo权限问题，建议先配置npm全局目录到用户路径：

# 1. 创建用户级 npm 全局目录
mkdir -p ~/.npm-global

# 2. 配置 npm 使用该目录
npm config set prefix '~/.npm-global'

# 3. 将目录添加到系统 PATH（重启终端后生效）
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc  # 立即生效

然后安装 OpenClaw：

# 安装最新版
npm install -g openclaw@latest

# 运行引导并安装守护进程（推荐）
openclaw onboard --install-daemon

3.sharp构建错误处理（Ubuntu常见问题）

sharp是图像处理依赖，若 Ubuntu 已全局安装 libvips（如通过 sudo apt install libvips-dev），可能导致构建失败。解决方法：

方案 1：强制使用预编译二进制（推荐）

1	SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

方案 2：安装构建工具后重试

若提示 sharp: Please add node-gyp to your dependencies：

# 安装 Ubuntu 构建依赖
sudo apt install -y build-essential python3

# 全局安装 node-gyp
npm install -g node-gyp

# 重新安装 OpenClaw
npm install -g openclaw@latest

方法三：从源码安装（适合开发者/贡献者）

需手动克隆仓库、构建依赖，适合想修改代码或运行最新开发版的用户。

前置准备：安装基础依赖

# 1. 安装 Git、构建工具
sudo apt update
sudo apt install -y git build-essential python3

# 2. 若未安装 Node.js 22+，参考“方法二前置步骤”

# 3. 安装 pnpm（构建必需）
npm install -g pnpm@10

1.克隆仓库并构建

# 克隆 OpenClaw 仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 安装项目依赖
pnpm install

# 构建 UI（首次运行会自动安装 UI 依赖，需耐心等待）
pnpm ui:build

# 构建 OpenClaw 核心
pnpm build

2. 链接CLI（全局可用）

1	pnpm link --global

若不链接，可在仓库目录内通过 pnpm openclaw … 运行命令（如 pnpm openclaw onboard）。

3. 运行引导

1	openclaw onboard --install-daemon

常用命令

- 更新OpenClaw

1	openclaw update --channel stable # 切换到 stable/beta/dev 通道

2.检查配置健康度

1	openclaw doctor # 自动修复常见配置问题

3.其它命令

命令	作用	说明
openclaw onboard	启动配置向导	交互配置，如果遇到问题可以重新执行引导
openclaw gateway install	安装服务	同时启动，开机自启
openclaw gateway start	启动服务	需要先安装install
openclaw gateway stop	停止服务	会卸载服务
openclaw gateway status	查看状态	检查服务是否运行
openclaw logs --follow	查看执行过程中的日志

三、验证安装

运行以下命令，如果能正常显示版本号或帮助信息，则表示安装成功。

openclaw --version
# 或
openclaw -h

# 查看安装位置
which openclaw
npm list -g --depth=0

四、配置向导

OpenClaw 提供了一个交互式向导来帮你完成初始设置。
在终端中执行以下命令开始配置(安装时也会出现配置)：

1	openclaw onboard

接下来，跟着向导一步步操作：

1.风险确认：你会看到一句提示 I understand this is powerful and inherently risky. Continue?，直接输入 Yes 并回车。这是因为 OpenClaw 可以操作你的电脑，需要你明确授权。

2.选择模式：选择 QuickStart，它将自动帮你配置好大部分默认设置，对新手最友好。

3.配置 AI 模型：OpenClaw 需要一个“聪明的大脑”（大语言模型）来理解你的指令。这里你可以：

Model/auth provider：选择你希望使用的模型供应商。如果你还没有 API Key，可以先选择 “Skip for now” 跳过，后续在网页界面配置也一样方便。
Filter models by provider：同样，可以先选择 “All providers” 或直接“Skip for now” 。

即使没有API Key，也可以先完成向导，选择“Skip for now” ，后续会介绍如何配置。

4.配置通信渠道：问你想通过什么软件和它聊天，比如 Telegram、飞书。第一次尝试，建议选择 “Skip for now” 跳过，我们先使用它自带的网页版界面。

5.配置技能（Skills）：是否现在添加特定技能？同样，先选 “No” 跳过。

说明：

skills	说明	是否推荐安装
`1password`	使用 1Password CLI 安全读取密码、API 密钥等敏感信息。适合企业用户保护凭证。	✅ 推荐（高安全需求）
`blogwatcher`	监控博客更新并自动通知（如 RSS 订阅）。适合内容创作者。	❌ 一般不需
`blucli`	BluOS CLI 工具，用于发现和管理 OpenClaw 技能。它是技能市场的核心命令行接口。	✅ 必须安装（建议勾选）
`camsnap`	从摄像头拍摄照片或视频流（如监控）。	❌ 除非你有摄像头需求
`clawhub`	通过 ClawHub 搜索、安装和管理公开技能包。类似 npm 或 pip。	✅ 强烈推荐（获取更多技能）
`eightctl`	与 Eight (AI Agent 平台) 集成，可能用于调度或任务分发。	❌ 一般不用
`gemini`	支持 Google Gemini 模型（如 gemini-1.5-pro），让 OpenClaw 能调用 Google AI。	✅ 如果你用 Google 生态
`gifgrep`	在 GIF 图像中搜索文本或关键词（基于 OCR）。	❌ 小众用途
`github`	与 GitHub API 交互：创建 Issue、PR、查看仓库、提交代码等。	✅ 推荐（开发者必备）
`gog`	GOG 游戏平台集成（可能用于自动化游戏下载/更新）。	❌ 不相关
`goplaces`	获取 Google Places 数据（地点、评分、评论等）。	❌ 除非做地图应用
`himalaya`	可能是一个本地文件同步或备份工具（名称来自“喜马拉雅”）。	❌ 未知用途
`mcporter`	Minecraft 服务器端口转发或管理工具？	❌ 不常用
`nano-banana-pro`	名称搞笑，可能是实验性技能（如“香蕉”主题的自动化）。	❌ 可忽略
`nano-pdf`	处理 PDF 文档（提取文本、合并、转换等）。	✅ 推荐（文档处理）
`obsidian`	与 Obsidian 笔记软件集成，实现笔记查询、标签管理、自动生成大纲等。	✅ 推荐（知识工作者）
`openai-whisper`	使用 OpenAI Whisper 模型进行语音转文字（STT）。	✅ 推荐（语音输入场景）
`openhue`	控制 Philips Hue 灯泡（智能家居）。	❌ 除非你有智能灯
`oracle`	连接 Oracle 数据库（SQL 查询、数据导出）。	✅ 数据库管理员可用
`ordercli`	订单管理系统 CLI（可能是电商或内部系统集成）。	❌ 业务定制
`sag`	可能是 “Smart Assistant Gateway” 或某个私有项目缩写。	❌ 未知
`songsee`	歌曲识别或音乐推荐工具？	❌ 小众
`sonoscli`	控制 Sonos 音响系统（播放音乐、调整音量）。	❌ 智能家居用户
`summarize`	自动生成文章摘要（支持文本、网页、PDF）。	✅ 推荐（高效阅读）
`video-frames`	提取视频中的帧图像（用于分析或截图）。	✅ 视频处理者可用
`wacli`	WhatsApp 命令行客户端（发送消息、接收通知）。	✅ 如果你用 WhatsApp 工作

skills如何确认是否安装成功

列出所有已安装的技能

1	blucli skills list

6.配置钩子（Hooks）：这是高级功能，用于在启动时加载文档、记录日志等。

在 OpenClaw 中，Hook（钩子）是一种轻量级的自动化脚本，会在以下事件发生时触发：

启动时
每次命令执行前/后
会话开始/结束
文件加载等

它们可以用来：

记录日志
加载额外文件
自动保存上下文
执行预设命令

Hook 名称	作用说明	是否推荐启用
`boot-md`	在启动时自动加载 Markdown 文件作为初始知识库（如 README.md、FAQ.md）
→ 你可以把常用指令、规则写进 `.md` 文件，让 AI 知道你的偏好	✅ 推荐（适合个性化助手）
`bootstrap-extra-files`	启动时自动加载指定目录下的额外文件（如 JSON 配置、CSV 数据表、API 文档）
→ 帮助 AI 快速了解你的项目结构	✅ 推荐（如果你有固定数据源）
`command-logger`	记录所有执行过的命令到日志文件中
→ 便于调试、审计和复盘 AI 的行为	✅ 强烈推荐（开发者必开）
`session-memory`	为每次会话保存记忆（如上下文对话、变量状态）
→ 让 AI 能记住“我们之前说过了什么”，避免重复提问	✅ 强烈推荐（提升交互体验）