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

OpenClaw v2026.3.8 全平台部署教程

OpenClaw v2026.3.8 是一款开源本地 AI 执行网关,支持跨应用自动化任务。提供 Windows、macOS、Linux 及移动端的全平台部署方案,涵盖一键脚本安装、Docker 容器化部署及 Termux 进阶方式。重点介绍 Ollama 本地模型对接以实现离线运行,并包含端口配置、权限设置及常见报错解决方案。部署过程强调数据本地存储与安全配置,无需联网即可使用基础功能,适合个人办公与企业私有化场景。

协议工匠发布于 2026/4/6更新于 2026/5/3038 浏览

OpenClaw 是一款开源可私有化部署的 AI 智能体,支持跨应用自动化任务,如整理消息、定时提醒及浏览器自动化。本文基于官方稳定版(v2026.3.8),详细拆解 Windows、macOS、Linux 及移动端的全平台部署流程,涵盖一键脚本安装、Docker 容器化部署及 Ollama 本地模型对接方案。

一、核心认知与环境准备

1.1 产品定位

OpenClaw 是开源免费的本地 AI 执行网关,核心优势包括数据本地存储、全平台兼容及自动化执行能力。它支持对接在线大模型(GPT、通义千问)和本地模型(Ollama),适合个人自动化办公和企业私有化部署。

注意:iOS 系统无官方原生安装包,建议通过云手机配合官方客户端使用;官方版本完全免费。

1.2 最低配置要求
部署平台系统版本要求内存要求存储空间要求核心依赖
WindowsWindows 10 及以上(64 位)≥4GB(推荐 8GB)≥2GB 可用空间Node.js ≥18(推荐 22+)
macOSmacOS 12 及以上≥4GB(推荐 8GB)≥2GB 可用空间Node.js ≥18 / Docker(可选)
LinuxUbuntu 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 平台部署
  1. 打开管理员 PowerShell:Win+R 输入'powershell',右键选择'以管理员身份运行'。
  2. 解锁脚本权限:Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
  3. 一键安装最新版:iwr -useb https://openclaw.ai/install.ps1 | iex
  4. 初始化配置:openclaw onboard,按提示绑定模型或设置密码。
  5. 启动服务:openclaw gateway start
  6. 验证:浏览器打开 http://localhost:18789,进入控制面板即成功。

若出现路径报错,请确保安装路径无中文、空格和特殊字符;无法访问面板请检查防火墙是否放行 18789 端口。

2.2 macOS/Linux 平台部署
方式 1:一键脚本部署
  1. 打开终端。
  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. 拉取镜像并运行:docker run -d --name openclaw-core -p 18789:18789 -v $(pwd):/data openclaw/openclaw
  4. 验证:执行 docker ps 查看状态,浏览器访问 IP:18789。
2.3 手机端部署(安卓/鸿蒙)
方式 1:APK 直装
  1. 下载正版 APK:访问 GitHub 仓库 Releases 栏目,下载对应版本安装包。
  2. 授权安装:点击安装包,选择'仅本次允许'未知来源应用,安装后立即关闭该权限。
  3. 初始化配置:打开应用,选择'本地运行模式',关闭'公网访问'开关。
  4. 权限设置:仅开启'悬浮窗、后台运行、通知'基础权限,敏感权限一律关闭。
  5. 后台保活:在电池设置中关闭 OpenClaw 的'电池优化',允许后台活动。
方式 2:Termux 进阶部署

适合高配手机,可自定义复杂任务。

  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 本地模型对接

实现离线运行,全程数据本地存储。

  1. 安装 Ollama:从官网下载对应版本,安装后启动(默认端口 11434)。
  2. 拉取本地模型:
    # 轻量版
    ollama pull qwen2:7b
    # 高性能版
    ollama pull llama3:8b
    
  3. 龙虾 AI 对接 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 需用管理员权限启动;服务器确认公网 IP 可访问。
  • Node.js 版本过低:卸载旧版本,安装 v18 及以上;国内用户可切换镜像源。
  • 手机端闪退:检查手机内存(需≥4GB),关闭多余后台应用;重新安装 APK 并确保开启后台保活。
  • Ollama 对接失败:确认 Ollama 已启动;模型名称输入正确(区分大小写)。
  • 广告或捆绑软件:卸载当前版本,从官方开源仓库或 F-Droid 下载正版安装包。

五、部署后基础使用

  1. 进入面板:浏览器访问 http://localhost:18789(手机端为 127.0.0.1:18789),输入管理员密码登录。
  2. 基础操作:在指令框输入需求,如'整理今天的微信工作消息',AI 会自动执行。
  3. 插件安装:仅在官方'插件市场'安装认证插件,第三方插件不装。
  4. 版本更新:终端输入 openclaw update。

六、总结

OpenClaw 部署核心在于选对方式与规避风险:新手用一键脚本,Windows 用户避开路径中文坑,手机端认准官方 APK 并关闭公网访问。作为开源免费的 AI 智能体,它支持个人自动化办公与企业私有化部署,按照上述步骤操作即可完成零报错、高安全的部署。

目录

  1. 一、核心认知与环境准备
  2. 1.1 产品定位
  3. 1.2 最低配置要求
  4. 1.3 准备工作
  5. 二、四大平台部署教程
  6. 2.1 Windows 平台部署
  7. 2.2 macOS/Linux 平台部署
  8. 方式 1:一键脚本部署
  9. 方式 2:Docker 部署
  10. 2.3 手机端部署(安卓/鸿蒙)
  11. 方式 1:APK 直装
  12. 方式 2:Termux 进阶部署
  13. 三、进阶配置:Ollama 本地模型对接
  14. 轻量版
  15. 高性能版
  16. 绑定 Ollama 服务
  17. 设置默认模型
  18. 四、高频报错避坑指南
  19. 五、部署后基础使用
  20. 六、总结
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

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

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

更多推荐文章

查看全部
  • HTML5+CSS3+JavaScript 实现高木同学圣诞树 GalGame 开发
  • QuantConnect LEAN 开源量化交易引擎介绍
  • Fooocus 部署实践:本地手动配置与云平台一键启用对比
  • AI 大模型技术解析与实战指南:深入理解 Transformer 与 Colossal-AI
  • 具身导航 VLN 最新论文汇总 | Vision-and-Language Navigation
  • Whisper-large-v3-turbo 实现 8 倍速语音转文字指南
  • ExoPlayer 播放缓存进度监听方案实现
  • MySQL 表约束详解:非空、主键与外键的作用
  • QClaw 上手指南:本地 AI 代理工具深度体验与配置
  • llama.cpp 本地部署:显存优化与常见报错排查
  • OpenClaw 是怎么让 AI 变得 “像人” 的?
  • Open-Lovable 网页克隆与 cpolar 远程访问实战
  • AIGC 产品经理转行路径与核心能力体系详解
  • 前端代码可读性优化:提升可维护性与团队协作
  • Java 调用 YOLOv26:ONNX 模型部署与工业质检实战
  • Spring 配置类与注解方式详解
  • JiuwenClaw AI 智能体实战:任务规划与上下文管理体验
  • 算法基础篇:一维差分专题与实战应用
  • 2025 AI 年度复盘:从 DeepSeek R1 开源到 Manus 商业落地
  • n8n 自动化工作流平台实战指南:部署、汉化与案例解析

相关免费在线工具

  • 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