OpenClaw v2026.3.8 全平台部署指南：环境准备与本地模型对接

*补充：若遇路径报错，请确保安装路径不含中文、空格或特殊字符；若无法访问面板，请检查防火墙是否放行 18789 端口。

2.2 macOS/Linux 平台

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

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。

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

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

1. 安装并启动 Docker（已安装可跳过）。
2. 创建配置目录：

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

3. 拉取镜像并运行（映射 18789 端口，挂载配置目录）：

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

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

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

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

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

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

方式 2：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. 对接配置：在终端绑定 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 需用管理员权限启动；服务器需确认公网 IP 可达。
• Node.js 版本过低：卸载旧版，安装 v18+，国内用户可切换镜像源。
• 手机端闪退：检查内存（≥4GB），关闭多余后台；安卓用户尝试重装 APK 并确保开启后台保活。
• Ollama 连接失败：确认 Ollama 已启动（端口 11434），模型名称区分大小写且输入正确。
• 捆绑广告：卸载当前版本，仅从官方开源仓库或 F-Droid 下载正版。

五、基础使用速览

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

六、总结

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