Skillget

openclaw-standalone

agent
Security Audit
Fail
Health Pass
  • License — License: NOASSERTION
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 24 GitHub stars
Code Fail
  • rm -rf — Recursive force deletion command in .github/workflows/build.yml
  • rm -rf — Recursive force deletion command in install.sh
  • rm -rf — Recursive force deletion command in scripts/package-unix.sh
Permissions Pass
  • Permissions — No dangerous permissions requested
Purpose
This tool provides a standalone installer for the OpenClaw AI agent engine, packaging it as a zero-dependency binary for Windows, macOS, Linux, and Raspberry Pi.

Security Assessment
The tool poses a Medium security risk. As a shell-based installer, it inherently executes system commands to deploy software and automatically modifies system paths. The automated audit flagged the presence of `rm -rf` (recursive force deletion) commands in the installation script, the build workflow, and the packaging script. While common in software that manages directory structures, untested `rm -rf` commands can be dangerous if they accidentally target unintended paths. Additionally, the project encourages piping a remote script directly into bash (`curl ... | bash`), a practice that bypasses manual code review before execution. No hardcoded secrets or explicit sensitive data access were found.

Quality Assessment
The project is actively maintained, with its most recent code push occurring today. It claims the AGPL-3.0 license in its documentation, but the repository metadata flags the license as "NOASSERTION," which is a minor transparency issue. Community trust is currently minimal, indicated by a low count of 24 GitHub stars.

Verdict
Use with caution. The tool functions as intended, but users should manually inspect the `install.sh` script for safe directory paths before executing it on their systems.
SUMMARY

OpenClaw Standalone Installer — Zero-dependency, cross-platform pre-built packages for both Official and Chinese editions. No Node.js/npm required. Supports Windows/macOS/Linux/Raspberry Pi.

README.md

OpenClaw Standalone

零依赖安装包 — 无需 Node.js，无需 npm，下载即用！

由 晴辰云 (QingChenCloud) 构建和维护。

Build
License: AGPL-3.0

English version →

为什么需要这个项目？

OpenClaw 是一个强大的 AI 智能体引擎，但官方安装方式依赖 npm install -g，存在以下痛点：

  • 🐢 国内网络慢：npm 默认从境外 registry 下载，大量依赖导致安装耗时 10-30 分钟
  • 🔧 环境要求高：需要预装 Node.js 22+、npm、Git，还可能遇到原生模块编译失败
  • 🤯 新手不友好：各种权限、PATH、网络报错让非技术用户望而却步

OpenClaw Standalone 解决了这一切：

  • ✅ 零依赖：内置 Node.js 运行时和所有预编译依赖
  • ✅ 秒级安装：下载 → 解压 → 就能用
  • ✅ 全平台：Windows / macOS / Linux / 树莓派
  • ✅ Windows 引导安装：专业的 .exe 安装向导，跟装普通软件一样简单
  • ✅ 双版本：同时提供官方原版和汉化版

版本选择

本项目提供 两个版本 的预编译安装包，从同一个仓库同一个 CI 流水线构建：

版本 包名 文件前缀 说明
汉化版 @qingchencloud/openclaw-zh openclaw-zh-* 中文界面和提示，推荐国内用户
官方原版 openclaw openclaw-* 英文原版，与官方 npm 包一致

两个版本功能完全一致，区别仅在于界面语言和提示文本。

安装方法

Windows（推荐：安装向导）

  1. 从 Releases 下载对应版本的安装包：
    • 汉化版：openclaw-zh-*-win-x64-setup.exe
    • 原版：openclaw-*-win-x64-setup.exe
  2. 双击运行安装向导
  3. 打开终端，输入 openclaw 即可使用

也可以下载 .zip 绿色免安装版，解压后手动添加目录到 PATH。

macOS / Linux（一键安装）

# 汉化版（默认）
curl -fsSL https://dl.qrj.ai/openclaw/install.sh | bash

# 官方原版
curl -fsSL https://dl.qrj.ai/openclaw/install.sh | EDITION=en bash

支持的平台：

  • macOS ARM64 (Apple Silicon / M1-M4)
  • Linux x64
  • Linux ARM64 (树莓派 4/5、ARM 服务器)

手动安装

  1. 从 Releases 下载对应平台和版本的压缩包
  2. 解压到任意目录
  3. 将该目录添加到系统 PATH
  4. 打开终端，输入 openclaw --version 验证

