跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像AI 生图工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / BashNode.jsWeChatAI

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

OpenClaw v2026.3.8 支持 Windows、macOS、Linux 及移动端部署。通过一键脚本或 Docker 可快速搭建环境，核心依赖 Node.js。配置时需关闭公网访问以符合安全规范，并可通过 Ollama 对接本地模型实现离线运行，避免 API 费用与数据泄露风险。

1qazxsw2发布于 2026/4/9更新于 2026/7/2340 浏览

OpenClaw 部署与配置指南

OpenClaw（龙虾 AI）是一款开源可私有化部署的 AI 智能体。与普通聊天机器人不同，它能执行跨应用自动化任务，比如整理微信消息、定时提醒或浏览器操作。相比旧版教程，本文基于 2026 年 3 月官方稳定版（v2026.3.8），结合 Windows、macOS、Linux 及移动端环境，梳理从零部署到对接 Ollama 本地模型的全流程，重点规避常见权限报错与安全漏洞。

一、核心认知与环境准备

1. 产品定位

OpenClaw 是本地 AI 执行网关，核心优势在于数据本地存储与全平台兼容。它支持对接在线大模型（如 GPT、通义千问）和本地模型（Ollama），适合个人办公自动化及企业私有化场景。

注意： iOS 系统暂无官方原生安装包，任何宣称'苹果直装'的版本多为违规修改版。建议苹果用户通过云手机配合官方客户端使用。官方版本完全免费，付费解锁均为骗局。

2. 最低配置要求
部署平台系统版本要求内存要求存储空间核心依赖
WindowsWin 10+ (64 位)≥4GB (推荐 8GB)≥2GBNode.js ≥18
macOSmacOS 12+≥4GB (推荐 8GB)≥2GBNode.js / Docker
LinuxUbuntu 20.04+/CentOS 8+≥2GB (推荐 4GB)≥1GBNode.js / Docker
安卓/鸿蒙Android 10+/鸿蒙 4.0+≥4GB (推荐 6GB)≥2GBAPK 直装 / Termux
3. 通用准备
  • 网络：建议使用稳定 WiFi，避免下载过程中因移动数据波动导致包损坏。
  • 安全：安装前备份重要数据，临时关闭杀毒软件拦截（安装后记得开启）。
  • 权限：Windows 需管理员权限；安卓需允许'未知来源应用'。
  • 端口：牢记默认端口 18789，后续防火墙设置需放行。

二、四大平台部署方案

优先推荐官方一键脚本，零配置且速度快。进阶用户可选择 Docker 或手动部署以获取更高控制权。

1. Windows 平台（新手首选）

Windows 下直接运行脚本可自动规避路径中文和权限冲突问题。

  1. 打开管理员 PowerShell：按 Win + R 输入 powershell，右键选择'以管理员身份运行'。
  2. 解锁脚本执行策略： 
    Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
    提示时输入 确认。
Y
  • 一键安装最新版（自动下载 v2026.3.8 并配置依赖）： 
    iwr -useb https://openclaw.ai/install.ps1 | iex
  • 初始化向导：启动后按提示绑定模型（可选）并设置管理员密码。 
    openclaw onboard
  • 启动服务： 
    openclaw gateway start
  • 验证：浏览器访问 http://localhost:18789，能进入控制面板即成功。

    • 排错提示：若无法访问面板，检查防火墙是否放行 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 智能体，它无需复杂配置，无论是个人自动化还是企业私有化部署，都能提供可靠支持。

    目录

    1. OpenClaw 部署与配置指南
    2. 一、核心认知与环境准备
    3. 1. 产品定位
    4. 2. 最低配置要求
    5. 3. 通用准备
    6. 二、四大平台部署方案
    7. 1. Windows 平台（新手首选）
    8. 2. macOS / Linux 平台
    9. 方式 A：一键脚本（推荐）
    10. 方式 B：Docker 部署（服务器/隔离环境）
    11. 3. 手机端部署（安卓/鸿蒙）
    12. 方式 A：APK 直装（零基础）
    13. 方式 B：Termux 进阶（高配手机）
    14. 三、进阶配置：对接 Ollama 本地模型
    15. 轻量版
    16. 高性能版（视硬件而定）
    17. 设置 Ollama 地址
    18. 设置默认模型
    19. 四、高频报错避坑
    20. 五、基础使用速览
    21. 六、总结
    • 免费图片AI生成工具免费生成了解详情
    • Magick API 一键接入全球大模型注册送1000万token查看
    • 免费图片视频在线生成30秒，将你的创意变成现实开始设计
    • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
    • 100+免费在线小游戏爽一把
    极客日志微信公众号二维码

    微信扫一扫，关注极客日志

    微信公众号「极客日志V2」，在微信中扫描左侧二维码关注。展示文案：极客日志V2 zeeklog

    更多推荐文章

    查看全部
    • 轮腿机器人调试与代码实现补充
    • PyCharm 安装通义灵码插件实现 AI 辅助编码
    • 2026 年主流 AI 写作工具深度测评：小说与剧本创作指南
    • 16 篇大模型领域必读论文
    • JMeter 接口并发测试入门教程
    • AI 辅助测试用例生成实战指南
    • 开源低代码平台 Microi 吾码：架构、部署与实战指南
    • JavaScript 反混淆工具使用指南与实战
    • 个人如何利用 Python 爬虫技术实现变现
    • 基于 AI 智能体快速完成 C 语言与前端实训项目实战
    • Python 环境安装与 Pip 配置完整指南
    • 基于 Rust 与 DeepSeek 构建高性能 Text-to-SQL 数据库代理服务
    • Tailscale 零信任网络搭建：Linux/Windows/macOS 多平台配置教程
    • MySQL 数据类型深度解析：选对类型提升性能
    • AI Agent 框架：工作流与 Agent 运行时模块设计
    • Python 全栈开发指南：基础、后端、爬虫、数据分析与机器学习实战
    • AI 大模型系统学习路径与核心应用场景
    • ESP32-S3 微型无人机系统架构与飞控实现
    • Python+Agent 入门实战：零基础搭建可复用 AI 智能体
    • DFS/BFS 图论基础与海岛问题实战 (C/C++)

    相关免费在线工具

    • RSA密钥对生成器

      生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online

    • Mermaid 预览与可视化编辑

      基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online

    • 随机西班牙地址生成器

      随机生成西班牙地址（支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选），支持数量快捷选择、显示全部与下载。 在线工具，随机西班牙地址生成器在线工具，online

    • Base64 字符串编码/解码

      将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online

    • Base64 文件转换器

      将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online

    • Markdown转HTML

      将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online