一、部署前必看：核心认知 + 环境准备（避坑第一步）
1.1 龙虾 AI 核心定位（必懂）
OpenClaw 是开源免费的本地 AI 执行网关，核心优势是'数据本地存储、全平台兼容、自动化执行'，无需上传数据到第三方平台，隐私性拉满。它能对接在线大模型（GPT、通义千问）和本地模型（Ollama），支持文件管理、多渠道消息接入、自定义脚本运行，适合个人自动化办公和企业私有化部署。
重点提醒：截至 2026 年 3 月 10 日，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（龙虾 AI 默认端口），后续需放行该端口。
二、四大平台部署教程（新手优先选一键脚本）
本次部署优先推荐'官方一键脚本'，零配置、速度快，适配 90% 新手；进阶用户可选择 Docker 或手动部署，实现版本可控和自定义配置；手机端提供 APK 直装和 Termux 两种方式，满足不同需求。
2.1 Windows 平台部署（新手首选）
Windows 用户直接用官方一键脚本，规避路径中文、权限冲突问题，步骤如下：
- 打开管理员 PowerShell：Win+R 输入'powershell'，右键选择'以管理员身份运行'；
- 解锁脚本权限（输入命令后按回车，提示时输入 Y 确认）：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser - 一键安装最新版（自动下载 v2026.3.8，配置依赖）：
iwr -useb https://openclaw.ai/install.ps1 | iex - 初始化配置：输入命令启动初始化向导，按提示绑定模型（可选）、设置管理员密码：
openclaw onboard - 启动服务：
openclaw gateway start - 验证部署：浏览器打开
http://localhost:18789，能进入龙虾 AI 控制面板，即部署成功。
补充：若出现路径报错，需确保安装路径无中文、空格和特殊字符；若无法访问面板，检查 Windows 防火墙是否放行 18789 端口。
