下载指南

OpenClaw 下载 — 官方下载渠道汇总

OpenClaw 是开源 AI 智能体框架，支持 Docker 镜像、GitHub 源码两种下载方式。国内用户可使用镜像加速，或选择免下载的 OpenClaw Launch 云端托管方案。

OpenClaw 官方下载渠道

OpenClaw 是完全开源的 AI 智能体框架（MIT 许可证），在 GitHub 上拥有超过 270,000 颗星。目前有三种官方获取方式：

方式	适合人群	难度	所需时间
Docker 镜像	有 Docker 经验的开发者	中等	30-60 分钟
GitHub 源码编译	高级用户 / 想要自定义	较高	1-2 小时
OpenClaw Launch（免下载）	所有用户（推荐）	零门槛	10 秒

Docker 镜像下载（推荐自建方式）

Docker 是运行 OpenClaw 的官方推荐方式。官方镜像托管在 GitHub Container Registry（ghcr.io），一条命令即可拉取：

docker pull ghcr.io/openclaw/openclaw:latest

镜像标签说明

标签	说明	推荐程度
`:latest`	最新稳定版，经过测试，适合生产环境	强烈推荐
`:main`	开发分支实时构建（bleeding edge），可能包含未修复的 Bug	不推荐

警告：不要在生产环境使用 :main 标签。该标签跟踪开发分支的最新提交，曾经出现过 Telegram 轮询 Bug 等问题。始终使用 :latest 以获得稳定体验。

镜像信息

镜像大小：约 500MB（压缩后），包含 Node.js 运行时、OpenClaw 核心代码、Gateway 服务端及所有内置插件
基础镜像：基于 Node.js 官方镜像，以 node 用户（uid 1000）运行
架构支持：linux/amd64（Intel/AMD 处理器），Apple Silicon 通过 Rosetta 兼容
启动命令：node openclaw.mjs gateway --allow-unconfigured
内存要求：建议 --memory=2g --memory-swap=3g，512MB 会导致 OOM 崩溃

快速启动

# 1. 创建配置目录
mkdir -p ~/.openclaw/credentials
chmod 777 ~/.openclaw
chmod 777 ~/.openclaw/credentials

# 2. 拉取镜像
docker pull ghcr.io/openclaw/openclaw:latest

# 3. 启动容器
docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/home/node/.openclaw \
  --memory=2g \
  --memory-swap=3g \
  --restart unless-stopped \
  ghcr.io/openclaw/openclaw:latest \
  node openclaw.mjs gateway --allow-unconfigured

# 4. 查看日志
docker logs openclaw -f

详细的 Docker 部署教程（包括配置文件编写、Docker Compose、问题排查）请参阅：OpenClaw Docker 部署完整教程。

GitHub 源码下载

OpenClaw 是完全开源的项目，源码托管在 GitHub，MIT 许可证，任何人都可以自由使用、修改和分发。

GitHub 仓库：github.com/nicepkg/openclaw
Stars：270,000+
许可证：MIT（完全自由，可商用）
编程语言：TypeScript / JavaScript（Node.js）

从源码构建（高级用户）

如果你想修改 OpenClaw 源码、贡献代码或进行深度自定义，可以从源码编译：

# 1. 克隆仓库
git clone https://github.com/nicepkg/openclaw.git
cd openclaw

# 2. 安装依赖（需要 Node.js 20+）
npm install

# 3. 构建项目
npm run build

# 4. 启动 Gateway
node openclaw.mjs gateway --allow-unconfigured

提示：从源码构建适合有 Node.js 开发经验的高级用户。大多数用户推荐直接使用 Docker 镜像或 OpenClaw Launch 托管服务。

下载 Release 版本

你也可以从 GitHub Releases 页面下载特定版本的源码压缩包：

访问 GitHub Releases 页面
选择需要的版本（推荐 Latest Release）
下载 Source code（zip 或 tar.gz）
解压后按上述步骤编译运行

OpenClaw Launch — 免下载方案（推荐）

不想折腾下载、安装、配置？OpenClaw Launch 是官方托管平台，让你完全跳过所有下载和部署步骤：

零下载 — 不需要安装 Docker、不需要拉取镜像、不需要克隆代码，打开浏览器即可使用
可视化配置 — 点选式配置编辑器，告别手写 JSON 的痛苦和格式错误
10 秒部署 — 配置好模型和渠道后一键部署，10 秒内你的 AI 智能体就上线了
自动更新 — 始终运行 OpenClaw 最新稳定版，无需手动拉取镜像或重建容器
零运维 — 服务器、SSL 证书、监控告警全部自动处理，你只需关注 AI 智能体本身
国内友好 — 服务器在美国，直连所有 AI 模型 API（OpenAI、Anthropic、Google 等），无需代理

	自建下载	OpenClaw Launch
下载安装	需要（Docker 500MB+ 或源码编译）	不需要
配置方式	手写 JSON	可视化编辑器
部署时间	30 分钟 - 2 小时	10 秒
版本更新	手动操作	自动
服务器成本	$5-20/月	$3/月起
支付方式	—	支持支付宝、微信支付

版本信息与更新日志

OpenClaw 保持活跃的开发节奏，定期发布新版本。每个版本的更新内容可以在以下渠道查看：

