2026年，AI行业的竞争重心已从纯对话大模型的参数比拼，彻底转向智能体的自主执行能力竞赛。在这场“从动口到动手”的技术跃迁中，OpenClaw（社区昵称“小龙虾”）以GitHub星标突破28万的成绩，成为开源AI智能体赛道中增速最快的项目之一。

OpenClaw由奥地利开发者Peter Steinberger于2025年11月发布，2026年1月正式定名并采用MIT开源协议，是一款本地优先、模型无关、具备系统级执行能力的AI智能体框架。它能够将自然语言指令转化为实际的电脑操作，完成文件整理、浏览器自动化、邮件发送、表格制作等任务，是真正“能动手干活”的数字员工。

然而，对于许多新手和开发者而言，获取正确的下载途径并顺利完成环境部署，是接触OpenClaw的第一道门槛。本文围绕“小龙虾OpenClaw下载”这一核心主题，系统梳理所有官方下载渠道和安装方式，帮助读者在5-10分钟内完成从下载到可用的全流程。

二、认识OpenClaw（小龙虾）

2.1 项目名称演变与核心定位

OpenClaw的前身经历了多次更名：2024年初以Clawdbot启动，2025年11月更名为Moltbot并在GitHub首发，2026年1月30日正式定名OpenClaw。其中“Open”表明免费开源属性，代码完全公开；“Claw”则突出其高效抓取和执行任务的能力。

因其官方Logo为红色龙虾造型，“Claw”本身有“钳子抓取”的寓意，加之美术设计使这只卡通龙虾更像中国人餐桌上的小龙虾，国内用户便将部署、调试模型的全过程形象地称为“养虾”。

2.2 核心特性速览

• 本地运行，隐私可控：数据传输与存储均在本地完成，敏感信息不出设备。

• 模型无关：兼容GPT、Claude、Kimi、DeepSeek、Ollama等主流大模型，自由切换。

• 零代码门槛：官方提供一键安装脚本和封装好的部署包，无需编程基础。

• 跨平台兼容：支持Windows 10/11、macOS、Linux三大操作系统。

• 全链路任务闭环：具备“意图理解→任务拆解→路径规划→工具调用→执行校验→结果反馈”的完整自主执行能力。

三、下载前环境准备与系统要求

在正式开始下载安装之前，务必确认系统满足以下基础条件。

3.1 系统与硬件要求

项目	最低配置	推荐配置
操作系统	Windows 10（64位）/ macOS 12 / Ubuntu 22.04	Windows 11 / macOS 14 / Ubuntu 24.04
内存	2 GB	8 GB及以上
磁盘空间	5 GB空闲空间	20 GB SSD
网络	需联网下载安装包和依赖	稳定宽带连接
权限	Windows需PowerShell管理员权限，Linux/macOS需sudo权限	同左

以上配置要求参照官方文档整理。

3.2 前置依赖说明

• Node.js：官方推荐v22及以上LTS版本。使用官方一键安装脚本的用户无需手动安装，脚本会自动检测并安装缺失依赖。

• Git：仅在源码编译安装时需要，一键安装脚本不依赖Git。

• Docker：如果选择Docker部署方式，需提前安装Docker环境。

3.3 重要避坑提醒

1. 务必关闭安全防护软件。OpenClaw运行时需要获取系统操控权限、文件读写权限以及模拟键鼠操作，这些行为容易被360、腾讯电脑管家、火绒等安全软件误判为风险程序，进而拦截进程或删除核心文件，导致部署失败。建议在安装完成后再重新开启安全软件。

2. 安装路径必须纯英文。路径中不可包含中文、空格或特殊符号。推荐路径如 D:\OpenClaw，禁止路径如 D:\软件\OpenClaw。

3. 准备专业解压工具。如果使用一键部署包（zip格式），Windows系统自带的解压功能容易出现文件损坏、权限不足等问题，建议使用WinRAR或7-Zip进行解压。

四、官方下载渠道与安装方式总览

OpenClaw提供四种主流下载与安装方式，用户可根据自身技术水平和场景选择：

