🐧 Ubuntu 安装 OpenClaw完整教程（避坑指南）

系列文章：

《OpenClaw 从入门到精通》第 2 期预计耗时：30 分钟  |  难度：⭐⭐

#Ubuntu#安装教程#OpenClaw#避坑指南

📋 前言这是《OpenClaw 从入门到精通》系列的第 2 篇。本文我会带你在 Ubuntu 系统上完整安装 OpenClaw，并且把我遇到的所有坑都告诉你，帮你避开那些我踩过的雷。

🖥️ 系统要求

🔧 安装步骤

步骤 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 日

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