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 中配置。

---

## 💻 Windows 部署（PowerShell）

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

### 2. 安装 Node.js 和 Git
使用 winget 一键安装：
```powershell
winget install OpenJS.NodeJS.LTS -y
winget install Git.Git -y
```
安装后执行以下命令检查版本：
```powershell
node -v
npm -v
git --version
```

### 3. 配置 npm 国内镜像（推荐）
加速依赖下载：
```powershell
npm config set registry https://registry.npmmirror.com
```

### 4. 安装 OpenClaw
执行全局安装：
```powershell
npm install -g openclaw@latest
```
安装完成后检查版本：
```powershell
openclaw --version
```

### 5. 运行初始化向导
```powershell
openclaw onboard
```
根据提示操作：
- **风险提示**：输入 `Yes` 确认 AI 将拥有本地文件操作权限。
- **模式选择**：新手推荐 `QuickStart`（快速启动）。
- **模型/渠道/技能**：均可选择 `Skip for now`（稍后配置）。
- **交互方式**：选择 `Open the Web UI`，向导将自动启动服务并在浏览器中打开 `http://localhost:18789`。

### 6. 手动启动与管理（可选）
若向导未自动启动，可执行以下命令：
```powershell
# 启动服务
openclaw gateway start
# 查看状态
openclaw status
# 重启服务
openclaw gateway restart
```

### 7. 健康检查（重要）
安装完成后，务必运行诊断命令，确保环境正确：
```powershell
openclaw doctor
```
如果所有检查项均为绿色，说明部署成功。

### 8. 获取 WebUI 访问令牌（如需）
首次登录 WebUI 可能需要令牌，可通过以下命令生成：
```powershell
openclaw token generate
```

### 9. 配置文件位置
Windows 配置文件通常位于：
```
C:\Users\你的用户名\.openclaw\openclaw.json
```

---

## 🍎 Mac OS 部署（终端）

### 1. 安装 Homebrew
若未安装，在终端执行：
```bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```

### 2. 安装 Node.js 和 Git
```bash
brew install node@22 git
echo 'export PATH="$(brew --prefix node@22)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
```
检查版本：
```bash
node -v
npm -v
git --version
```

### 3. 配置 npm 国内镜像（推荐）
```bash
npm config set registry https://registry.npmmirror.com
```

### 4. 安装 OpenClaw
```bash
npm install -g openclaw@latest
```
检查版本：
```bash
openclaw --version
```

### 5. 运行初始化向导
```bash
openclaw onboard
```
配置步骤与 Windows 基本一致，最后选择打开 WebUI 即可在 `http://localhost:18789` 访问。

### 6. 手动启动与管理（可选）
```bash
# 启动服务
openclaw gateway start
# 查看状态
openclaw status
# 重启服务
openclaw gateway restart
```

### 7. 健康检查（重要）
```bash
openclaw doctor
```

### 8. 获取 WebUI 访问令牌（如需）
```bash
openclaw token generate
```

### 9. 配置文件位置
macOS 配置文件通常位于：
```
~/.openclaw/openclaw.json
```

---

## 🐧 Linux 部署（Ubuntu/Debian）

### 1. 更新系统并安装依赖
```bash
sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git
```

### 2. 安装 Node.js
```bash
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
```
检查版本：
```bash
node -v
npm -v
```

### 3. 配置 npm 国内镜像（推荐）
```bash
npm config set registry https://registry.npmmirror.com
```

### 4. 安装 OpenClaw
```bash
sudo npm install -g openclaw@latest
```
检查版本：
```bash
openclaw --version
```

### 5. 运行初始化向导
```bash
openclaw onboard
```
配置步骤与前述系统一致。

### 6. 手动启动与管理（可选）
```bash
# 启动服务
openclaw gateway start
# 查看状态
openclaw status
# 重启服务
openclaw gateway restart
```

### 7. 设置开机自启（可选）
运行初始化向导时选择安装守护进程，或执行：
```bash
openclaw gateway enable
```

### 8. 健康检查（重要）
```bash
openclaw doctor
```

### 9. 获取 WebUI 访问令牌（如需）
```bash
openclaw token generate
```

### 10. 配置文件位置
Linux 配置文件通常位于：
```
~/.openclaw/openclaw.json
```

---

## 配置大模型API（以阿里云百炼为例）

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

### 2. 使用命令行配置（推荐）
避免手动编辑配置文件，使用 `openclaw config` 命令进行配置：
```bash
# 设置默认模型的提供商为百炼
openclaw config set agents.defaults.model.provider "bailian"
# 设置模型名称（可根据实际替换）
openclaw config set agents.defaults.model.model_id "qwen-max"
# 设置 API Key
openclaw config set models.providers.bailian.api_key "你的API Key"
# 设置 API 基础地址（兼容 OpenAI 格式）
openclaw config set models.providers.bailian.base_url "https://dashscope.aliyuncs.com/compatible-mode/v1"
```

### 3. 重启服务
```bash
openclaw gateway restart
```

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

---

## 常见问题与提示

- **权限错误**：在 Linux/macOS 上，若全局安装失败，可尝试在命令前加 `sudo`。
- **安装缓慢或失败**：确保已配置 npm 国内镜像源；若仍失败，可改用 `pnpm` 安装：
  ```bash
  npm install -g pnpm
  pnpm install -g openclaw@latest
  ```
- **端口占用**：默认端口为 18789。若被占用，可在配置文件 `openclaw.json` 中修改 `port` 字段。
- **安全警告**：OpenClaw 需要文件读写权限。请勿在存有敏感信息的生产环境根目录下运行，建议指定专用工作区。
- **配置未生效**：修改配置文件后，必须执行 `openclaw gateway restart` 重启服务。
- **WebUI 无法访问**：确认服务已启动（`openclaw status`），并检查防火墙设置。若提示需要令牌，使用 `openclaw token generate` 生成。

---

## ✅ 验证部署

完成上述步骤后，可以通过以下方式确认部署成功：
1. 浏览器访问 `http://localhost:18789`，进入 WebUI。
2. 在 WebUI 中尝试执行一个简单任务（如“列出当前目录文件”）。
3. 运行 `openclaw doctor` 确保所有检查项通过。

---

如果你对这些都不甚了解，只想快速的安装部署好龙虾，也可以用【**Claw大龙虾本地部署大师**】来进行快速安装部署好龙虾，然后再结合下面关于配置大模型API的教程就可以。
具体可以看我这篇文章：https://cloud.tencent.com/developer/article/2644262


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

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

这是一份OpenClaw (小龙虾) 本地部署的通用教程，适用于 Windows / macOS / Linux 系统。

人工智能

开发工具

后端

OpenClaw是一款支持Windows/macOS/Linux的AI自动化代理工具，提供本地文件操作、浏览器自动化等功能。本教程详细讲解三系统部署步骤，包括Node.js安装、依赖配置、初始化向导及WebUI访问。推荐8GB内存+20GB存储空间，支持阿里云百炼等大模型API集成，通过openclaw doctor命令可验证部署状态。

包管理器

密钥管理

防火墙

Windows

容器

Ubuntu

Debian

Linux

MacOS

2026采购季 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

OpenClaw是一款支持Windows/macOS/Linux的AI自动化代理工具，提供本地文件操作、浏览器自动化等功能。本教程详细讲解三系统部署步骤，包括Node.js安装、依赖配置、初始化向导及WebUI访问。推荐8GB内存+20GB存储空间，支持阿里云百炼等大模型API集成，通过openclaw doctor命...

OpenClaw（小龙虾）本地部署通用教程（Windows / macOS / Linux）-腾讯云开发者社区-腾讯云

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

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

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