安装方式	适用人群	优点	下载耗时
官方一键脚本安装	新手/全平台用户	全自动，自动安装Node.js和依赖	3-5分钟
npm/pnpm包管理器安装	开发者	精准控制版本，灵活	2-3分钟
源码编译安装	高级开发者	最新代码，可自定义修改	5-15分钟
Docker容器化部署	服务器/团队用户	环境隔离，快速迁移	5-10分钟

五、方式一：官方一键脚本安装（推荐）

这是官方最推荐、最简单且最不易出错的安装方式。脚本会自动检测系统环境、安装Node.js等缺失依赖，并完成OpenClaw核心程序的部署。

5.1 Windows系统

第一步：右键点击“开始”菜单，选择“终端（管理员）”或“Windows PowerShell（管理员）”，在UAC弹窗中点击“是”。

第二步：在终端中执行以下命令：

powershell

iwr -useb https://openclaw.ai/install.ps1 | iex

如果下载速度较慢，可使用国内镜像加速脚本：

powershell

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

等待脚本自动完成Node.js检测与安装、核心程序下载、环境变量配置，全程无需手动干预。

5.2 macOS / Linux系统

第一步：打开系统终端（macOS在“启动台→其他→终端”，Linux使用系统自带终端）。

第二步：执行以下命令：

bash

curl -fsSL https://openclaw.ai/install.sh | bash

国内用户可使用加速命令：

bash

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

等待脚本执行完成，终端中会显示安装进度和成功提示。

5.3 安装后验证

安装完成后，在终端中输入以下命令验证是否成功：

bash

openclaw --version

若正常输出版本号（如 v2026.4.24 或更高），说明安装成功。

六、方式二：npm/pnpm包管理器安装（适合开发者）

对于已安装Node.js环境的开发者，通过npm或pnpm全局安装可以更精准地控制版本。

6.1 确认Node.js版本

首先验证Node.js版本是否满足要求（需≥v22）：

bash

node -v
# 预期输出：v22.x.x 或更高

6.2 全局安装OpenClaw

bash

# 使用npm安装
npm install -g openclaw@latest

# 或使用pnpm安装（速度更快，依赖更稳定）
pnpm add -g openclaw@latest

国内用户可配置镜像源加速下载：

bash

npm config set registry https://registry.npmmirror.com
npm install -g openclaw@latest

安装完成后同样通过 openclaw --version 验证。

七、方式三：源码编译安装（适合高级开发者）

如果希望运行最新代码、修改底层配置逻辑，或在IDE中管理项目，可从GitHub获取源码进行本地构建。

7.1 克隆官方仓库

bash

git clone https://github.com/openclaw/openclaw.git
cd openclaw

OpenClaw官方源码仓库主地址为 https://github.com/openclaw/openclaw。建议克隆到空间充足的非系统盘，项目依赖安装后体积较大。

7.2 构建流程

OpenClaw使用pnpm workspace管理monorepo结构，务必使用pnpm进行依赖安装和构建：

bash

# 第一步：安装依赖
pnpm install

# 第二步：构建主程序
pnpm build

# 第三步：构建前端UI
cd ui
pnpm add -D vite --ignore-workspace
cd ..
pnpm ui:build

注意：第三步中的 pnpm add -D vite --ignore-workspace 是解决pnpm workspace模式下vite路径问题的关键步骤，不可省略。

7.3 启动Gateway

构建完成后，启动OpenClaw网关服务：

bash

openclaw gateway

八、方式四：Docker容器化部署（适合服务器场景）

Docker部署的优势在于环境隔离、快速启停、版本可控，适合需要在服务器上7×24小时运行或多人共用的场景。

8.1 拉取官方镜像

bash

docker pull openclaw/openclaw:latest

8.2 启动容器

bash

docker run -d \
  --name openclaw \
  -p 127.0.0.1:18789:18789 \
  -v ~/.openclaw:/home/node/.openclaw \
  --restart unless-stopped \
  openclaw/openclaw:latest

参数说明：-d表示后台运行；--name指定容器名称便于管理；-p进行端口映射；-v挂载数据卷确保持久化数据不丢失；--restart unless-stopped保证容器异常退出时自动重启。

8.3 容器管理常用命令

bash

# 查看容器运行状态
docker logs openclaw --tail 50

# 进入容器内部
docker exec -it openclaw /bin/bash

