OpenClaw安装教程 - 全平台安装指南

本教程详细讲解 OpenClaw(原Clawdbot)在 Windows、Mac、Linux 三大平台的安装方法,包含系统要求、一键安装命令和常见问题排查,帮你在5分钟内完成 OpenClaw 的安装与初始化。


系统要求

  • macOS 12 (Monterey) 及以上
  • 支持 Intel 和 Apple Silicon (M系列) 芯片
  • 内存 4GB 以上,磁盘空间 500MB 以上

方式一:一键安装脚本(推荐)

curl -fsSL https://get.openclaw.ai | bash

方式二:Homebrew 安装

brew install openclaw

方式三:npm 安装

npm install -g openclaw

验证安装

openclaw --version

正常会输出版本号,如 openclaw/1.x.x

系统要求

  • Windows 10 (1903+) 或 Windows 11
  • 需要 Node.js 18+ 运行环境
  • 内存 4GB 以上,磁盘空间 500MB 以上

方式一:npm 安装(推荐)

先从 nodejs.org 下载安装 Node.js LTS 版本,然后在 PowerShell 中运行:

npm install -g openclaw

方式二:WSL2 一键安装

如果已安装 WSL2,在 WSL 终端中运行一键脚本:

curl -fsSL https://get.openclaw.ai | bash

验证安装

openclaw --version

正常会输出版本号,如 openclaw/1.x.x

提示:如遇到 npm 权限问题,可以以管理员身份运行 PowerShell,或参考 npm 官方文档配置全局安装路径。

系统要求

  • Ubuntu 20.04+ / Debian 11+ / CentOS 8+ / Fedora 36+
  • 其他主流 Linux 发行版均支持
  • 内存 4GB 以上,磁盘空间 500MB 以上

方式一:一键安装脚本(推荐)

curl -fsSL https://get.openclaw.ai | bash

方式二:npm 安装

确保已安装 Node.js 18+,然后运行:

sudo npm install -g openclaw

验证安装

openclaw --version

正常会输出版本号,如 openclaw/1.x.x

国内安装加速

如果下载速度慢,可以使用国内 npm 镜像:

npm config set registry https://registry.npmmirror.com

设置后重新运行安装命令即可

安装完成后,请继续阅读 配置教程 设置 AI 模型和消息平台

安装后初始化

完成安装后的首次配置步骤

1
初始化配置
运行 openclaw init 启动交互式配置向导,按提示选择 AI 模型提供商并填入 API Key
2
连接消息平台
运行 openclaw config 编辑配置文件,在 transports 部分添加你想使用的消息平台凭据
3
启动服务
运行 openclaw start 启动 AI 助手服务,在消息平台中发送第一条消息验证是否正常运行

各平台安装注意事项

不同操作系统的安装细节提醒

🍎
macOS 注意事项
首次运行可能弹出安全提示,在"系统偏好设置 > 安全性与隐私"中允许运行。如使用 Homebrew 安装,确保 brew 已更新到最新版本
🏿
Windows 注意事项
推荐使用 PowerShell 而非 CMD。如遇到执行策略限制,运行 Set-ExecutionPolicy RemoteSigned 修改策略。杀毒软件可能误报,需添加信任
🐧
Linux 注意事项
一键脚本会自动安装所需依赖(Node.js、Git等)。如使用 npm 方式,需先确认 Node.js 版本 >= 18。服务器环境建议配合 systemd 管理进程
🐳
Docker 安装
OpenClaw 也提供 Docker 镜像,适合不想污染系统环境的用户。运行 docker pull openclaw/openclaw 拉取镜像,详见部署教程

常见问题

OpenClaw 安装相关疑问

OpenClaw安装需要什么系统要求?
OpenClaw对系统要求不高:操作系统支持Windows 10及以上、macOS 12及以上、主流Linux发行版(Ubuntu 20.04+、Debian 11+、CentOS 8+等);需要Node.js 18+运行环境;内存建议4GB以上;磁盘空间约需500MB。如果计划接入本地AI模型(如通过Ollama),则建议内存16GB以上并配备GPU。
Windows怎么安装OpenClaw?
Windows安装OpenClaw有两种方式:方式一(推荐):先安装Node.js(从nodejs.org下载LTS版本),然后在PowerShell中运行 npm install -g openclaw 全局安装。方式二:使用WSL2(Windows子系统Linux),在WSL终端中运行一键安装脚本 curl -fsSL https://get.openclaw.ai | bash。两种方式都很简单,推荐有WSL经验的用户使用方式二。
Mac怎么安装OpenClaw?
Mac安装OpenClaw最简单,打开终端运行一键安装脚本:curl -fsSL https://get.openclaw.ai | bash,脚本会自动检测系统环境并完成安装。也可以通过Homebrew安装:brew install openclaw。安装完成后运行 openclaw --version 确认安装成功。支持Intel和Apple Silicon(M系列芯片)Mac。
OpenClaw安装失败怎么办?常见问题有哪些?
常见安装问题及解决方案:1)npm权限错误:在命令前加sudo或配置npm全局路径;2)网络超时:使用国内npm镜像 npm config set registry https://registry.npmmirror.com;3)Node.js版本过低:升级到18+版本;4)Windows安全软件拦截:将openclaw加入白名单。如仍有问题,可在GitHub Issues中搜索或提交问题。
OpenClaw可以一键安装吗?支持离线安装吗?
OpenClaw支持一键安装,Mac和Linux用户只需一条命令 curl -fsSL https://get.openclaw.ai | bash 即可完成。Windows用户也只需 npm install -g openclaw 一条命令。目前暂不支持完全离线安装,因为安装过程需要从npm仓库下载依赖包,但可以通过配置国内镜像源来加速下载。企业内网环境可搭建私有npm仓库实现局域网安装。

相关工具

OpenClaw - 更多实用工具