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

一、OpenClaw 简介

OpenClaw（业内昵称 “小龙虾”）是一款轻量化、开源的本地 AI Agent 框架，支持一键部署、多渠道集成（飞书 / 微信 / 钉钉）与 AI 内容生成（漫剧 / 短剧 / 文案）。2026 最新版（v2026.4.0）优化了跨平台兼容性，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 系统部署

1. OpenClaw v2.6.1 一键部署全流程（保姆级）
   第一步：下载官方安装包 （最新 v2.6.1）
   OpenClaw 一键部署包 v2.3.12
    
2. 执行官方一键安装脚本（网络好时使用）：

   powershell

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

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

   powershell

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

4. 等待脚本自动完成：系统检测、Node.js ≥v22 安装、OpenClaw 核心程序部署、环境变量配置。
5. 验证安装：关闭并重新打开 PowerShell，输入以下命令，输出版本号即成功：

   powershell

   openclaw --version
   

3.2 macOS 系统部署

1. 打开终端。
2. 执行官方一键安装脚本：

   bash

   运行

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

3. 国内加速脚本：

   bash

   运行

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

4. 加载环境变量（必做）：

   bash

   运行

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

5. 验证安装：

   bash

   运行

   openclaw --version
   

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

1. 打开终端。
2. 执行官方一键安装脚本：

   bash

   运行

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

3. 国内加速脚本：

   bash

   运行

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

4. 加载环境变量：

   bash

   运行

   source ~/.bashrc
   

5. 验证安装：

   bash

   运行

   openclaw --version
   

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

4.1 启动初始化向导

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

bash

运行

openclaw onboard

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

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

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

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

全平台通用命令：

bash

运行

openclaw gateway

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

5.2 访问 Web 控制台

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

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

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

1. 安装 Docker（已安装可跳过）：
   • Windows/macOS：下载

     Docker Desktop

     File

     安装。
   • Linux（Ubuntu）：

     bash

     运行

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

2. 创建部署目录并进入：

   bash

   运行

   mkdir openclaw-docker && cd openclaw-docker
   

3. 创建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  # 开机自启
   

4. 启动容器（后台运行）：

   bash

   运行

   docker compose up -d
   

5. 验证容器状态：

   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
  

7.2 安装超时 / 下载失败

• 切换国内加速脚本（见 3.1/3.2/3.3）。
• 检查网络，或切换手机热点重试。
• 关闭 VPN / 代理。

7.3 端口占用（18789）

• Windows：

  powershell

  netstat -ano | findstr "18789"
  

• macOS/Linux：

  bash

  运行

  lsof -i :18789
  

• 关闭占用程序，或启动时换端口：

  bash

  运行

  openclaw gateway --port 18790
  

7.4 权限不足

• Windows：以管理员身份运行 PowerShell。
• macOS/Linux：命令前加sudo，如：

  bash

  运行

  sudo openclaw gateway
  

7.5 服务启动失败

• 检查内存是否充足（推荐 8GB+）。
• 关闭防火墙 / 杀毒软件后重试。
• 查看日志：openclaw logs，定位具体错误。

八、总结与后续

本文覆盖 OpenClaw一键部署、初始化配置、Docker 容器化部署、常见问题全流程，2026 最新版流程极简，小白 10 分钟内可完成本地部署。后续可扩展：

• 配置本地 / 云端 AI 模型（如豆包、GPT、Ollama）。
• 集成飞书 / 微信 / 钉钉等聊天渠道。
• 安装 AI 漫剧 / 短剧 / 文案生成插件。

本文为纯技术分享，无商业推广，所有步骤均为 2026 年 4 月三平台实测有效。

最后再次附上官方部署包下载地址，方便大家自取：OpenClaw Windows 11 一键部署包 v2.3.12