OpenClaw 全平台部署指南
OpenClaw 是一款开源可私有化部署的 AI 智能体，区别于普通聊天机器人，它具备跨应用自动化执行能力，例如整理消息、定时提醒及浏览器自动化等。本文基于 v2026.3.8 稳定版，结合 Windows、macOS、Linux 及移动端（安卓/鸿蒙）环境，详解从一键脚本部署到 Ollama 本地模型对接的全流程，重点说明安全配置与常见故障排查。
一、核心认知与环境准备
1.1 产品定位
OpenClaw 作为本地 AI 执行网关，核心优势在于数据本地存储与全平台兼容。它支持对接在线大模型（如 GPT、通义千问）和本地模型（Ollama），提供文件管理、多渠道消息接入及自定义脚本运行功能。适合追求隐私安全的个人办公或企业私有化场景。
注意： iOS 系统暂无官方原生安装包，建议通过云手机配合客户端使用；官方版本免费，警惕付费解锁骗局。
1.2 最低配置要求
| 部署平台 | 系统版本要求 | 内存要求 | 存储空间 | 核心依赖 |
|---|---|---|---|---|
| Windows | Windows 10+ (64 位) | ≥4GB (推荐 8GB) | ≥2GB | Node.js ≥18 |
| 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，右键选择'以管理员身份运行'。 - 设置脚本执行策略：
按提示输入 Y 确认。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验证。
方式 2：Docker 部署
适合服务器或需要隔离环境的场景。
- 创建配置目录：
mkdir -p ~/openclaw && cd ~/openclaw - 拉取镜像并运行（映射端口并挂载数据）：
docker run -d --name openclaw-core -p 18789:18789 -v $(pwd):/data openclaw/openclaw - 查看容器状态：
docker ps，服务器用户需将 localhost 替换为公网 IP。
2.3 手机端部署
方式 1：APK 直装
- 从官方开源仓库下载对应版本的安装包，避免第三方商店盗版。
- 安装时授权'未知来源'，完成后立即关闭该权限。
- 初始化时选择'本地运行模式'，务必关闭'公网访问'，仅开启悬浮窗、后台运行等基础权限。
- 在电池设置中关闭针对本应用的优化，防止锁屏后进程被杀。
方式 2：Termux 进阶
适用于高配机型，可自定义插件。
- 安装 Termux 并更新环境：
apt update && apt upgrade -y - 执行移动端安装脚本：
curl -fsSL https://openclaw.ai/mobile-install.sh | bash - 启动服务：
openclaw start，手机浏览器访问http://127.0.0.1:18789。
三、Ollama 本地模型对接
无需联网即可实现离线运行，保障数据隐私。
- 安装并启动 Ollama（默认端口 11434）。
- 拉取轻量级模型（适配低配设备）：
ollama pull qwen2:7b # 或高性能版 ollama pull llama3:8b - 配置 OpenClaw 对接 Ollama：
# 绑定服务地址 openclaw config set models.providers.ollama.baseUrl http://localhost:11434 # 设置默认模型 openclaw config set agents.defaults.model.primary ollama/qwen2:7b - 重启服务生效：
openclaw gateway restart
四、常见问题排查
- 无法访问面板：检查防火墙/安全组是否放行 18789 端口；Windows 需确保以管理员权限运行。
- Node.js 版本过低：卸载旧版，安装 v18 及以上；国内用户可切换镜像源。
- 手机端闪退：检查剩余内存，关闭多余后台应用；重新安装并确保开启后台保活。
- Ollama 连接失败：确认 Ollama 服务已启动且端口正确；模型名称需严格匹配（区分大小写）。
- 广告或捆绑软件：卸载当前版本，仅从官方渠道获取安装包。
五、基础使用
- 登录面板后，在指令框输入需求，如'整理今天的微信工作消息'或'明天 9 点提醒开会'。
- 插件安装仅限官方认证市场，避免第三方插件风险。
- 定期通过
openclaw update检查更新。
六、总结
部署的核心在于选对方式与安全配置。新手优先使用一键脚本，Windows 用户注意路径规范，手机端务必关闭公网访问。进阶用户可通过 Docker 或 Ollama 实现更灵活的本地化控制。遵循上述步骤，即可安全、稳定地启用这款自动化 AI 助手。