# 停止/启动/重启容器
docker stop openclaw
docker start openclaw
docker restart openclaw

九、安装后的初始化配置

无论选择哪种安装方式，首次启动OpenClaw后都需要完成模型配置，这是让智能体能够“思考”的核心步骤。

9.1 模型选择与API Key配置

OpenClaw本身是模型无关的调度框架，需要对接至少一个大语言模型才能正常工作。社区测试数据显示，Moonshot AI（Kimi K2.5）在国内网络环境下的响应速度和稳定性表现最优，也是官方推荐的国内用户首选模型。

配置流程如下：

1. 访问Kimi开放平台，注册并登录账号；

2. 进入API Key管理页面，创建一个新的API Key并复制；

3. 在OpenClaw的配置向导中，选择Moonshot AI作为模型提供商；

4. 将API Key粘贴至终端并回车确认；

5. 选择模型版本（推荐Kimi-K2.5），完成配置。

9.2 启动交互式终端（TUI）

配置完成后，通过以下命令进入TUI终端界面，即可开始与你的小龙虾对话并下发任务：

bash

openclaw tui

9.3 快速测试指令

部署完成后，可以尝试以下指令来测试智能体的执行能力：

• “帮我整理桌面上的所有文件，按类型分类”

• “打开浏览器搜索2026年AI智能体的发展趋势”

• “检查电脑上的垃圾文件并生成清理报告”

十、常见问题与排错指南

10.1 安装脚本下载失败或速度极慢

现象：执行 curl 或 iwr 命令后长时间无响应或提示网络错误。

解决方法：

• 优先使用国内镜像加速脚本（open-claw.org.cn 域名）；

• 检查防火墙或代理设置是否干扰了到安装脚本域名的连接；

• 切换网络环境（如连接手机热点）后再试。

10.2 Windows提示“无法识别openclaw命令”

现象：安装完成后在终端中执行 openclaw 提示“不是内部或外部命令”。

解决方法：

• 关闭当前终端窗口，重新以管理员身份打开PowerShell或命令提示符后再试——环境变量的更新需要新终端才能生效；

• 若仍无效，手动检查系统环境变量Path中是否包含OpenClaw的安装路径，通常是 C:\Users\你的用户名\AppData\Roaming\npm\。

10.3 安装过程中安全软件拦截

现象：安装被中断，提示文件被删除或隔离。

解决方法：

• 参照本文第3.3节的提醒，重新关闭所有安全防护软件；

• 重新解压安装包（如使用zip包方式）或重新执行安装命令；

• 从安全软件的隔离区中恢复被误删的文件。

10.4 Gateway状态显示离线

现象：安装完成后Gateway显示Offline。

解决方法：

• 首先确认安装路径是否满足纯英文要求，路径中含中文是导致此问题的常见原因；

• 检查Windows Defender实时防护是否已关闭；

• 重启一键启动程序或重新执行 openclaw gateway 启动命令。

10.5 Docker启动后容器立即退出

现象：执行 docker run 后容器状态为Exited。

解决方法：

• 使用 docker logs openclaw 查看容器日志，定位具体错误；

• 常见原因包括端口冲突（修改-p参数指定其他端口）、权限不足（以管理员身份运行终端）、Docker服务未正常启动。

十一、总结

OpenClaw（小龙虾）的下载安装并不复杂，关键在于选择正确的渠道和方式。本文系统梳理了官方一键脚本、npm包管理、源码编译、Docker容器化四种下载安装途径，覆盖Windows、macOS、Linux三大平台，从环境准备到安装后初始化配置提供了完整链路指引。

核心建议如下：

• 新手用户：首选官方一键脚本安装，简单高效，约5分钟即可完成；

• 开发者：推荐npm/pnpm包管理器安装，便于版本管理和项目集成；

• 需要深度定制：使用源码编译安装，配合IDE进行二次开发；

• 团队或服务器场景：采用Docker容器化部署，享受环境隔离与快速迁移的便利。

完成下载部署只是“养虾”的第一步。后续通过Skills技能扩展、多模型切换、办公平台对接等进阶操作，可以将这只“小龙虾”逐步调教为全能的数字员工，真正释放AI的生产力价值。