帮助中国用户零门槛安装部署小龙虾 (OpenClaw Agent) 的工具。
- 完全没有开发基础的新手
- 不会使用命令行的用户
- 在中国网络环境下遇到安装困难的用户
下载安装程序，双击运行，全程鼠标操作，无需任何命令行知识。
| 系统 | 下载链接 |
|---|---|
| Windows (.exe) | 下载 v1.0.8 安装器 |
安装程序会自动帮你：
- 🔍 检测系统环境和兼容性
- 📦 安装合适版本的 Node.js（智能适配你的系统）
- 🌐 检测网络并配置国内镜像源
- 🦞 安装小龙虾 (OpenClaw)
- 🎯 启动配置向导（自动在新终端窗口中打开）
全程可视化，有进度条、有弹窗提示，你只需要点击按钮即可。
如果安装失败，安装程序现在支持：
- 直接显示错误代码
- 一键复制诊断信息
- 把系统信息、错误详情和最近日志一起发给开发者排查
⚠️ macOS 图形安装包暂时下线，原因是正式的 Apple Developer 签名和 notarization 流程仍在准备中。为了避免 Mac 用户遇到“安装包无法打开”之类的系统拦截问题，当前请先使用下面的命令行安装方式。
安装程序内显示的开发者信息：
- 开发者：Pink 和他的 Codex
- 联系方式：cyberpink.xx@gmail.com
- 开源仓库：https://github.com/cyberpinkman/openclaw-easy-deploy
💡 安装程序还支持修复安装和卸载功能。如果你的电脑已经安装过小龙虾，打开安装程序会自动检测并提供修复或卸载选项。
💡 完全卸载会优先按安装器记录的“安装前状态”回滚系统改动，例如 Git 镜像、npm 源，以及 onboarding 期间可能变更的系统代理。它不会无差别重置你当前电脑上的所有代理设置。
💡 点击“启动配置向导”后，安装程序会在新的终端窗口里运行
openclaw onboard --install-daemon。如果没有看到新窗口弹出，请手动检查系统是否拦截了终端启动权限。
打开「终端」，复制粘贴以下命令：
方式一：Gitee（国内推荐）
curl -fsSL https://gitee.com/cyberpinkman/openclaw-easy-deploy/raw/main/mac/install.sh | bashGitHub
curl -fsSL https://raw.githubusercontent.com/cyberpinkman/openclaw-easy-deploy/main/mac/install.sh | bash如果运行上面的 curl 命令时看到：
curl: (60) SSL certificate problem: certificate is not yet valid优先检查 Mac 的系统时间是否正确。这个报错通常不是安装脚本本身有问题，而是本机时间明显早于网站证书的生效时间。
先在终端执行：
date如果日期或年份不对，请到：
- 系统设置
- 通用
- 日期与时间
打开“自动设置日期与时间”，校准后再重新运行安装命令。
如果系统时间正确，但 Gitee 仍然报同样错误，请改用 GitHub 那条命令重试。
- 打开安装程序（同安装时的 .dmg / .exe）
- 安装程序会检测到已有安装，自动弹出选项
- 选择「卸载」
- 选择卸载方式：
- 简单卸载：移除小龙虾命令，保留你的配置数据（方便以后重装）
- 完全卸载：删除所有文件，并恢复安装器实际改动过的配置（Git 镜像、后台服务、npm 源等）
npm uninstall -g openclaw如需清理配置数据，删除以下目录：
- Mac:
~/.openclaw和~/.config/openclaw - Windows:
%APPDATA%\openclaw和%LOCALAPPDATA%\openclaw
如果遇到问题，可以使用独立脚本手动处理：
| 脚本 | 用途 | 使用场景 |
|---|---|---|
1-check.sh |
环境自检 | 只想看看当前环境状态 |
2-install-node.sh |
安装 Node.js | 手动安装/升级 Node.js |
3-install-git.sh |
配置 Git 镜像 | 手动配置/更换镜像源 |
4-install-openclaw.sh |
安装小龙虾 | 手动安装/重装 OpenClaw |
5-diagnose.sh |
故障诊断 | 小龙虾运行异常时 |
| 脚本 | 用途 | 使用场景 |
|---|---|---|
1-check.ps1 |
环境自检 | 只想看看当前环境状态 |
2-install-node.ps1 |
安装 Node.js | 手动安装/升级 Node.js |
3-install-git.ps1 |
配置 Git 镜像 | 手动配置/更换镜像源 |
4-install-openclaw.ps1 |
安装小龙虾 | 手动安装/重装 OpenClaw |
5-diagnose.ps1 |
故障诊断 | 小龙虾运行异常时 |
| 项目 | 最低要求 | 推荐配置 |
|---|---|---|
| 内存 | 4GB | 8GB+ |
| 硬盘空间 | 2GB 可用 | 5GB+ |
| Node.js | 22.16+ | 24.x |
| 操作系统 | macOS 10.15+ / Windows 10 | macOS 14+ / Windows 11 |
⚠️ macOS 10.14 及更早版本无法安装 OpenClaw：OpenClaw 要求 Node.js ≥ 22.16.0，而 macOS 10.14 最高仅支持 Node.js 22.15.x。请升级到至少 macOS 10.15 (Catalina)。
安装程序和一键脚本都会优先尝试官方安装包，并在安装后自动检测 Node.js 是否可运行。
Mac: 大多数情况下不需要提前手动安装 Xcode 命令行工具；如果后续安装日志明确提示依赖编译失败，再执行：
xcode-select --installWindows: 如果失败，优先检查是否被系统权限、杀毒软件或公司电脑策略拦截；仍不行再手动下载安装包：https://nodejs.org
如果你没有 VPN，安装程序/脚本会引导你配置国内镜像源。可用镜像：
- gitclone.com
- mirror.ghproxy.com
- ghproxy.net
安装程序/脚本会引导你选择 npm 源，推荐：
Windows 系统下 restart 命令可能失效，诊断脚本会使用 openclaw gateway 命令启动网关。
安装完成后通常不需要额外处理；如果你是手动安装过 Node.js 或系统环境变量刷新较慢，可能需要：
- Mac: 关闭终端，重新打开
- Windows: 关闭 PowerShell，重新打开（以管理员身份）
安装器会尝试在新终端窗口中启动：
openclaw onboard --install-daemon如果没有弹出新终端窗口，请尝试：
- 检查系统是否拦截了 Terminal / PowerShell 启动
- 手动在终端里运行
openclaw onboard --install-daemon
这通常不是“没安装成功”，而是还没有完成首次配置。
如果你看到类似下面的提示：
Missing config. Run openclaw setup or set gateway.mode=local请直接执行：
openclaw onboard --install-daemon完成配置向导后，再重新启动 OpenClaw 即可。
- 关闭安装程序后重新打开再试
- 直接在终端或 PowerShell 中手动运行上面的命令
如果安装程序出现失败页，请点击：
复制诊断信息
然后把复制出来的内容连同问题现象一起发给开发者，这会比单独截图更容易定位问题。
请先以管理员身份打开 PowerShell，运行：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser输入 Y 确认后，再重新运行一键安装命令。
安装完成后，先在终端或 PowerShell 里输入：
openclaw dashboard这会自动打开小龙虾的 Web 控制台。
如果需要启动网关，再运行：
openclaw gateway如果还没有完成配置，也可以运行：
openclaw onboard --install-daemon- OpenClaw 官方文档：https://docs.openclaw.ai
- 社区支持：https://discord.com/invite/clawd
- 问题反馈：https://github.com/cyberpinkman/openclaw-easy-deploy/issues
- 开发者联系：cyberpink.xx@gmail.com
- 开源仓库：https://github.com/cyberpinkman/openclaw-easy-deploy
MIT License