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

OpenClaw 龙虾 AI 全平台部署与配置指南

OpenClaw 龙虾 AI 是一款支持本地化部署的开源智能体,具备跨应用自动化能力。 Windows、macOS、Linux 及移动端(安卓/鸿蒙)的一键脚本与 Docker 部署流程,涵盖环境准备、端口配置及安全权限设置。进阶部分包含 Ollama 本地模型对接方案,实现离线运行与数据隐私保护。同时提供常见报错排查指南,帮助用户快速完成从零到一的环境搭建与基础使用配置。

NodeJser发布于 2026/4/11更新于 2026/7/2545 浏览

OpenClaw 龙虾 AI 概述

OpenClaw 龙虾 AI 是开源免费的本地 AI 执行网关,核心优势是数据本地存储、全平台兼容、自动化执行。它能对接在线大模型和本地模型,支持文件管理、多渠道消息接入、自定义脚本运行。

一、环境准备

1.1 核心定位

OpenClaw 龙虾 AI 无需上传数据到第三方平台,隐私性良好。适合个人自动化办公和企业私有化部署。

注意: 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(默认端口),后续需放行该端口。

二、四大平台部署教程

本次部署优先推荐'官方一键脚本',零配置、速度快;进阶用户可选择 Docker 或手动部署。

2.1 Windows 平台部署

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. 打开终端(macOS:Launchpad→其他→终端;Linux:Ctrl+Alt+T);
  2. 执行一键安装命令:
curl -fsSL https://openclaw.ai/install.sh | bash
  • 初始化 + 启动服务:openclaw onboard && openclaw gateway start
  • 验证:浏览器访问 http://localhost:18789。
  • 方式 2:Docker 部署

    适合 Linux 服务器或需要环境隔离的场景:

    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:访问官方开源仓库 Releases 栏目,下载对应版本安装包;
    2. 授权安装:点击安装包,选择'仅本次允许'未知来源应用,按提示完成安装;
    3. 初始化配置:打开应用,按向导选择'本地运行模式',关闭'公网访问'开关;
    4. 权限设置:仅开启'悬浮窗、后台运行、通知'三大基础权限;
    5. 后台保活:进入手机电池设置,找到应用,关闭'电池优化'。
    方式 2:Termux 进阶部署

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

    1. 安装正版 Termux:从 F-Droid 官网下载;
    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 本地模型对接

    对接 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 需用管理员权限启动服务。
    • 安装失败,提示'Node.js 版本过低': 卸载旧版本 Node.js,安装 v18 及以上版本。
    • 手机端闪退、卡顿: 检查手机内存(需≥4GB),关闭多余后台应用。
    • Ollama 对接失败: 确认 Ollama 已启动(默认端口 11434);模型名称输入正确。
    • 安装后出现广告、捆绑软件: 从官方开源仓库下载正版安装包,避免第三方渠道。

    五、部署后基础使用

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

    六、总结

    OpenClaw 龙虾 AI 的部署核心是选对方式、规避风险:新手用一键脚本,Windows 用户避开路径中文坑;手机端认准官方 APK,关闭公网访问;进阶用户可通过 Docker 部署或对接 Ollama 本地模型。作为开源免费的 AI 智能体,它无需复杂配置,无论是个人自动化办公,还是企业私有化部署,都能满足需求。

    目录

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

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

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

    更多推荐文章

    查看全部
    • Qwen3-Embedding-4B + llama.cpp 部署教程
    • 飞书机器人接入 Seedance 2.0 国产化集成避坑指南:ARM 与国密适配
    • Llama-Factory 训练时如何平衡计算与 IO 开销
    • Altera USB-Blaster 驱动安装:FPGA 下载基础指南
    • Windows 安装 WSL2 并运行 Ubuntu 22.04 指南
    • QClaw 本地化 AI 个人助手平台完全指南
    • Linux To Go Ubuntu 22.04 无线网卡 MT7925 驱动问题解决方案
    • PyCharm 启动报错 Archived non-system classes are disabled 解决方案
    • Python 爬虫开发实战:从 Requests 到分布式部署
    • Qwen3 系列模型对比及长上下文训练技术解析
    • ROS1 与 ROS2 桥接器完整指南:实现跨版本机器人通信
    • Docker 容器 Git 工作树隔离难题及解决方案
    • 攻防演练中 DTcms 代码审计与密码解密实战
    • 微软 GraphRAG 实战部署与配置指南
    • Node.js 最新版本下载安装、版本选择及环境配置教程
    • Ubuntu 安装 OpenClaw 并接入飞书机器人
    • Windows Server 2022/2025 搭建 Web 服务器实验指导
    • VSCode Copilot 接入智谱 GLM-5.1 实现自定义大模型配置
    • Claude Code 插件 Ralph Wiggum 使用指南:实现 AI 自动修复 Bug
    • LLaMA-Factory 微调 DeepSeek-R1 模型实战指南

    相关免费在线工具

    • 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