当前位置： 首页 > news >正文

OpenClaw（龙虾）2026 最新安装部署终极指南

news 2026/6/30 2:38:04

OpenClaw（龙虾）2026 最新安装部署终极指南

摘要：本文整理了 2026 年 6 月最新开源本地 AI 智能体 OpenClaw（龙虾）完整部署教程。覆盖 Windows / Mac 本地一键部署、Linux 云服务器手动部署、Docker 容器化部署、阿里云镜像极速部署四大方案。补齐全网最齐全的环境依赖、大模型对接、端口防火墙配置、开机自启、反向代理、防暴力破解、升级卸载迁移、高频报错排查。全程规避杀毒拦截、路径报错、网关离线等经典坑点，新手 5 分钟、运维 3 分钟即可搭建可商用的本地 AI 自动办公数字员工。

文章目录

  • OpenClaw（龙虾）2026 最新安装部署终极指南
    • 一、前置说明 · 核心认知 + 硬件环境要求
      • 1.1 OpenClaw 核心定位
      • 1.2 适配版本与时间锚点
      • 1.3 最低硬件配置（必看）
      • 1.4 安装核心红线（全网90%报错根源）
    • 二、Windows 本地一键部署（新手首选）
      • 2.1 安装前准备
      • 2.2 官方安装包下载
      • 2.3 解压与启动规范
      • 2.4 PowerShell 通用命令安装
      • 2.5 安装后安全恢复（重要）
    • 三、Mac 完整部署教程
      • 3.1 Mac 专属前置坑点与依赖检查
      • 3.2 Mac 安装包下载
      • 3.3 Mac 权限放行步骤
    • 四、Linux 云服务器完整部署（Ubuntu / CentOS 通用）
      • 4.1 前置依赖（必须执行）
      • 4.2 官方一键安装命令
      • 4.3 初始化向导
      • 4.4 服务器必备：防火墙放行端口（多发行版适配）
      • 4.5 后台守护进程 + 开机自启
      • 4.6 日志查看与排错
    • 五、Windows 服务器 PowerShell 部署
    • 六、Docker 容器化部署（企业级方案）
      • 6.1 构建 Docker 镜像
      • 6.2 运行容器
    • 七、大模型 API 配置教程
      • 7.1 通义千问（推荐、稳定免费额度）
      • 7.2 DeepSeek / GPT 系列
      • 7.3 本地 Ollama 模型（完全离线、无外网）
    • 八、安全加固｜防暴力破解
      • 8.1 设置面板登录密码
      • 8.2 IP 白名单（服务器必开）
      • 8.3 禁止公网裸端口暴露
      • 8.4 会话超时自动登出
    • 九、微信 ClawBot 联动玩法
    • 十、全套避坑报错排查表
    • 十一、软件维护：升级、备份、迁移、卸载
      • 11.1 数据备份（最重要）
      • 11.2 设备迁移
      • 11.3 版本升级
      • 11.4 彻底卸载
    • 十二、离线部署方案
    • 十三、新手入门可直接执行的 AI 自动化指令

一、前置说明 · 核心认知 + 硬件环境要求

1.1 OpenClaw 核心定位

OpenClaw（龙虾）是开源、本地优先、数据私有化的 AI 智能体，区别于普通对话 AI：可自动读文件、跑脚本、操控浏览器、键鼠自动化、批量整理文档、跨平台消息推送，是真正可落地的「本地 AI 数字员工」。
所有记忆、配置、对话记录、任务文件全部本地 Markdown 存储，不上传云端，隐私性极强。

1.2 适配版本与时间锚点

  • 当前稳定版：v2.7.9（2026年6月最新）
  • 支持系统：Windows10/11、MacOS 12+、Linux（Ubuntu/CentOS/Kylin）、WSL2

1.3 最低硬件配置（必看）

  • 内存：最低 8G｜推荐 16G+（4G 极易网关崩溃、卡死）
  • 磁盘：预留 ≥10G 空闲空间
  • 系统：Win10 20H2 以上 / Win11 / MacOS12+
  • 网络：可正常访问外网，企业内网需放行外网资源下载；支持离线部署（文末附教程）

