Linux Beta 路径

当前属于实验性路径，更适合熟悉终端、愿意自己排错的用户。当前主推荐路径是 Linux Beta 安装脚本，默认安装到 ~/.clawstart-linux-beta。

📦

实验性打包产物

如果 Release 中出现 Linux 构建产物可以尝试，但当前更推荐先走下面的 Linux Beta 安装脚本。

查看最新 Release →
⌨️

Linux Beta 脚本

适合愿意使用终端但不想自己从零搭目录的用户。先准备 Node.js，再运行脚本即可。

查看命令 →

Linux Beta 安装脚本

如果你愿意使用终端，但不想自己从零搭目录，可以先下载 ClawStart 的 Linux Beta 安装脚本。它会检查 Node.js 版本、创建本地工作区，并把底层 OpenClaw CLI 安装到独立目录 ~/.clawstart-linux-beta。

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 Beta 脚本 → Linux 常见问题 →

Linux Beta 推荐步骤

  1. 先准备 Node.js 20+

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

  2. 运行 Linux Beta 脚本

    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

    如果失败，不要先乱改 PATH，优先去排障页对应 Linux、Git、npm、证书和权限问题。

按发行版准备环境

Ubuntu / Debian / Linux Mint

  1. 安装 Node.js 20+

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

  2. 运行 Linux Beta 脚本

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

  3. 启动本地 Beta

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

Fedora / CentOS / RHEL

  1. 安装 Node.js 20+

    sudo dnf install -y nodejs

  2. 运行 Linux Beta 脚本

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

  3. 启动本地 Beta

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

Arch Linux / Manjaro / EndeavourOS

  1. 安装 Node.js 20+

    sudo pacman -S nodejs npm

  2. 运行 Linux Beta 脚本

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

  3. 启动本地 Beta

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

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

  1. 安装 nvm（推荐）

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

  2. 运行 Linux Beta 脚本

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

  3. 启动本地 Beta

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

常见问题

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

先不要自己手动改一堆 npm 全局目录，优先直接回到 Linux Beta 脚本路径。脚本会把依赖安装到 ~/.clawstart-linux-beta/runtime/npm-global，减少全局权限问题。

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

脚本执行完成后，下一步该做什么？

进入默认安装目录并启动：

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

如果这里报错，不要直接重装，先去排障页按 Linux、Git、npm、证书和网络问题分流。

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

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

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

安装完成？

先用 ./launch.sh 跑通第一轮；如果中途卡住，优先去排障页，不要直接回头乱改系统环境。

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