Ubuntu 虚拟机安装 OpenClaw（个人 AI 助手）

概述

OpenClaw 是一款个人 AI 助手工具，支持浏览器控制、系统操作、文件管理等功能。本文记录在 Ubuntu 虚拟机中安装 OpenClaw 的完整过程。

一、环境与前置准备

1.1 虚拟机配置要求

1.2 系统初始化和更新

# 更新系统软件包
sudo apt update && sudo apt upgrade -y

# 安装必要工具
sudo apt install -y curl ca-certificates git sudo vim python3 make g++ libvips-dev

二、依赖环境安装

2.1 Node.js 安装

OpenClaw 依赖 Node.js 22+，建议提前安装：

# 添加 NodeSource 仓库（以 24.x 为例）
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -

# 安装 Node.js（包含 npm）
sudo apt install nodejs

# 验证版本
node -v
npm -v

# 切换 npm 到国内源（可选，提升下载速度）
npm config set registry https://registry.npmmirror.com

三、安装 OpenClaw

3.1 一键安装

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

虚拟机运行较慢的话，安装过程可能需要等待一段时间。

3.2 安装配置引导

安装完成后进入引导配置界面，依次处理以下步骤：

① 安全免责声明确认

OpenClaw AI 代理会控制系统，可以读取敏感文件和管理浏览器数据。选择 “是” 确认风险并继续。

② 选择模型

OpenClaw 本身是"有手有脚但没有大脑"的框架，需要选择一个 LLM 作为"大脑"。可选模型包括 MiniMax、Moonshot 等。可以先选 Skip for Now 稍后配置。

③ 消息渠道配置（Channel）

先略过，后续再进行配置。

④ Skills 技能配置

Skills 是 OpenClaw 的工具，用于执行文件操作、浏览器控制、网络抓取、系统命令等。选择 “否”，后续再配置。

⑤ 钩子功能（Hooks）

用于高级日志记录和外部集成，暂时选择 “跳过”。

3.3 启动 OpenClaw

配置完成后，运行诊断命令检查并修复问题：

openclaw doctor

按照引导完成 Gateway 安装和配置，再次运行 openclaw doctor 直到所有问题修复。

确保服务启动后，启动仪表盘：

openclaw dashboard

用浏览器打开显示的链接，即可开始对话使用。

如果需要重新配置，可以运行 openclaw onboard 启动配置向导。

四、配置消息渠道

以飞书为例，安装飞书插件：

openclaw plugins install @openclaw/feishu

按照提示添加事件和配置，OpenClaw 会引导完成整个配置过程。

五、卸载 OpenClaw

方法一：官方命令（推荐）

openclaw uninstall

这会卸载 Gateway 服务和本地数据，CLI 工具本身会保留。

方法二：手动完全卸载

# 1. 停止并禁用服务
openclaw gateway stop
systemctl --user disable openclaw-gateway 2>/dev/null || true

# 2. 卸载 npm 包
npm uninstall -g openclaw

# 3. 删除配置和数据
rm -rf ~/.openclaw

# 4. 删除工作区文件（如果有）
rm -rf ~/.openclaw/workspace

方法三：只删除数据（保留 CLI）

rm -rf ~/.openclaw

六、Windows 下安装说明

Windows 环境推荐使用 WSL（Windows Subsystem for Linux） 进行安装，参考官方文档或相关 WSL 安装指南。

Professional English Terms