1.4 安装核心红线（全网90%报错根源）

  1. 安装路径纯英文、无中文、无空格、无特殊符号
  2. 禁止系统自带解压，必须 7-Zip / WinRAR
  3. 安装阶段临时关闭所有杀毒，装完立刻加白名单恢复防护
  4. 禁止中文用户名桌面安装

二、Windows 本地一键部署（新手首选）

2.1 安装前准备

  1. 关闭 360、火绒、电脑管家、Windows Defender 实时防护（仅安装过程临时关闭）
  2. 安装 7-Zip / WinRAR 专业解压工具
  3. 新建纯英文目录：D:\OpenClaw

2.2 官方安装包下载

Windows 一键包：https://xiake.yun/api/download/package/18?promoCode=IVD643FDE29A

2.3 解压与启动规范

  1. 右键压缩包 → 7-Zip 解压到当前文件夹
  2. 打开目录，双击 Openclaw Windows一键启动.exe
  3. SmartScreen 拦截：更多信息 → 仍要运行
  4. 选择纯英文安装路径，同意协议，开始安装
  5. 等待依赖自动安装、网关初始化 3–5 分钟
  6. 右上角显示 Gateway 在线 = 部署成功

2.4 PowerShell 通用命令安装

如果官方一键包无法下载或提示损坏，请使用此方法，它能确保获取最新稳定版。

  1. 以管理员身份打开 PowerShell。
  2. 执行以下命令（自动检测并安装依赖）：
iwr-useb https://open-claw.org.cn/install-cn.ps1|iex
  1. 安装过程中若提示执行策略错误，请输入Y确认，或先执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser。

2.5 安装后安全恢复（重要）

  1. 将整个 D:\OpenClaw 目录加入杀毒软件信任白名单
  2. 重新开启 Windows Defender 实时防护

三、Mac 完整部署教程

3.1 Mac 专属前置坑点与依赖检查

  • Mac 默认拦截未知开发者软件，需手动授权
  • 必须开启辅助权限，否则无法自动化操控文件/浏览器
  • M芯片 / Intel芯片 全部兼容
  • 前置依赖检查：Mac 系统首次安装可能缺少命令行工具。如果在安装过程中报错找不到git或make，请先在终端执行xcode-select --install，然后按提示安装基础开发工具。

3.2 Mac 安装包下载

Mac 一键包：https://openclaw.ikidi.top/api/download/package/35?promoCode=IVD643FDE29A

3.3 Mac 权限放行步骤

  1. 解压后第一次打开提示“无法验证开发者”
  2. 系统设置 → 隐私与安全性 → 通用 → 仍要打开
  3. 开启：文件与完全访问权限、辅助功能、自动化权限
  4. 重启软件，等待 Gateway 在线即可

四、Linux 云服务器完整部署（Ubuntu / CentOS 通用）

适用于：阿里云/腾讯云/华为云服务器、长期后台运行、企业自动化任务

4.1 前置依赖（必须执行）

OpenClaw 的自动安装脚本依赖git和curl。在执行安装前，请先手动安装这些基础工具。
Ubuntu/Debian:

sudoaptupdate&&sudoaptinstall-ygitcurl

CentOS/RHEL/Rocky/AlmaLinux:

sudoyuminstall-ygitcurl# 或者在较新版本中：sudodnfinstall-ygitcurl

4.2 官方一键安装命令

执行以下命令，脚本将自动克隆仓库、安装 Node.js 22、pnpm 并构建项目：

curl-fsSLhttps://open-claw.org.cn/install-cn.sh|bash

注意：如果提示权限不足，请在命令前加sudo，或者确保当前用户有权限写入家目录。

4.3 初始化向导

openclaw onboard

4.4 服务器必备：防火墙放行端口（多发行版适配）

OpenClaw 核心端口：18789

Ubuntu（ufw）：

sudoufw allow18789/tcpsudoufw reloadsudoufw status

CentOS 7/8/9 及 RHEL 系列（firewalld）：

sudofirewall-cmd--permanent--add-port=18789/tcpsudofirewall-cmd--reloadsudofirewall-cmd --list-ports

