我花了一下午把“小龙虾“OpenClaw 部署到了三个系统上,这是我整理的笔记
OpenClaw是一款火爆的开源AI执行引擎,支持在本地电脑上完成文件整理、写周报等任务,数据不出设备,确保隐私安全。文章详细介绍了在Windows、Mac、Ubuntu三大系统上的部署方法,推荐使用Node.js 22+版本和大模型API Key(如阿里云百炼)。Windows用户需注意权限问题,Mac体验最佳,Ubuntu建议配置systemd服务保持后台运行。此外还提供了Docker部署方案
最近 OpenClaw 太火了,GitHub 星标已经冲到 30 多万,技术圈几乎人人都在聊。简单说,它是一个开源的 AI 执行引擎,和 ChatGPT 那种"你问我答"不同,OpenClaw 能直接在你电脑上干活——整理文件、写周报、发邮件、抓网页,你用自然语言告诉它做什么就行。
关键是它跑在本地,数据不出你的设备,这一点对很多人来说很重要。
我这两天分别在 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 | bash
openclaw onboard --install-daemon
启动:
openclaw gateway --port 18789
如果是云服务器,记得去安全组放开 18789 端口,不然外面访问不了。
让它后台常驻这件事很重要,不然你 SSH 断开它就停了。最靠谱的方式是写个 systemd 服务:
sudo tee /etc/systemd/system/openclaw.service > /dev/null <<EOF
[Unit]
Description=OpenClaw
After=network.target
[Service]
Type=simple
User=$USER
ExecStart=$(which openclaw) gateway --port 18789
Restart=always
RestartSec=10
[Install]
WantedBy=multi-user.target
EOF
sudo systemctl daemon-reload
sudo systemctl enable openclaw
sudo 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:latest
container_name: openclaw
restart: always
ports:
- "18789:18789"
volumes:
- ./openclaw-data:/root/.openclaw
environment:
- TZ=Asia/Shanghai
然后 docker compose up -d,完事。
最省事的方式:直接用云服务
如果你压根不想碰命令行,或者需要 24 小时在线不关机,直接买个云服务器是最省事的。
火山云方案
- 去火山引擎买一台最低配的 ECS(2 核 2G 就够个人用了,一个月几十块)
- 系统选 Ubuntu 22.04
- SSH 连上去,跑上面 Ubuntu 的那几行命令
- 顺便开个火山方舟的大模型服务,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 对全网开放
以上就是全部内容。有问题可以评论区聊,我看到会回。
更多推荐

所有评论(0)