OpenClaw 简介
OpenClaw 是开源可私有化部署的 AI 智能体，区别于普通聊天 AI，能完成跨应用自动化任务——整理微信消息、定时提醒、浏览器自动化等。它支持对接在线大模型（GPT、通义千问）和本地模型（Ollama），适合个人自动化办公和企业私有化部署。
重点说明：截至 2026 年 3 月 10 日，iOS 系统无官方原生安装包，建议苹果用户通过云手机 + 官方客户端使用；官方版本完全免费。
一、环境准备
1.1 核心认知
- 数据本地存储，无需上传至第三方平台。
- 全平台兼容，支持 Windows、macOS、Linux、Android/鸿蒙。
- 默认端口为 18789。
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 需管理员权限，安卓需允许'未知来源应用安装'。
二、四大平台部署教程
本次优先推荐官方一键脚本，零配置、速度快。
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。
方式 2：Docker 部署
适合服务器或需要环境隔离的场景。
- 安装 Docker 并启动服务。
- 创建配置文件夹：
mkdir -p ~/openclaw && cd ~/openclaw
- 拉取镜像并运行：
docker run -d --name openclaw-core -p 18789:18789 -v $(pwd):/data openclaw/openclaw
- 验证：执行
docker ps查看容器状态，浏览器访问 IP:18789。
2.3 手机端部署（安卓/鸿蒙）
方式 1：APK 直装
- 下载正版 APK：访问官方开源仓库 Releases 栏目，下载 Android v2026.3.8 安装包。
- 授权安装：点击安装包，选择仅本次允许未知来源应用。
- 初始化配置：打开龙虾 AI，按向导选择本地运行模式，关闭公网访问开关。
- 权限设置：仅开启悬浮窗、后台运行、通知三大基础权限。
- 后台保活：进入手机电池设置，找到 OpenClaw，关闭电池优化。
方式 2：Termux 进阶部署
适合高配手机，可自定义复杂任务。
- 安装正版 Termux：从 F-Droid 官网下载。
- 更新系统环境：
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
- 龙虾 AI 对接 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 及以上；国内用户可切换镜像源。
- 手机端闪退、卡顿：检查手机内存（需≥4GB），关闭多余后台应用；确保开启后台保活。
- Ollama 对接失败：确认 Ollama 已启动（默认端口 11434）；模型名称输入正确。
- 出现广告、捆绑软件：卸载当前版本，从官方开源仓库或 F-Droid 下载正版安装包。
五、部署后基础使用
- 进入面板：浏览器访问 http://localhost:18789（手机端为 127.0.0.1:18789），输入管理员密码登录。
- 基础操作：在指令框输入需求，如'整理今天的微信工作消息''明天 9 点提醒开会'。
- 插件安装：仅在官方插件市场安装认证插件。
- 版本更新：终端输入
openclaw update。
六、总结
OpenClaw v2026.3.8 的部署核心是选对方式、规避风险。新手用一键脚本，Windows 用户避开路径中文坑；手机端认准官方 APK，关闭公网访问；进阶用户可通过 Docker 部署或对接 Ollama 本地模型。作为开源免费的 AI 智能体，它适用于个人自动化办公及企业私有化部署场景。