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

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

2.1 系统与硬件要求

表格

2.2 工具准备

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

3.1 Windows 系统部署

1. OpenClaw v2.6.1 一键部署全流程（保姆级）
   第一步：下载官方安装包 （最新 v2.6.1）
   
    
   
   
   
   
   
   
   
   
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终端（老版本）

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 

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，输入管理员密码即可登录使用。

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

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 # 开机自启 

docker compose up -d 

docker compose ps 

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.¹⁄₃.²⁄₃.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