夜雨聆风🐧 Ubuntu 安装 OpenClaw完整教程（避坑指南）
系列文章：《OpenClaw 从入门到精通》第 2 期预计耗时：30 分钟 | 难度：⭐⭐
📋 前言这是《OpenClaw 从入门到精通》系列的第 2 篇。本文我会带你在 Ubuntu 系统上完整安装 OpenClaw，并且把我遇到的所有坑都告诉你，帮你避开那些我踩过的雷。
🖥️ 系统要求
| 操作系统 | ||
| 内存 | ||
| 存储 | ||
| CPU |
🔧 安装步骤
步骤 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 | bashsource ~/.bashrcnvm install 20nvm use 20# 验证安装node -v # 应该显示 v20.x.xnpm -v # 应该显示 10.x.x⚠️ 避坑指南：Ubuntu 自带的 Node.js 版本太老（v12/v14），不要用apt install nodejs。安装完成后一定要验证版本：node -v 必须 >= 20
步骤 3：安装 Chrome 浏览器
OpenClaw 的浏览器自动化功能需要 Chrome
# 下载 Chromewget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb# 安装sudo dpkg -i google-chrome-stable_current_amd64.debsudo 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
步骤 5：初始化 OpenClaw
创建工作区并初始化
# 创建工作区mkdir -p ~/openclaw/workspacecd ~/openclaw/workspace# 初始化openclaw init📁 初始化后会创建以下文件：
SOUL.md- AI 人格设定 USER.md- 用户信息 IDENTITY.md- 身份设定 MEMORY.md- 长期记忆 TOOLS.md- 工具配置 memory/- 日常记忆目录
✅ 验证安装
测试 1：基础命令
openclaw --help预期输出：显示帮助信息
测试 2：简单任务
openclaw "现在几点了？"预期输出：显示当前时间
测试 3：浏览器测试
openclaw "打开百度首页并截图"预期输出：打开浏览器，截图保存
🐛 常见问题解决
问题 1：command not found: openclaw
原因：npm 全局安装路径不在 PATH 中
# 找到 npm 全局路径npm config get prefix# 添加到 PATHecho 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrcsource ~/.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：使用 sudosudo 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 从入门到精通》系列（7 篇）
🔗 相关链接
OpenClaw 官方文档：https://docs.openclaw.ai
GitHub 源码：https://github.com/openclaw/openclaw
社区讨论：https://discord.com/invite/clawd
作者：大鹏
版权声明：本文为原创，转载请注明出处
最后更新：2026 年 3 月 23 日
觉得有用？点赞 👍 收藏 ⭐ 关注 ➕ 三连支持一下！
