OpenClaw Standalone

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

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

---

为什么需要这个项目？

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

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

OpenClaw Standalone 解决了这一切：

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

---

📥 安装方法

Windows（推荐：安装向导）

1. 从 Releases 下载 openclaw-*-win-x64-setup.exe
2. 双击运行安装向导
3. 打开终端，输入 openclaw 即可使用

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

macOS / Linux（一键安装）

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

支持的平台：

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

手动安装

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

---

🚀 快速开始

# 查看帮助
openclaw --help

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

# 启动 AI Gateway
openclaw gateway

# 查看状态
openclaw status

搭配图形管理面板

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

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

使用晴辰云 AI 接口

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

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

---

📦 下载一览

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

---

🏗️ 构建原理

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

GitHub Actions CI Matrix
├── windows-latest  → npm install → 原生模块 x64 编译 → zip + Inno Setup .exe
├── macos-13        → npm install → 原生模块 x64 编译 → tar.gz
├── macos-14        → npm install → 原生模块 ARM 编译 → tar.gz
├── ubuntu-latest   → npm install → 原生模块 x64 编译 → tar.gz
└── ubuntu-arm64    → npm install → 原生模块 ARM 编译 → tar.gz

每个平台的产出包含：

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

本地构建

# Windows
powershell -ExecutionPolicy Bypass -File scripts/package-win.ps1

# macOS / Linux
bash scripts/package-unix.sh

---

🔄 更新

自动更新

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

手动更新

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

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

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

---

❓ 常见问题

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 或购买商业授权

---

🔗 相关项目

• OpenClaw — AI 智能体引擎（上游）
• OpenClaw 汉化版 — 本项目打包的汉化版源码
• ClawPanel — 图形化管理面板
• openclaw-docker — Docker 部署方案
• 晴辰云 — AI 接口服务