GitHub Releases：github.com/nicepkg/openclaw/releases — 包含每个版本的完整更新日志、新功能说明和 Bug 修复列表
GitHub Commits：查看 main 分支的提交历史，了解最新开发进展
Docker Tags：执行 docker pull ghcr.io/openclaw/openclaw:latest 始终获取最新稳定版

如何检查当前版本：启动 OpenClaw 后，在 Web UI 底部或启动日志中可以看到当前运行的版本号。

各平台下载指南

针对不同操作系统，我们准备了详细的下载安装教程：

Docker 部署完整教程 — 适用于所有平台，推荐的自建方式
OpenClaw 安装部署教程 — 从零开始的完整入门指南

无论你使用 Linux、macOS 还是 Windows，Docker 都是最简单的自建方式。Windows 用户需要先启用 WSL2，macOS 用户安装 Docker Desktop 即可。

国内下载加速

由于 GitHub 和 ghcr.io 在国内的访问速度不稳定，以下是经过验证的加速方案：

Docker 镜像加速器配置

配置 Docker 镜像加速器可以显著提升拉取速度。以下是主流的加速服务：

阿里云容器镜像加速 — 登录阿里云容器镜像服务，获取专属加速地址（格式：https://你的ID.mirror.aliyuncs.com）
腾讯云镜像加速 — 腾讯云容器服务提供加速，地址 https://mirror.ccs.tencentyun.com
DaoCloud 镜像加速 — DaoCloud 加速器，免费使用，注册即可获取

# 配置 Docker 镜像加速器
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<EOF
{
  "registry-mirrors": [
    "https://你的ID.mirror.aliyuncs.com",
    "https://mirror.ccs.tencentyun.com"
  ]
}
EOF

# 重启 Docker 使配置生效
sudo systemctl daemon-reload
sudo systemctl restart docker

注意：以上加速器主要加速 Docker Hub（docker.io）镜像。对 ghcr.io 的支持因服务商而异。如果加速器不支持 ghcr.io，请使用下方的"离线导入"方案。

离线镜像导入（最可靠）

在能够正常访问 ghcr.io 的机器（如海外 VPS、公司 VPN 等）上拉取镜像并导出，然后传输到国内服务器：

# 在能访问 ghcr.io 的机器上
docker pull ghcr.io/openclaw/openclaw:latest
docker save ghcr.io/openclaw/openclaw:latest | gzip > openclaw-latest.tar.gz

# 传输到国内服务器（约 500MB）
scp openclaw-latest.tar.gz user@your-server:~/

# 在国内服务器上导入
gunzip -c openclaw-latest.tar.gz | docker load

GitHub 源码加速克隆

如果从源码构建，可以使用 GitHub 镜像站加速 git clone：

# 使用 ghproxy.com 加速（免费代理）
git clone https://ghproxy.com/https://github.com/nicepkg/openclaw.git

# 或使用 gitclone.com
git clone https://gitclone.com/github.com/nicepkg/openclaw.git

npm 依赖加速

从源码构建时，npm install 需要下载大量依赖包。使用国内 npm 镜像可以大幅提速：

# 使用 npmmirror.com（原淘宝 npm 镜像）
npm install --registry=https://registry.npmmirror.com

# 或全局设置镜像
npm config set registry https://registry.npmmirror.com

常见问题

OpenClaw 是免费的吗？

OpenClaw 本身是开源免费的（MIT 许可证），你可以从 GitHub 下载源码或 Docker 镜像免费使用。但自建需要服务器成本（$5-20/月）和运维时间。如果不想自建，可以使用 OpenClaw Launch 托管服务，$3/月起。

如何更新到最新版本？

Docker 用户执行 docker pull ghcr.io/openclaw/openclaw:latest 拉取最新镜像，然后重建容器即可。源码用户执行 git pull 后重新构建。OpenClaw Launch 用户无需操作，平台自动更新。

应该下载哪个版本？

推荐使用 :latest 标签（最新稳定版）。不要使用 :main 标签，那是开发分支的实时构建，可能包含未修复的 Bug。

下载安全吗？

OpenClaw 是开源项目，源码托管在 GitHub，所有代码公开可审计。Docker 镜像通过 GitHub Container Registry（ghcr.io）分发，由 GitHub Actions 自动构建，不经过人工干预。MIT 许可证，无恶意代码风险。

国内下载速度很慢怎么办？

可以配置 Docker 镜像加速器（阿里云、腾讯云、DaoCloud），或者在能访问 ghcr.io 的机器上用 docker save 导出镜像文件后传输。GitHub 源码可通过镜像站（如 ghproxy.com）加速克隆。也可以直接使用 OpenClaw Launch 托管服务，无需任何下载。

OpenClaw 支持哪些操作系统？

Docker 镜像支持所有能运行 Docker 的系统：Linux（Ubuntu、CentOS、Debian 等）、macOS（Intel 和 Apple Silicon）、Windows（通过 WSL2）。源码编译需要 Node.js 20+ 环境。

下载方式选择建议

想立刻用上 AI 智能体？选择 OpenClaw Launch，10 秒部署，零下载零配置，$3/月起。

想自建掌控一切？选择 Docker 镜像，一条命令拉取，配合我们的 Docker 部署教程半小时搞定。

想修改源码或贡献代码？从 GitHub 克隆源码，自由定制，MIT 许可证无限制。