OpenClaw（小龙虾）本地部署通用教程（Windows / macOS / Linux）

发布时间：2026-03-29 19:38

OpenClaw是一个开源的AI自动化代理，可本地部署以执行文件操作、浏览器自动化等任务。以下是 Windows / macOS / Linux 的本地部署详细教程。

- **操作系统**：Windows 10/11、macOS 12+、Ubuntu 20.04+ 等主流64位系统

- **硬件建议**：内存 ≥ 4GB（推荐 8GB），磁盘空间 ≥ 20GB

- **核心依赖**：

- Node.js：版本 ≥ 22（推荐 22.x 或 24.x LTS）

- 包管理器：npm（随 Node.js 安装）或 **pnpm**（推荐，可避免部分构建错误）

- Git：用于拉取插件（可选）

- Docker：用于容器化部署（可选）

- **模型 API Key**：用于智能问答和任务规划。可选用阿里云百炼、硅基流动、OpenAI 等。新手可先跳过，后续在 WebUI 中配置。

---

在开始菜单搜索“PowerShell”，右键选择“以管理员身份运行”。

使用 winget 一键安装：

安装后执行以下命令检查版本：

加速依赖下载：

执行全局安装：

安装完成后检查版本：

根据提示操作：

- **风险提示**：输入确认 AI 将拥有本地文件操作权限。

- **模式选择**：新手推荐（快速启动）。

- **模型/渠道/技能**：均可选择（稍后配置）。

- **交互方式**：选择，向导将自动启动服务并在浏览器中打开。

若向导未自动启动，可执行以下命令：

安装完成后，务必运行诊断命令，确保环境正确：

如果所有检查项均为绿色，说明部署成功。

首次登录 WebUI 可能需要令牌，可通过以下命令生成：

Windows 配置文件通常位于：

---

若未安装，在终端执行：

检查版本：

配置步骤与 Windows 基本一致，最后选择打开 WebUI 即可在访问。

macOS 配置文件通常位于：

---

检查版本：

配置步骤与前述系统一致。

运行初始化向导时选择安装守护进程，或执行：

Linux 配置文件通常位于：

---

登录阿里云百炼控制台，在“密钥管理”页面创建并复制你的API Key。

避免手动编辑配置文件，使用命令进行配置：

重启后，即可在 WebUI 中体验完整的 AI 自动化功能。

---

- **权限错误**：在 Linux/macOS 上，若全局安装失败，可尝试在命令前加。

- **安装缓慢或失败**：确保已配置 npm 国内镜像源；若仍失败，可改用安装：

- **端口占用**：默认端口为 18789。若被占用，可在配置文件中修改字段。

- **安全警告**：OpenClaw 需要文件读写权限。请勿在存有敏感信息的生产环境根目录下运行，建议指定专用工作区。

- **配置未生效**：修改配置文件后，必须执行重启服务。

- **WebUI 无法访问**：确认服务已启动（），并检查防火墙设置。若提示需要令牌，使用生成。

---

完成上述步骤后，可以通过以下方式确认部署成功：

1. 浏览器访问，进入 WebUI。

2. 在 WebUI 中尝试执行一个简单任务（如“列出当前目录文件”）。

3. 运行确保所有检查项通过。

---

如果你对这些都不甚了解，只想快速的安装部署好龙虾，也可以用【**Claw大龙虾本地部署大师**】来进行快速安装部署好龙虾，然后再结合下面关于配置大模型API的教程就可以。

具体可以看我这篇文章：https://cloud.tencent.com/developer/article/2644262

网址：OpenClaw（小龙虾）本地部署通用教程（Windows / macOS / Linux） https://mxgxt.com/news/view/2067849

⬅️上一篇：阿黛尔低调现身NBA聚会，老公里

➡️下一篇：华娱1997 第547章两首王

OpenClaw（小龙虾）本地部署通用教程（Windows / macOS / Linux）

相关内容

随便看看

最新实时动态

热点实时动态

专题

推荐实时动态