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

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

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

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

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. 六、总结

    更多推荐文章

    查看全部
    • 前端面试核心知识点梳理与高频考点解析
    • 位运算实战:两整数之和与只出现一次的数字
    • C++ STL map 核心解析:从底层原理到 LeetCode 实战
    • 时序数据库选型指南:Apache IoTDB技术解析
    • Skills 智能体驱动开发:从使用到项目实战详解
    • C++ 类和对象:拷贝构造与赋值运算符重载详解
    • Redis Hash 类型及相关指令详解
    • 昇腾 NPU 部署 Llama 2 实战:环境配置、性能测试与优化指南
    • 基于LLama-Factory的游戏NPC对话逻辑优化实践
    • 5 款网文创作 AI 工具横评:DeepSeek、Kimi、笔灵等
    • 转行 Python 工程师:学习路径与数据分析方向指南
    • AI Agent 技能机制 Skills:概念原理与实操指南
    • KWDB 运维实战:用 SQL 打通 Metrics 与 CMDB 数据关联
    • VS Code Copilot 实战指南:从安装到高级配置
    • C++ std::make_unique 详解:安全创建 unique_ptr 的官方方法
    • C++ 入门基础:历史、首个程序与命名空间详解
    • 前端状态管理方案选型指南:从 Redux 到 Zustand 再到 Pinia
    • 基于 Coze 构建专属 AI 应用:从智能体开发到 Web 部署
    • KLayout 开源版图工具高效实战指南
    • 华为昇腾 310P 176TOPS AI 智能计算模组规格书

    相关免费在线工具

    • 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