夜雨聆风OpenClaw 教程
Ubuntu 安装 OpenClaw 完整教程（避坑指南）
导读： 想学 OpenClaw 但卡在安装这一步？本文是我在 Ubuntu 上安装 OpenClaw 的完整记录，包含所有我踩过的坑和解决方案。按照这个教程，30 分钟搞定安装！
📋 前言
这是《OpenClaw 从入门到精通》系列的 第 2 篇。
昨天发布了第 1 篇《OpenClaw 是什么？》，很多小伙伴后台留言问：
“说得很心动，但怎么安装？” “我按照文档安装报错了，怎么办？” “有没有详细的安装教程？”
今天这篇教程，就是我 在 Ubuntu 系统上完整安装 OpenClaw 的实战记录。我会把遇到的所有坑都告诉你，帮你避开那些我踩过的雷。
安装完成后，你将能够： - ✅ 用自然语言控制电脑 - ✅ 自动执行浏览器任务 - ✅ 创建 AI 定时任务 - ✅ 集成各种 API 和服务
预计耗时： 30 分钟
难度等级： ⭐⭐（有 Linux 基础会更轻松）
🖥️ 系统要求
最低配置
硬件 要求
操作系统 Ubuntu 20.04+ / Debian 11+
内存 4GB RAM（推荐 8GB+）
存储 10GB 可用空间
网络 稳定的互联网连接
推荐配置
硬件 要求
CPU 4 核以上
内存 8GB+
存储 SSD 20GB+
网络 宽带连接
🔧 完整安装步骤
步骤 1：更新系统包
打开终端，执行以下命令：
sudo apt update && sudo apt upgrade -y
作用： 确保系统是最新的，避免兼容性问题
常见问题：
问题 1： 更新速度慢
解决： 换国内镜像源（清华/中科大）
# 备份原配置
sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak
# 使用清华镜像源
sudo tee /etc/apt/sources.list << 'EOF'
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ focal-updates main restricted universe multiverse
EOF
# 更新
sudo apt update
问题 2： 更新过程中断
解决： 重新执行即可
sudo apt update && sudo apt upgrade -y
步骤 2：安装 Node.js（v20+）
OpenClaw 基于 Node.js 开发，需要 v20 或更高版本。
方法 1：使用 nvm（强烈推荐）
nvm 是 Node.js 版本管理工具，可以轻松切换不同版本。
# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
# 加载 nvm
source ~/.bashrc
# 验证 nvm 安装
nvm --version
# 安装 Node.js 20
nvm install 20
# 使用 Node.js 20
nvm use 20
# 验证安装
node -v # 应该显示 v20.x.x
npm -v # 应该显示 10.x.x
方法 2：使用官方源
# 添加 NodeSource 源
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
# 安装 Node.js
sudo apt-get install -y nodejs
# 验证
node -v
npm -v
⚠️ 重要提醒： - 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
常见问题：
问题 1： dpkg 报错缺少依赖
解决： 执行以下命令自动修复
sudo apt-get install -f -y
问题 2： 服务器环境启动失败
解决： 安装额外依赖
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
常见问题：
问题 1： 权限不足
解决： 使用 sudo
sudo npm install -g openclaw
问题 2： 安装速度慢
解决： 使用淘宝镜像
npm config set registry https://registry.npmmirror.com
npm install -g openclaw
问题 3： 安装失败
解决： 清理缓存后重试
npm cache clean --force
npm install -g openclaw
步骤 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 长文本处理优秀
✅ 验证安装
测试 1：基础命令
openclaw --help
预期输出： 显示帮助信息
测试 2：简单任务
openclaw "现在几点了？"
预期输出： 显示当前时间
测试 3：浏览器测试
openclaw "打开百度首页并截图"
预期输出： 打开浏览器，截图保存
测试 4：文件操作
openclaw "在当前目录创建一个测试文件"
预期输出： 创建文件成功
🐛 常见问题解决
问题 1：command not found: openclaw
原因： npm 全局安装路径不在 PATH 中
解决：
# 找到 npm 全局路径
npm config get prefix
# 添加到 PATH
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
# 验证
openclaw --version
问题 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
问题 5：Node.js 版本不对
错误信息：
Error: OpenClaw requires Node.js v20 or higher
解决：
# 检查当前版本
node -v
# 使用 nvm 切换到 v20
nvm install 20
nvm use 20
# 验证
node -v
🎯 安装完成后做什么？
1. 阅读下一篇教程
用 OpenClaw 自动发布 CSDN 文章
2. 查看官方文档
https://docs.openclaw.ai
3. 尝试简单任务
# 打开网页
openclaw "打开百度"
# 创建文件
openclaw "在桌面创建一个测试文件"
# 查询天气
openclaw "北京今天天气怎么样"
4. 加入社区
和其他用户交流经验，获取更多使用技巧。
📚 系列文章导航
期数 标题 状态
第 1 期 OpenClaw 是什么？5 分钟理解 ✅ 已发布
第 2 期 Ubuntu 安装 OpenClaw 完整教程 ✅ 本文
第 3 期 用 OpenClaw 自动发布 CSDN 文章 下一篇
第 4 期 OpenClaw 浏览器自动化详解 待发布
💬 互动话题
你在安装过程中遇到了什么问题？
你想用 OpenClaw 自动化什么工作？
需要我补充哪些内容？
欢迎在评论区留言，我会一一解答！
作者： AI 技术实践者
版权声明： 本文为原创，转载请注明出处
最后更新： 2026 年 3 月 22 日
觉得有用？点赞 👍 收藏 ⭐ 关注 ➕ 三连支持一下！
