🦞 OpenClaw（小龙虾）2026 最新全平台保姆级安装教程

一、安装前必看（前置要求）

二、macOS 系统图文安装教程（全程 5 分钟）

步骤 1：打开终端（Terminal）

1. 按下键盘 Command + 空格 打开 Spotlight 搜索
2. 搜索框输入「终端」或「Terminal」，按下回车打开
3. 打开后看到命令行窗口，即为操作终端

步骤 2：执行一键安装脚本

1. 复制对应脚本（二选一，国内用户优先选加速版）
   • 官方原版（网络通畅 / 海外用户）：
     bash

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

   • 国内加速版（下载慢 / 超时优先用）：
     bash

     curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
     
2. 将命令粘贴到终端，按下回车键执行
3. 若提示 Password:，输入 Mac 开机密码（输入时不显示字符，输完直接回车即可）
4. 等待脚本自动执行，全程 3-8 分钟，期间不要关闭终端、不要断网

步骤 3：验证安装成功

1. 脚本执行完毕，终端出现 ✓ OpenClaw installed successfully! 字样，即为安装完成
2. 继续在终端输入以下命令，按下回车：
   bash

   openclaw --version
   

3. 终端输出版本号（如 2026.3.30），说明安装成功

步骤 4：初始化配置向导（绑定 AI 大脑）

1. 终端输入以下命令，启动配置向导：
   bash

   openclaw onboard
   

   • 安全提示：按键盘左右键选择 Yes，回车确认
   • 配置模式：选择 QuickStart（快速启动），回车确认
   • 网关端口：默认 18789，直接回车即可
   • 模型提供商：按上下键选择 AI 平台（推荐火山引擎豆包 / DeepSeek）
   • 模型认证：选择 Paste API key now，粘贴提前获取的 API Key，回车确认
   • 默认模型：选择对应平台的主力模型（如豆包选 ark/doubao-seed-2-0-pro），回车确认
   • 聊天渠道 / 技能配置：新手直接选择跳过 / No，回车完成配置按向导提示操作（新手全程按推荐选择即可）

步骤 5：启动服务 & 打开控制面板

1. 配置完成后，终端输入以下命令启动核心服务：
   bash

   openclaw gateway start
   

2. 服务启动后，会自动在默认浏览器打开控制面板；若未自动跳转，手动在浏览器访问：
   已生成代码
3. 看到 OpenClaw 的 Web 聊天界面，即为全部安装配置完成，可以开始使用了

三、Windows 系统图文安装教程（全程 8 分钟）

步骤 1：以管理员身份打开 PowerShell

1. 点击左下角「开始菜单」，搜索框输入 PowerShell
2. 右键搜索结果中的「Windows PowerShell」，选择「以管理员身份运行」
3. 弹出「用户账户控制」提示，点击「是」，确认窗口标题带「管理员:」字样

步骤 2：解锁 PowerShell 脚本执行权限（必做，否则报错）

1. 在管理员 PowerShell 窗口中，复制以下命令粘贴进去，按下回车：
   powershell

   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
   

2. 提示「是否要更改执行策略」时，输入 Y，按下回车确认

步骤 3：执行一键安装脚本

1. 复制对应脚本（二选一，国内用户优先选加速版）
   • 官方原版（网络通畅 / 海外用户）：
     powershell

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

   • 国内加速版（下载慢 / 超时优先用）：
     powershell

     iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex
     
2. 将命令粘贴到管理员 PowerShell 窗口，按下回车键执行
3. 等待脚本自动执行，全程 3-10 分钟，期间不要关闭窗口、不要断网，脚本会自动安装缺失的 Node.js 环境

步骤 4：验证安装成功

1. 脚本执行完毕，出现 ✓ OpenClaw installed successfully! 字样，即为安装完成
2. 继续在 PowerShell 输入以下命令，按下回车：
   powershell

   openclaw --version
   

3. 终端输出版本号，说明安装成功

步骤 5：初始化配置 & 启动服务

1. 输入以下命令启动配置向导，后续操作和 macOS 完全一致：
   powershell

   openclaw onboard
   

2. 配置完成后，输入命令启动网关服务：
   powershell

   openclaw gateway start
   

3. 浏览器自动打开 http://localhost:18789，看到 Web 界面即为安装成功

四、常见问题 & 避坑指南

五、进阶补充（可选）

手动 npm 安装（已有 Node.js 22 + 环境）

# 全局安装最新版OpenClaw
npm install -g openclaw@latest
# 启动初始化向导
openclaw onboard --install-daemon

Docker 部署（环境隔离，技术用户首选）

# 拉取最新镜像
docker pull openclaw/openclaw:latest
# 启动容器（端口映射+数据持久化）
docker run -d --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  openclaw/openclaw:latest