OpenClaw v2026.3.8 全平台部署及 Ollama 本地模型对接实战

排错提示：若无法访问面板，检查防火墙是否放行 18789 端口；若路径报错，确保安装目录不含中文或特殊字符。

2. macOS / Linux 平台

方式 A：一键脚本（推荐）

1. 打开终端（macOS 在 Launchpad 搜索'终端'，Linux 快捷键 Ctrl+Alt+T）。
2. 执行安装命令：

   curl -fsSL https://openclaw.ai/install.sh | bash
   

3. 初始化并启动：

   openclaw onboard && openclaw gateway start
   

4. 验证：访问 http://localhost:18789。

方式 B：Docker 部署（服务器/隔离环境）

适合需要环境隔离的场景，步骤如下：

1. 确保 Docker 已安装并启动。
2. 创建配置目录：

   mkdir -p ~/openclaw && cd ~/openclaw
   

3. 拉取镜像并运行（映射端口，挂载数据）：

   docker run -d --name openclaw-core -p 18789:18789 -v $(pwd):/data openclaw/openclaw
   

4. 验证：执行 docker ps 查看状态，浏览器访问 IP:18789（服务器需替换为公网 IP）。

3. 手机端部署（安卓/鸿蒙）

方式 A：APK 直装（零基础）

官方推荐方式，修复了部分高权限漏洞。

1. 下载正版 APK：通过手机浏览器访问 GitHub 仓库 Releases 页面，下载对应版本（避开第三方商店盗版）。
2. 授权安装：点击安装包，选择'仅本次允许'未知来源，完成后立即关闭该权限。
3. 安全配置：打开应用，选择'本地运行模式'，务必关闭'公网访问'（防止远程控制风险）。
4. 权限管理：仅开启悬浮窗、后台运行、通知权限，敏感权限（通讯录等）一律关闭。
5. 保活设置：在手机电池管理中关闭 OpenClaw 的'电池优化'，防止锁屏被杀。

方式 B：Termux 进阶（高配手机）

适合 6GB 内存以上设备，功能更灵活。

1. 从 F-Droid 官网下载 Termux（应用商店版过旧）。
2. 更新环境：

   apt update && apt upgrade -y
   

3. 一键部署：

   curl -fsSL https://openclaw.ai/mobile-install.sh | bash
   

4. 启动访问：输入 openclaw start，浏览器打开 http://127.0.0.1:18789。

三、进阶配置：对接 Ollama 本地模型

不想依赖在线 API？对接 Ollama 可实现离线运行，全程数据本地化。

1. 安装 Ollama：下载对应平台版本并启动（默认端口 11434）。
2. 拉取模型：推荐轻量版适配低配设备。

   # 轻量版
   ollama pull qwen2:7b
   # 高性能版（视硬件而定）
   ollama pull llama3:8b
   

3. 绑定服务：在终端执行以下命令，将 OpenClaw 指向本地 Ollama。

   # 设置 Ollama 地址
   openclaw config set models.providers.ollama.baseUrl http://localhost:11434
   # 设置默认模型
   openclaw config set agents.defaults.model.primary ollama/qwen2:7b
   

4. 重启生效：

   openclaw gateway restart
   

验证：重启后发送指令无需联网即可响应，说明对接成功。

四、高频报错避坑

部署时请严格遵守安全规范，关闭公网访问，最小化权限。

• 无法访问面板：检查防火墙/安全组是否放行 18789 端口；Windows 需管理员权限启动。
• Node.js 版本过低：卸载旧版，安装 v18+。国内用户可切换镜像源。
• 手机端闪退：检查内存是否充足（≥4GB），关闭多余后台；重新安装 APK 并确保开启后台保活。
• Ollama 连接失败：确认 Ollama 服务已启动（端口 11434），模型名称区分大小写。
• 广告捆绑：卸载当前版本，仅从官方仓库或 F-Droid 下载正版。

五、基础使用速览

1. 登录：浏览器访问 http://localhost:18789，输入管理员密码。
2. 指令：输入需求如'整理今天的微信工作消息'，AI 将自动执行。
3. 插件：仅在官方市场安装认证插件，拒绝第三方不明来源。
4. 更新：终端输入 openclaw update 保持最新版本。

六、总结

OpenClaw 的核心价值在于'选对方式、规避风险'。新手用一键脚本快速上手，Windows 用户注意路径规范，手机端务必关闭公网访问。进阶用户可通过 Docker 或 Ollama 实现深度定制。作为开源免费的 AI 智能体，它无需复杂配置，无论是个人自动化还是企业私有化部署，都能提供可靠支持。