Linux 安装指南

适合有终端经验的用户

当前通过安装脚本配置，适合熟悉终端操作的用户。
如果你的目标只是尽快把 AI 助手用起来，Windows 或 macOS 一键包通常会更省心。

📦

预构建安装包

如果版本页面中包含 Linux 构建产物可以直接尝试，也可以使用下面的安装脚本。

GitHub 下载 → 百度网盘下载 →
⌨️

Linux 安装脚本

适合有终端经验但不想从零搭目录的用户。先准备 Node.js，再运行脚本即可。

查看命令 →
先判断，这是不是你该走的路径
如果你愿意看终端输出、能自己处理 Node.js、权限、证书和 Git/npm 问题，这页适合你。
如果你只是想尽快用起来，不想把第一次体验花在排环境上，这页大概率不是最优解。

Linux 安装脚本

如果你熟悉终端但不想从零搭建目录，可以使用 ClawStart 的 Linux 安装脚本。它会自动检查 Node.js 版本、创建本地工作区，并将 OpenClaw 核心程序安装到独立目录。

curl -fsSL https://raw.githubusercontent.com/369pie/clawstart/main/installer/linux/install.sh -o clawstart-linux-beta.sh bash clawstart-linux-beta.sh

安装完成后，进入 ~/.clawstart-linux-beta 并运行 ./launch.sh。如果脚本提示缺少 Node.js 20+，先按它给出的包管理器命令补齐环境。

跑通标准 脚本执行完成不等于已经能用。你至少要成功启动、打开配置界面，并拿到第一条正常回复，才算真正跑通。
下载 Linux 安装脚本 → Linux 常见问题 →

Linux 推荐安装步骤

  1. 先准备 Node.js 20+

    脚本启动时会检查 Node.js 版本；如果版本不够，它会直接给出 apt、dnf、pacman 等安装提示。

  2. 运行安装脚本

    curl -fsSL https://raw.githubusercontent.com/369pie/clawstart/main/installer/linux/install.sh -o clawstart-linux-beta.sh bash clawstart-linux-beta.sh

  3. 进入安装目录并启动

    cd ~/.clawstart-linux-beta ./launch.sh

    如果失败，优先去排障页查看对应 Linux、Git、npm、证书和权限问题，比手动改 PATH 更高效。

选择你的 Linux 系统版本

Ubuntu / Debian / Linux Mint

  1. 安装 Node.js 22+

    # 安装 Node.js 22 LTS curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt-get install -y nodejs

  2. 全局安装 OpenClaw

    npm install -g openclaw@latest

  3. 运行引导向导

    openclaw onboard --install-daemon

Fedora / CentOS / RHEL

  1. 安装 Node.js 22+

    sudo dnf install -y nodejs

  2. 全局安装 OpenClaw

    npm install -g openclaw@latest

  3. 运行引导向导

    openclaw onboard --install-daemon

Arch Linux / Manjaro / EndeavourOS

  1. 安装 Node.js 22+

    sudo pacman -S nodejs npm

  2. 全局安装 OpenClaw

    npm install -g openclaw@latest

  3. 运行引导向导

    openclaw onboard --install-daemon

npm 安装（所有发行版通用）

  1. 安装 nvm 并装 Node.js 22+

    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash source ~/.bashrc nvm install 22

  2. 全局安装 OpenClaw

    npm install -g openclaw@latest

  3. 运行引导向导

    openclaw onboard --install-daemon

常见问题

提示 "EACCES: permission denied" 安装失败？

推荐通过 nvm 安装 Node.js，可以避免大多数全局权限问题。使用 npm 通用 tab 里的方式安装 nvm 后重新操作即可。

如果你已经手动执行过系统级 npm 安装，再回到排障页看权限和缓存问题会更稳。

安装完成后，下一步该做什么？

如果你已经运行过 openclaw onboard --install-daemon，向导会自动帮你配好 Gateway 并启动。

你也可以手动启动 Gateway：

openclaw gateway --port 18789 --verbose

如果遇到问题，建议先去排障页按 Linux、Git、npm、证书和网络问题分流。

安装后启动提示"找不到命令"？

如果你走的是安装脚本，优先使用安装目录里的 ./launch.sh，而不是直接在全局环境里敲 openclaw。

只有在你明确走手动 CLI 路径时，才需要自己处理 PATH 和 npm 全局目录。

安装完成？

先用 ./launch.sh 跑通第一轮；如果中途卡住，优先去排障页查找对应问题，效率比改系统环境高很多。

查看快速开始 → Linux 遇到问题？去排障 →
💼

添加企业微信

添加后可获得1对1答疑支持，优先解决安装和配置问题

二维码

打开微信/QQ扫码即可加入

👋 加入用户社区

遇到问题优先看 排障页