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.92026年6月最新支持系统Windows10/11、MacOS 12、LinuxUbuntu/CentOS/Kylin、WSL21.3 最低硬件配置必看内存最低 8G推荐 16G4G 极易网关崩溃、卡死磁盘预留 ≥10G 空闲空间系统Win10 20H2 以上 / Win11 / MacOS12网络可正常访问外网企业内网需放行外网资源下载支持离线部署文末附教程1.4 安装核心红线全网90%报错根源安装路径纯英文、无中文、无空格、无特殊符号禁止系统自带解压必须 7-Zip / WinRAR安装阶段临时关闭所有杀毒装完立刻加白名单恢复防护禁止中文用户名桌面安装二、Windows 本地一键部署新手首选2.1 安装前准备关闭 360、火绒、电脑管家、Windows Defender 实时防护仅安装过程临时关闭安装 7-Zip / WinRAR 专业解压工具新建纯英文目录D:\OpenClaw2.2 官方安装包下载Windows 一键包https://xiake.yun/api/download/package/18?promoCodeIVD643FDE29A2.3 解压与启动规范右键压缩包 → 7-Zip 解压到当前文件夹打开目录双击 Openclaw Windows一键启动.exeSmartScreen 拦截更多信息 → 仍要运行选择纯英文安装路径同意协议开始安装等待依赖自动安装、网关初始化 3–5 分钟右上角显示 Gateway 在线 部署成功2.4 PowerShell 通用命令安装如果官方一键包无法下载或提示损坏请使用此方法它能确保获取最新稳定版。以管理员身份打开 PowerShell。执行以下命令自动检测并安装依赖iwr-useb https://open-claw.org.cn/install-cn.ps1|iex安装过程中若提示执行策略错误请输入Y确认或先执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser。2.5 安装后安全恢复重要将整个 D:\OpenClaw 目录加入杀毒软件信任白名单重新开启 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?promoCodeIVD643FDE29A3.3 Mac 权限放行步骤解压后第一次打开提示“无法验证开发者”系统设置 → 隐私与安全性 → 通用 → 仍要打开开启文件与完全访问权限、辅助功能、自动化权限重启软件等待 Gateway 在线即可四、Linux 云服务器完整部署Ubuntu / CentOS 通用适用于阿里云/腾讯云/华为云服务器、长期后台运行、企业自动化任务4.1 前置依赖必须执行OpenClaw 的自动安装脚本依赖git和curl。在执行安装前请先手动安装这些基础工具。Ubuntu/Debian:sudoaptupdatesudoaptinstall-ygitcurlCentOS/RHEL/Rocky/AlmaLinux:sudoyuminstall-ygitcurl# 或者在较新版本中sudodnfinstall-ygitcurl4.2 官方一键安装命令执行以下命令脚本将自动克隆仓库、安装 Node.js 22、pnpm 并构建项目curl-fsSLhttps://open-claw.org.cn/install-cn.sh|bash注意如果提示权限不足请在命令前加sudo或者确保当前用户有权限写入家目录。4.3 初始化向导openclaw onboard4.4 服务器必备防火墙放行端口多发行版适配OpenClaw 核心端口18789Ubuntuufwsudoufw allow18789/tcpsudoufw reloadsudoufw statusCentOS 7/8/9 及 RHEL 系列firewalldsudofirewall-cmd--permanent--add-port18789/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 save4.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 无法使用 AI99% 是没配置模型密钥支持三种主流方案7.1 通义千问推荐、稳定免费额度阿里云百炼获取 API Key填入 OpenClaw 模型配置面板即可。7.2 DeepSeek / GPT 系列填入对应 API 地址 Key即可切换模型。7.3 本地 Ollama 模型完全离线、无外网本地部署 Ollama 本地大模型OpenClaw 对接本地推理全程断网可用。八、安全加固防暴力破解解决公网暴露被扫描、爆破、未授权访问风险8.1 设置面板登录密码设置 → 安全设置 → 开启登录密码设置高强度密码字母数字符号8.2 IP 白名单服务器必开仅允许自己办公网/固定 IP 访问面板拦截所有陌生IP8.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 彻底卸载关闭 OpenClaw 所有进程删除安装目录清理用户目录缓存配置服务器执行systemctl stop openclaw systemctl disable openclaw十二、离线部署方案提前下载完整安装包、Node依赖、pnpm依赖断网环境可完整部署适合内网涉密服务器、隔离办公环境。十三、新手入门可直接执行的 AI 自动化指令整理桌面所有文件按文件类型自动分类归档遍历D盘所有日志文件清理空文件和过期缓存打开浏览器搜索2026 AI智能体行业报告整理为Excel批量重命名指定文件夹内所有图片监控桌面新文件自动归档备份