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

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

3. 安装过程中若提示执行策略错误，请输入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 自动化指令
• 文件远程处理、整理、汇总
• 任务结果微信推送通知
  限制说明：仅局域网可用，不支持外网穿透，保证设备安全。

十、全套避坑报错排查表

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

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
• 批量重命名指定文件夹内所有图片
• 监控桌面新文件，自动归档备份