
关键是它跑在本地,数据不出你的设备,这一点对很多人来说很重要。
我这两天分别在 Windows、Mac 和 Ubuntu 上都部署了一遍,把过程记录下来,尽量少废话,直接上步骤。
部署之前你需要准备什么
不管哪个系统,都需要两样东西:
•Node.js 22 以上版本(官方推荐 Node 24,但 22 也能跑)•一个大模型的 API Key
API Key 这块,国内用户我建议直接用阿里云百炼,注册就送 90 天的免费额度,够你折腾很久了。火山方舟的豆包模型也不错,DeepSeek 注册也送一些。先别纠结选哪个,装好之后再换都很方便。

Windows 部署
说实话,Windows 上部署体验一般,但能跑。
第一步,安装 Node.js。去 nodejs.org 下载 22 或 24 的 LTS 安装包,一路下一步就行。装完打开 PowerShell 验证一下:
node -v能看到版本号就行。
第二步,用管理员权限打开 PowerShell,执行官方安装脚本:
irm https://openclaw.ai/install.ps1 | iex如果你不信任一键脚本(可以理解),也可以走 npm:
npm install -g openclaw@latest第三步,初始化配置:
openclaw onboard --install-daemon这一步会让你选大模型、填 API Key,按提示来就行。
第四步,启动:
openclaw gateway --port 18789然后浏览器打开 http://localhost:18789,看到界面就算成功了。
踩坑提醒:如果你用的是公司电脑,PowerShell 可能会拦截脚本执行,需要先跑一句 Set-ExecutionPolicy RemoteSigned 放开权限。另外 Windows 上如果遇到奇怪的问题,建议直接用 WSL2 装,体验好很多,方法和下面 Ubuntu 的一样。

macOS 部署
Mac 上是体验最好的,毕竟项目作者自己也用 Mac。
打开终端,一行命令搞定安装:
curl -fsSL https://openclaw.ai/install.sh | bash装完之后:
openclaw onboard --install-daemon跟着引导配置好大模型,然后启动:
openclaw gateway --port 18789如果你用 Homebrew 管理 Node.js,确保版本对:
brew install node@22整个过程顺利的话五分钟就能跑起来,Mac 上基本不会踩坑。
验证一下环境有没有问题可以跑:
openclaw doctor它会自动检测依赖和配置,哪里有问题会告诉你。
Ubuntu 部署
这是跑在服务器上最常见的方案。
装 Node.js:
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -sudo apt-get install -y nodejs
装 OpenClaw:
curl -fsSL https://openclaw.ai/install.sh | bashopenclaw onboard --install-daemon
启动:
openclaw gateway --port 18789如果是云服务器,记得去安全组放开 18789 端口,不然外面访问不了。
让它后台常驻这件事很重要,不然你 SSH 断开它就停了。最靠谱的方式是写个 systemd 服务:
sudo tee /etc/systemd/system/openclaw.service > /dev/null <<EOF[Unit]Description=OpenClawAfter=network.target[Service]Type=simpleUser=$USERExecStart=$(which openclaw) gateway --port 18789Restart=alwaysRestartSec=10[Install]WantedBy=multi-user.targetEOFsudo systemctl daemon-reloadsudo systemctl enable openclawsudo systemctl start openclaw
这样服务器重启它也会自动拉起来。
Docker 部署(全平台通用)
如果你不想在系统里装一堆东西,Docker 是最干净的方案。
docker run -d \--name openclaw \--restart always \-p 18789:18789 \-v ~/.openclaw:/root/.openclaw \ghcr.io/openclaw/openclaw:latest
一行命令,跑起来就不用管了。数据挂载在 ~/.openclaw 目录下,删掉容器数据还在。
国内拉镜像可能比较慢,可以试试阿里云的镜像源,或者挂个代理。
想用 Docker Compose 也行,创建一个 docker-compose.yml:
version: '3.8'services:openclaw:image: ghcr.io/openclaw/openclaw:latestcontainer_name: openclawrestart: alwaysports:- "18789:18789"volumes:- ./openclaw-data:/root/.openclawenvironment:- TZ=Asia/Shanghai
然后 docker compose up -d,完事。
最省事的方式:直接用云服务
如果你压根不想碰命令行,或者需要 24 小时在线不关机,直接买个云服务器是最省事的。
火山云方案
1.去火山引擎买一台最低配的 ECS(2 核 2G 就够个人用了,一个月几十块)2.系统选 Ubuntu 22.043.SSH 连上去,跑上面 Ubuntu 的那几行命令4.顺便开个火山方舟的大模型服务,API Key 直接填进去,调用延迟低
火山引擎的好处是大模型和服务器在同一个云上,速度会快一些。阿里云也差不多,百炼的免费额度更大。选哪家看你自己习惯。
有些平台已经出了 OpenClaw 的预装镜像,买完服务器直接就能用,连安装都省了,购买的时候留意一下。
装完之后干什么
光装好 OpenClaw 本体其实干不了太多事,它的能力靠 Skills(技能插件)扩展。官方的 Skills 市场已经有一万多个了,挑几个实用的装上:
openclaw skill install @openclaw/file-organizer我个人觉得比较实用的几个方向:文件自动整理、邮件处理、网页抓取、报告生成。具体装哪些看你自己的需求,市场里慢慢逛就行。
几个通用的注意事项
•更新版本:npm update -g openclaw@latest•检查环境:openclaw doctor•编辑配置:openclaw config edit•2026 年 3 月之后的版本加了权限分级,默认只开放基础权限,想让它操作文件或执行系统命令需要手动开启,这是安全考虑,别嫌麻烦•API Key 是敏感信息,如果部署在云服务器上,记得限制端口访问来源,别把 18789 对全网开放
以上就是全部内容。有问题可以评论区聊,我看到会回。
夜雨聆风