下载一览

汉化版 (openclaw-zh-*)

平台 架构 文件类型 说明
Windows x64 .exe 安装包 引导式安装，自动配置 PATH
Windows x64 .zip 绿色免安装，解压即用
macOS ARM64 (Apple Silicon) .tar.gz 解压即用
Linux x64 .tar.gz 解压即用
Linux ARM64 .tar.gz 树莓派、ARM 服务器

官方原版 (openclaw-*)

平台 架构 文件类型 说明
Windows x64 .exe installer Guided setup
Windows x64 .zip Portable
macOS ARM64 (Apple Silicon) .tar.gz Extract & run
Linux x64 .tar.gz Extract & run
Linux ARM64 .tar.gz Raspberry Pi, ARM servers

快速开始

# 查看帮助
openclaw --help

# 初始化配置（首次使用）
openclaw setup

# 启动 AI Gateway
openclaw gateway

# 查看状态
openclaw status

搭配图形管理面板

推荐安装 ClawPanel 图形化管理面板，提供：

  • 可视化模型配置
  • 智能体管理
  • 消息渠道（飞书、钉钉、QQ 等）
  • Docker 军团调度
  • 定时任务、技能市场等

使用晴辰云 AI 接口

晴辰云 提供兼容 OpenAI 的 API 接口：

  • 每天签到送免费额度
  • 支持 GPT-5 全系列模型
  • 端点：https://gpt.qt.cool/v1

构建原理

本项目的核心思想：在 CI 的各平台 runner 上预编译所有原生模块，打包 Node.js 运行时 + 完整 node_modules 成自包含发行包。

GitHub Actions CI Matrix (2 editions × 4 platforms = 8 parallel builds)

汉化版 (zh):                           官方原版 (en):
├── windows-latest → zip + .exe         ├── windows-latest → zip + .exe
├── macos-15       → tar.gz             ├── macos-15       → tar.gz
├── ubuntu-latest  → tar.gz             ├── ubuntu-latest  → tar.gz
└── ubuntu-arm64   → tar.gz             └── ubuntu-arm64   → tar.gz

每个平台的产出包含：

  • node / node.exe — Node.js 运行时
  • openclaw / openclaw.cmd — CLI 入口脚本
  • node_modules/ — 所有依赖（含预编译的原生模块）
  • VERSION — 版本和版本源信息

本地构建

# Windows - 汉化版（默认）
powershell -ExecutionPolicy Bypass -File scripts/package-win.ps1

# Windows - 官方原版
powershell -ExecutionPolicy Bypass -File scripts/package-win.ps1 -OpenClawPkg openclaw

# macOS / Linux - 汉化版（默认）
bash scripts/package-unix.sh

# macOS / Linux - 官方原版
OPENCLAW_PKG=openclaw bash scripts/package-unix.sh

更新

自动更新

ClawPanel 会自动检测新版本并提示更新。

手动更新

重新运行安装脚本即可覆盖安装：

# macOS / Linux
curl -fsSL https://dl.qrj.ai/openclaw/install.sh | bash

# Windows
# 重新下载安装包运行即可

常见问题

Q: 汉化版和原版有什么区别？

A: 功能完全一致。区别在于界面语言和提示文本——汉化版是中文，原版是英文。汉化版基于 @qingchencloud/openclaw-zh，原版基于官方 openclaw npm 包。

Q: 这个跟 npm install -g openclaw 有什么区别？

A: 效果完全一样，但不需要预装 Node.js 和 npm，也不需要网络下载依赖。所有东西都预编译打包好了。

Q: 支持树莓派吗？

A: 支持！下载 linux-arm64 版本即可。支持树莓派 4/5 及其他 ARM64 设备。

Q: 安装包为什么这么大（200-300MB）？

A: 因为包含了完整的 Node.js 运行时和所有预编译的依赖（包括图片处理库 sharp、SQLite 等原生模块）。这是"零依赖"的代价，但相比 npm 安装耗时 30 分钟，一次下载几分钟更划算。

Q: 能跟 npm 安装的 OpenClaw 共存吗？

A: 可以，但建议只保留一个。如果两个都在 PATH 中，系统会使用 PATH 中靠前的那个。

许可证

AGPL-3.0 + 商业授权

  • 个人/学生/非商业：完全自由 ✅
  • 企业商用：需遵守 AGPL 或购买商业授权

相关项目

Reviews (0)

No results found