Ubuntu 安装 OpenClaw 完整教程 (避坑指南)Ubuntu 安装 OpenClaw 完整教程 (避坑指南)

Ubuntu 安装 OpenClaw 完整教程 (避坑指南)

系列文章： 《OpenClaw 从入门到精通》第 2 期
上一篇： OpenClaw 是什么？5 分钟理解这个 AI 自动化神器
下一篇： 用 OpenClaw 自动发布 CSDN 文章

📋 前言

这是《OpenClaw 从入门到精通》系列的 第 2 篇。如果你还没看过第 1 篇，建议先回去了解一下 OpenClaw 是什么。

本文我会带你 在 Ubuntu 系统上完整安装 OpenClaw，并且把我遇到的所有坑都告诉你，帮你避开那些我踩过的雷。

预计耗时： 30 分钟
难度等级： ⭐⭐（有 Linux 基础会更轻松）

🖥️ 系统要求

最低配置

操作系统： Ubuntu 20.04+ / Debian 11+ / 其他 Linux 发行版
内存： 4GB RAM（推荐 8GB+）
存储： 10GB 可用空间
网络： 稳定的互联网连接

🔧 安装步骤

步骤 1：更新系统包

sudo apt update && sudo apt upgrade -y

作用： 确保系统是最新的，避免兼容性问题

常见问题：

如果更新慢，可以换国内镜像源（清华/中科大）
更新过程中断，重新执行即可

步骤 2：安装 Node.js（v20+）

OpenClaw 基于 Node.js 开发，需要 v20 或更高版本。

# 方法 1：使用 nvm（推荐）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install 20
nvm use 20

# 验证安装
node -v  # 应该显示 v20.x.x
npm -v   # 应该显示 10.x.x

方法 2：使用官方源

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

⚠️ 避坑指南：

Ubuntu 自带的 Node.js 版本太老（v12/v14），不要用 apt install nodejs
安装完成后一定要验证版本：node -v 必须 >= 20

步骤 3：安装 Chrome 浏览器

OpenClaw 的浏览器自动化功能需要 Chrome。

# 下载 Chrome
wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb

# 安装
sudo dpkg -i google-chrome-stable_current_amd64.deb
sudo apt-get install -f -y

# 验证
google-chrome --version

⚠️ 避坑指南：

如果 dpkg 报错缺少依赖，执行 sudo apt-get install -f -y 自动修复

服务器环境可能需要安装额外依赖：

sudo apt-get install -y libxss1 libappindicator3-1 libindicator7 fonts-liberation libgbm1

步骤 4：安装 OpenClaw

# 全局安装 OpenClaw
npm install -g openclaw

# 验证安装
openclaw --version

安装成功标志：

openclaw/1.x.x linux-x64 node-v20.x.x

⚠️ 避坑指南：

如果权限不足，用 sudo npm install -g openclaw

安装慢可以用淘宝镜像：

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

步骤 5：初始化 OpenClaw

# 创建工作区
mkdir -p ~/openclaw/workspace
cd ~/openclaw/workspace

# 初始化
openclaw init

初始化后会创建以下文件：

workspace/
├── SOUL.md          # AI 人格设定
├── USER.md          # 用户信息
├── IDENTITY.md      # 身份设定
├── MEMORY.md        # 长期记忆
├── TOOLS.md         # 工具配置
└── memory/          # 日常记忆目录

步骤 6：配置 API Key（可选）

如果需要调用大模型，配置 API Key：

# 编辑配置文件
nano ~/.openclaw/config.json

配置示例：

{
  "models": {
    "default": "qwen-plus",
    "qwen": {
      "apiKey": "sk-xxxxxxxx",
      "endpoint": "https://dashscope.aliyuncs.com"
    }
  }
}

支持的模型：

通义千问（阿里）
GPT-4（OpenAI）
Claude（Anthropic）
其他兼容 OpenAI API 的模型

✅ 验证安装

测试 1：基础命令

openclaw --help

预期输出： 显示帮助信息

测试 2：简单任务

openclaw "现在几点了？"

预期输出： 显示当前时间

测试 3：浏览器测试

openclaw "打开百度首页并截图"

预期输出： 打开浏览器，截图保存

🐛 常见问题解决

问题 1：`command not found: openclaw`

原因： npm 全局安装路径不在 PATH 中

解决：

# 找到 npm 全局路径
npm config get prefix

# 添加到 PATH（假设是 ~/.npm-global）
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

问题 2：Chrome 启动失败

错误信息：

error while loading shared libraries: libXXX.so

解决：

sudo apt-get install -y libxss1 libappindicator3-1 libindicator7 fonts-liberation libgbm1

问题 3：权限不足

错误信息：

Error: EACCES: permission denied

解决：

# 方法 1：使用 sudo
sudo openclaw [命令]

# 方法 2：修改目录权限
sudo chown -R $USER:$USER ~/.openclaw

问题 4：网络问题导致安装失败

解决：

# 使用国内镜像
npm config set registry https://registry.npmmirror.com

# 重新安装
npm install -g openclaw --registry https://registry.npmmirror.com

🎯 下一步

安装完成后，你可以：

阅读下一篇教程 - 用 OpenClaw 自动发布 CSDN 文章
查看官方文档 - docs.openclaw.ai
加入社区 - discord.com/invite/claw…

📚 系列文章导航

期数	标题	状态
第 1 期	OpenClaw 是什么？5 分钟理解	✅ 已发布
第 2 期	Ubuntu 安装 OpenClaw 完整教程	✅ 已发布
第 3 期	用 OpenClaw 自动发布 CSDN 文章	下一篇
第 4 期	OpenClaw 浏览器自动化详解	待发布
第 5 期	用 OpenClaw 搭建 AI 定时任务系统	待发布
第 6 期	OpenClaw + Feishu 集成实战	待发布
第 7 期	OpenClaw 源码解析	待发布

💬 互动话题

你在安装过程中遇到了什么问题？
你想用 OpenClaw 自动化什么工作？
需要我补充哪些内容？

欢迎在评论区留言，我会一一解答！

作者： AI 技术实践者
版权声明： 本文为原创，转载请注明出处
最后更新： 2026 年 3 月 21 日

觉得有用？点赞 👍 收藏 ⭐ 关注 ➕ 三连支持一下！

Ubuntu 安装 OpenClaw 完整教程 (避坑指南)