导语 OpenClaw支持多种系统安装,安装前置要求、各平台安装方法及初始化配置,详见正文。
OpenClaw怎么安装
一、安装前置要求
硬件要求
最低配置CPU:2核内存:4GB存储:10GB网络:1Mbps
推荐配置CPU:4核内存:8GB存储:50GB SSD网络:10Mbps
高性能配置CPU:8核+内存:16GB+存储:100GB+ SSD网络:100Mbps+
软件依赖
Node.js:版本22或更高(推荐v22+或v24+)
npm:Node.js包管理器
Git:版本控制工具(可选)
Docker:容器化部署(可选)
前置检查
在安装前,检查系统是否满足要求
node --version:应显示v22.x.x或更高
npm --version:应显示10.x.x或更高
git --version:检查Git版本
二、macOS系统安装
第一步:安装Node.js
使用Homebrew安装最新LTS版
brew install node@22
第二步:一键安装OpenClaw
在终端中运行统一安装脚本
curl -fssl https://openclaw.ai/install.sh | bash
第三步:初始化与启动
运行配置向导 openclaw setup
或运行 openclaw onboard --install-daemon
配置向导会引导用户完成以下设置身份认证:使用GitHub账号登录,获取OAuth凭证AI模型配置:选择模型提供商并设置API Key通讯平台选择:选择要接入的聊天平台守护进程安装:将Gateway注册为系统服务,实现开机自启
启动gateway服务 openclaw gateway start
第四步:访问Web界面
打开浏览器访问http://127.0.0.1:18789,看到界面即表示成功。如果无法打开,可以使用带token访问
获取token openclaw config get gateway.auth.token
使用token访问 http://127.0.0.1:18789?token=你的token
三、Windows系统安装
第一步:环境准备
打开管理员PowerShell:按Win+X,选择"Windows PowerShell (管理员)"或"终端 (管理员)"
解锁执行策略(关键步骤,避免报错) Set-ExecutionPolicy Bypass -Scope Process -Force
第二步:安装Node.js
推荐使用nvm-windows来安装和管理Node.js版本。可以从GitHub下载nvm-setup.exe安装
安装Node.js v22 nvm install 22nvm use 22.22.0
可能需要多次尝试国内镜像脚本(如果官方脚本下载慢)iwr -useb https://clawd.org.cn/install.ps1 | iex
使用国内镜像需要输入openclaw-cn安装
第三步:初始化与启动
使用安装命令后,运行初始化向导 openclaw onboard --flow quickstart
启动gateway服务 openclaw gateway start
第四步:访问Web界面
打开浏览器,访问http://127.0.0.1:18789,看到界面即表示成功。如果无法打开,可以使用带token访问
获取token openclaw config get gateway.auth.token
使用token访问 http://127.0.0.1:18789?token=你的token
四、Linux系统安装
第一步:安装Node.js
使用NodeSource官方源安装v24.x版本
curl -fssl https://deb.nodesource.com/setup_24.x | sudo -E bash -sudo apt install -y nodejs
或使用包管理器安装
sudo apt updatesudo apt install -y nodejs npm
第二步:一键安装OpenClaw
在终端中运行统一安装脚本
curl -fssl https://openclaw.ai/install.sh | bash
第三步:初始化与启动
运行 openclaw setup 或 openclaw onboard --install-daemon 启动配置向导,完成API Key等设置
启动gateway服务 openclaw gateway start
第四步:访问Web界面
打开浏览器访问 http://127.0.0.1:18789,看到界面即表示成功。如果无法打开,可以使用带token访问
获取token openclaw config get gateway.auth.token
使用token访问 http://127.0.0.1:18789?token=你的token
温馨提示:微信搜索公众号【苏州本地宝】,关注后在对话框回复【龙虾】获取苏州“养龙虾”拟支持措施/补贴政策,OpenClaw公开课报名入口,“龙虾”免费安装活动报名入口,阿里/腾讯/百度版“小龙虾”下载入口、使用指南等内容