备用方案：使用 iptables（适用于未安装 firewalld 的最小化系统）
如果您的系统未使用firewalld，可直接使用iptables命令放行端口：

# 放行 18789 端口 (OpenClaw)sudoiptables-AINPUT-ptcp--dport18789-jACCEPT# 保存规则 (CentOS/RHEL)sudoserviceiptables save# 或者 (Ubuntu/Debian)sudoaptinstalliptables-persistentsudonetfilter-persistent save

4.5 后台守护进程 + 开机自启

openclaw onboard --install-daemon

实现：开机自启、异常自动重启、后台常驻运行

4.6 日志查看与排错

# 查看运行日志journalctl-uopenclaw-f# 查看服务状态systemctl status openclaw

五、Windows 服务器 PowerShell 部署

适合 Windows Server 云服务器
以管理员身份打开 PowerShell，执行：

iwr-useb https://open-claw.org.cn/install-cn.ps1|iex

六、Docker 容器化部署（企业级方案）

隔离环境、不污染宿主机、一键迁移、适合生产环境。本章节基于官方脚本逻辑，提供可直接构建和运行的完整方案。

6.1 构建 Docker 镜像

请将以下内容保存为Dockerfile文件：

FROM node:22-bookworm-slim WORKDIR /app # 安装基础依赖 RUN apt-get update && apt-get install -y git curl python3 make g++ && \ npm install -g pnpm && \ apt-get clean # 克隆项目（使用 Gitee 源加速，可替换为官方 GitHub 仓库） RUN git clone https://gitee.com/OpenClaw-CN/openclaw-cn.git . # 安装项目依赖并构建 RUN pnpm install && pnpm build EXPOSE 18789 CMD ["node", "packages/clawdbot/dist/entry.js", "serve", "--port", "18789"]

在Dockerfile所在目录执行构建命令：

dockerbuild-topenclaw-local.

6.2 运行容器

dockerrun-d\--nameopenclaw\-p18789:18789\-v/your/local/data:/root/.openclaw\--restartunless-stopped\openclaw-local

关键说明：/your/local/data请替换为您宿主机上的一个绝对路径，用于持久化存储 OpenClaw 的所有配置、记忆和任务数据，防止容器删除后数据丢失。

七、大模型 API 配置教程

装好 OpenClaw 无法使用 AI，99% 是没配置模型密钥，支持三种主流方案：

7.1 通义千问（推荐、稳定免费额度）

阿里云百炼获取 API Key，填入 OpenClaw 模型配置面板即可。

7.2 DeepSeek / GPT 系列

填入对应 API 地址 + Key，即可切换模型。

7.3 本地 Ollama 模型（完全离线、无外网）

本地部署 Ollama + 本地大模型，OpenClaw 对接本地推理，全程断网可用。

八、安全加固｜防暴力破解

解决公网暴露被扫描、爆破、未授权访问风险

8.1 设置面板登录密码

设置 → 安全设置 → 开启登录密码，设置高强度密码（字母+数字+符号）

8.2 IP 白名单（服务器必开）

仅允许自己办公网/固定 IP 访问面板，拦截所有陌生IP

8.3 禁止公网裸端口暴露

生产环境必须：Nginx 反向代理 + HTTPS，隐藏真实端口

8.4 会话超时自动登出

配置空闲超时 5 分钟自动下线，防止挂机被盗用

九、微信 ClawBot 联动玩法

微信版本 ≥ 8.0.70
我 → 设置 → 插件 → 搜索 ClawBot 启用
同一局域网扫码绑定本地 OpenClaw，实现：

  • 微信远程下发 AI 自动化指令
  • 文件远程处理、整理、汇总
  • 任务结果微信推送通知
    限制说明：仅局域网可用，不支持外网穿透，保证设备安全。

十、全套避坑报错排查表

