本教程详细讲解 OpenClaw(原Clawdbot)在 Windows、Mac、Linux 三大平台的安装方法,包含系统要求、一键安装命令和常见问题排查,帮你在5分钟内完成 OpenClaw 的安装与初始化。
curl -fsSL https://get.openclaw.ai | bash
brew install openclaw
npm install -g openclaw
openclaw --version
正常会输出版本号,如 openclaw/1.x.x
如果已安装 WSL2,在 WSL 终端中运行一键脚本:
curl -fsSL https://get.openclaw.ai | bash
openclaw --version
正常会输出版本号,如 openclaw/1.x.x
curl -fsSL https://get.openclaw.ai | bash
确保已安装 Node.js 18+,然后运行:
sudo npm install -g openclaw
openclaw --version
正常会输出版本号,如 openclaw/1.x.x
如果下载速度慢,可以使用国内 npm 镜像:
npm config set registry https://registry.npmmirror.com
设置后重新运行安装命令即可
安装完成后,请继续阅读 配置教程 设置 AI 模型和消息平台
完成安装后的首次配置步骤
openclaw init 启动交互式配置向导,按提示选择 AI 模型提供商并填入 API Keyopenclaw config 编辑配置文件,在 transports 部分添加你想使用的消息平台凭据openclaw start 启动 AI 助手服务,在消息平台中发送第一条消息验证是否正常运行不同操作系统的安装细节提醒
Set-ExecutionPolicy RemoteSigned 修改策略。杀毒软件可能误报,需添加信任docker pull openclaw/openclaw 拉取镜像,详见部署教程OpenClaw 安装相关疑问
npm install -g openclaw 全局安装。方式二:使用WSL2(Windows子系统Linux),在WSL终端中运行一键安装脚本 curl -fsSL https://get.openclaw.ai | bash。两种方式都很简单,推荐有WSL经验的用户使用方式二。
curl -fsSL https://get.openclaw.ai | bash,脚本会自动检测系统环境并完成安装。也可以通过Homebrew安装:brew install openclaw。安装完成后运行 openclaw --version 确认安装成功。支持Intel和Apple Silicon(M系列芯片)Mac。
npm config set registry https://registry.npmmirror.com;3)Node.js版本过低:升级到18+版本;4)Windows安全软件拦截:将openclaw加入白名单。如仍有问题,可在GitHub Issues中搜索或提交问题。
curl -fsSL https://get.openclaw.ai | bash 即可完成。Windows用户也只需 npm install -g openclaw 一条命令。目前暂不支持完全离线安装,因为安装过程需要从npm仓库下载依赖包,但可以通过配置国内镜像源来加速下载。企业内网环境可搭建私有npm仓库实现局域网安装。
OpenClaw - 更多实用工具