OpenClaw 是一款开源可私有化部署的 AI 智能体,支持跨应用自动化任务,如整理消息、定时提醒及浏览器自动化。本文基于官方稳定版(v2026.3.8),详细拆解 Windows、macOS、Linux 及移动端的全平台部署流程,涵盖一键脚本安装、Docker 容器化部署及 Ollama 本地模型对接方案。
一、核心认知与环境准备
1.1 产品定位
OpenClaw 是开源免费的本地 AI 执行网关,核心优势包括数据本地存储、全平台兼容及自动化执行能力。它支持对接在线大模型(GPT、通义千问)和本地模型(Ollama),适合个人自动化办公和企业私有化部署。
注意:iOS 系统无官方原生安装包,建议通过云手机配合官方客户端使用;官方版本完全免费。
1.2 最低配置要求
| 部署平台 | 系统版本要求 | 内存要求 | 存储空间要求 | 核心依赖 |
|---|---|---|---|---|
| Windows | Windows 10 及以上(64 位) | ≥4GB(推荐 8GB) | ≥2GB 可用空间 | Node.js ≥18(推荐 22+) |
| macOS | macOS 12 及以上 | ≥4GB(推荐 8GB) | ≥2GB 可用空间 | Node.js ≥18 / Docker(可选) |
| Linux | Ubuntu 20.04+/CentOS 8+ | ≥2GB(推荐 4GB) | ≥1GB 可用空间 | Node.js ≥18 / Docker(可选) |
| 安卓/鸿蒙 | Android 10+/鸿蒙 4.0+ | ≥4GB(推荐 6GB) | ≥2GB 可用空间 | 无(APK 直装)/ Termux(进阶) |
1.3 准备工作
- 网络:连接稳定 WiFi。
- 安全:安装后可开启恶意软件拦截,备份重要数据。
- 权限:Windows 需管理员权限,安卓需允许'未知来源应用安装'。
- 端口:默认端口为 18789,后续需确保该端口可访问。
二、四大平台部署教程
本次优先推荐'官方一键脚本',零配置、速度快。
2.1 Windows 平台部署
- 打开管理员 PowerShell:Win+R 输入'powershell',右键选择'以管理员身份运行'。
- 解锁脚本权限:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser - 一键安装最新版:
iwr -useb https://openclaw.ai/install.ps1 | iex - 初始化配置:
openclaw onboard,按提示绑定模型或设置密码。 - 启动服务:
openclaw gateway start - 验证:浏览器打开
http://localhost:18789,进入控制面板即成功。
若出现路径报错,请确保安装路径无中文、空格和特殊字符;无法访问面板请检查防火墙是否放行 18789 端口。
2.2 macOS/Linux 平台部署
方式 1:一键脚本部署
- 打开终端。
- 执行一键安装命令:
curl -fsSL https://openclaw.ai/install.sh | bash - 初始化 + 启动服务:
openclaw onboard && openclaw gateway start - 验证:浏览器访问
http://localhost:18789。