问题现象根本原因解决方案
安装包被自动删除杀毒软件实时拦截安装临时关闭防护，装完加白名单
Gateway 一直离线端口占用/防火墙未放行/依赖缺失放行18789端口、重启服务、重装依赖
启动报错、组件损坏系统自带解压损坏文件使用 7-Zip 重新解压
路径报错、无法初始化含中文/空格/特殊字符迁移至纯英文短路径
Mac 打不开软件开发者权限拦截隐私与安全性手动放行
自动化无权限操作文件系统权限未授予开启完全磁盘访问+辅助权限
公网被暴力扫描裸端口暴露无防护配置HTTPS反向代理+IP白名单+登录密码
内存溢出、闪退内存不足2G/未开swap升级配置或开启swap分区
模型无响应、无法对话未配置API Key/网络不通填入有效大模型密钥，或切换本地Ollama

十一、软件维护：升级、备份、迁移、卸载

11.1 数据备份（最重要）

直接备份安装目录下 memory、config、workspace 文件夹，即可完整保存 AI 记忆、任务、配置。

11.2 设备迁移

新设备重装软件 → 关闭软件 → 覆盖粘贴备份目录 → 重启即可无缝迁移。

11.3 版本升级

保留配置目录，覆盖新版安装包即可，数据不丢失。

11.4 彻底卸载

  1. 关闭 OpenClaw 所有进程
  2. 删除安装目录
  3. 清理用户目录缓存配置
  4. 服务器执行systemctl stop openclaw && systemctl disable openclaw

十二、离线部署方案

提前下载完整安装包、Node依赖、pnpm依赖，断网环境可完整部署，适合内网涉密服务器、隔离办公环境。

十三、新手入门可直接执行的 AI 自动化指令

  • 整理桌面所有文件，按文件类型自动分类归档
  • 遍历D盘所有日志文件，清理空文件和过期缓存
  • 打开浏览器搜索2026 AI智能体行业报告，整理为Excel
  • 批量重命名指定文件夹内所有图片
  • 监控桌面新文件，自动归档备份
http://www.jsqmd.com/news/1093228/

相关文章：

  • xref_data_to_array
  • CSDN博客-第1天-单神经元反向传播
  • 计算机二级基础知识-计算机体系结构
  • 中小微企业建站首选！PageAdmin CMS，零代码搞定官网运维
  • chunk重叠overlap设多少：切断上下文的坑
  • 支持多端生成的AI开发软件怎么选？功能对比指南
  • AI编程新范式：Skills技能库如何提升Claude、Cursor代码生成质量
  • AI Agent开发实战：从零构建一个能自主规划任务的智能体
  • Python学习笔记·第24天：Pandas数据清洗——缺失值、重复值与透视表实战
  • 使用visual studio和ai制作ppt
  • AI 学习助手：基于 HarmonyOS ArkTS 的智能学习伴侣开发实践
  • 第一批被龙虾气到的人出现了
  • Vue3 项目从开发到上线：环境变量、打包优化与 Nginx 部署全流程
  • 相处的艺术：尊重与边界
  • 企业知识图谱的拐点： 当本体工程遇上 LLM 与 MCP
  • Spring Boot 自定义 Starter 机制
  • GPT-5.6 Sol预览解读：max推理、ultra多Agent与分层安全栈
  • 剑指offer-79、最⻓不含重复字符的
  • Codex Linux 教程：从安装配置到卸载清理全流程指南
  • 基于Anthropic-Cybersecurity-Skills构建网络安全AI智能体实战指南
  • FontForge字体设计完全指南：从入门到精通掌握专业字体编辑
  • GPT-5.6系列模型发布遇阻：OpenAI面临多国监管审批，Claude Fable 5重返引发全球讨论
  • Vibe Coding 实战复盘：一个人 + AI，从零打造会聊天的个人主页
  • 关于多线程归并排序的性能瓶颈与优化方案的技术7
  • HFSS求解设置实战解析：从驱动求解到本征模求解的核心配置
  • 数据中心电力模块的发展趋势对数据中心建设有哪些影响？
  • 目前自动评价系统问题---------会卡在一些异常的地方
  • XCP协议：从总线标定到汽车ECU数据交互的核心
  • GoChatIAI -Go语言AI应用服务平台（1）
  • 2026论文双降终极榜单：10款降AI率网站，查重降重+降AIGC一次通关