OpenClaw（小龙虾）2.6.6 本地部署｜Windows/Mac/Linux 全平台教程

崔总知道

347人浏览 · 2026-05-06 11:01:01

崔总知道 · 2026-05-06 11:01:01 发布

OpenClaw（小龙虾）本地部署保姆级全教程｜Windows/Mac/Linux 三平台全覆盖

本文覆盖 Windows、macOS、Linux 三大系统，从环境准备、一键安装、初始化配置到服务启动、常见问题，全程无夸大、无违规表述，小白按步骤即可完成本地部署。

一、OpenClaw 简介

OpenClaw（业内昵称 “小龙虾”）是一款轻量化、开源的本地 AI Agent 框架，支持一键部署、多渠道集成（飞书 / 微信 / 钉钉）与 AI 内容生成（漫剧 / 短剧 / 文案）。最新版（v2.6.6）优化了跨平台兼容性，Windows、macOS、Linux 均可一键部署，小白也能快速搭建本地 AI 服务。

二、部署前准备（全平台通用）

2.1 系统与硬件要求

表格

项目	最低配置	推荐配置
操作系统	Windows 10+/macOS 12+/Ubuntu 22.04+	同左
处理器	x86_64/Apple Silicon（M1/M2/M3/M4）	同左
内存	≥4GB	8GB+，运行更流畅
存储	可用空间≥2GB	10GB+，预留模型空间
网络	稳定联网	带宽≥10Mbps，加速依赖下载
权限	Windows 需管理员权限；Mac/Linux 需 sudo 权限	同左

2.2 工具准备

Windows：以管理员身份打开 PowerShell（开始菜单搜索 PowerShell，右键选择 “以管理员身份运行”）
macOS/Linux：打开终端（macOS：启动台→其他→终端；Linux：Ctrl+Alt+T）
关闭防火墙 / 杀毒软件：避免拦截安装脚本与服务启动
路径规范：后续所有操作路径禁止中文、空格、特殊符号，推荐纯英文路径

三、一键部署（新手首选，5 分钟搞定）

3.1 Windows 系统部署

第一步：下载安装包（最新 v2.6.6）安装包大小：50.2MB

执行一键安装脚本（网络好时使用）：

powershell

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

国内网络下载缓慢，可使用国内加速脚本：

powershell

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

脚本自动完成：系统检测、Node.js ≥v22 安装、OpenClaw 核心程序部署、环境变量配置。

验证安装：关闭并重新打开 PowerShell，输入以下命令，输出版本号即成功：

powershell

openclaw --version

3.2 macOS 系统部署

打开终端，执行一键安装脚本：

bash

运行

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

国内加速脚本：

bash

运行

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

加载环境变量（必做）：

bash

运行

source ~/.zshrc  # Zsh终端（默认）
# source ~/.bash_profile  # Bash终端（老版本）

验证安装：

bash

运行

openclaw --version

3.3 Linux 系统部署（以 Ubuntu 为例）

打开终端，执行一键安装脚本：

bash

运行

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

国内加速脚本：

bash

运行

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

加载环境变量：

bash

运行

source ~/.bashrc

验证安装：

bash

运行

openclaw --version

四、初始化配置（3 分钟完成）

4.1 启动初始化向导

全平台通用命令，进入文字交互配置界面：

bash

运行

openclaw onboard

4.2 按提示配置（新手直接默认回车）

Security warning：输入 Yes 并回车（个人使用默认安全）
Onboarding mode：选择 QuickStart（快速启动）
Gateway port：默认 18789，直接回车（可自定义端口）
Model/auth provider：新手选 Skip for now，后续再配置 AI 模型
设置管理员密码：输入并确认密码（务必记录，登录控制台使用）

五、启动服务与访问控制台

5.1 启动网关服务（保持终端运行）

全平台通用命令：

bash

运行

openclaw gateway

终端显示「Gateway started on port 18789」即启动成功。

5.2 访问 Web 控制台

浏览器访问 http://localhost:18789，输入管理员密码即可登录使用。

六、Docker 容器化部署（进阶，环境隔离）

适合多服务并行、生产环境部署，不污染本地系统。

安装 Docker（已安装可跳过）

Windows/macOS：下载 Docker Desktop 安装

Linux（Ubuntu）：

bash

运行

sudo apt update && sudo apt install docker.io docker-compose -y
sudo systemctl start docker && sudo systemctl enable docker

bash

运行

mkdir openclaw-docker && cd openclaw-docker

创建 docker-compose.yml 配置文件：

yaml

version: '3.8'
services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw
    ports:
      - "18789:18789"
    volumes:
      - ~/.openclaw:/root/.openclaw
    restart: always

启动容器（后台运行）：

bash

运行

docker compose up -d

验证容器状态：

bash

运行

docker compose ps

显示 Up 即为成功，访问 http://localhost:18789 即可。

七、常见问题解决（全平台通用）

7.1 命令找不到（command not found）

Windows：关闭并重新打开 PowerShell

macOS/Linux：执行以下命令配置环境变量

bash

运行

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc  # macOS
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc  # Linux
source ~/.zshrc  # macOS
source ~/.bashrc  # Linux