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

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

sudo apt update && sudo apt install -y git curl

CentOS/RHEL/Rocky/AlmaLinux:

sudo yum install -y git curl
# 或者在较新版本中：
sudo dnf install -y git curl

4.2 官方一键安装命令

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

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

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

4.3 初始化向导

openclaw onboard

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

OpenClaw 核心端口：18789

Ubuntu（ufw）：

sudo ufw allow 18789/tcp
sudo ufw reload
sudo ufw status

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

sudo firewall-cmd --permanent --add-port=18789/tcp
sudo firewall-cmd --reload
sudo firewall-cmd --list-ports

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

# 放行 18789 端口 (OpenClaw)
sudo iptables -A INPUT -p tcp --dport 18789 -j ACCEPT

# 保存规则 (CentOS/RHEL)
sudo service iptables save
# 或者 (Ubuntu/Debian)
sudo apt install iptables-persistent
sudo netfilter-persistent save

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

openclaw onboard --install-daemon

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

4.6 日志查看与排错

# 查看运行日志
journalctl -u openclaw -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 所在目录执行构建命令：

docker build -t openclaw-local .

6.2 运行容器

docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v /your/local/data:/root/.openclaw \
  --restart unless-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
  • 批量重命名指定文件夹内所有图片
  • 监控桌面新文件，自动归档备份
# AI智能体
Logo
龙虾开发者社区

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地，聚焦技能开发、插件实践与部署教程，为开发者提供可直接落地的方案、工具与交流平台，助力高效构建与落地 AI 应用

更多推荐

cover

AIAgent+RAG：构建企业级AI数据助手

avatar 龙虾开发者社区
cover

最好的VibeCoding宣讲材料

avatar 龙虾开发者社区
cover

ClawHub vs SkillHub：镜像站还是竞品？

avatar 龙虾开发者社区