要将OpenClaw（“龙虾”）部署到本地，需遵循“环境准备→安装配置→模型对接→服务启动”的核心流程，以下是全平台（Windows/MacOS/Linux）保姆级步骤，覆盖新手易踩的坑点（如权限、镜像源、模型配置），确保零基础用户也能顺利部署。

一、前置准备：工具与凭证

在部署前，需准备以下工具与凭证（所有平台通用）：

1. Node.js：OpenClaw的运行环境，需安装v22.x及以上版本（推荐v22.12.0 LTS）。

   • 下载地址：Node.js官网（选择“LTS”版本，勾选“Add to PATH”）。

2. Git（可选）：用于拉取技能插件，推荐安装。

   • 下载地址：Git官网。

3. 大模型API Key（必选）：OpenClaw需对接大模型才能实现“思考”，推荐使用阿里云百炼Coding Plan（新用户可领90天免费额度，约7000万Token），或硅基流动（注册送2000万Token）。

   • 阿里云百炼API Key获取：登录阿里云百炼控制台，进入“密钥管理”创建API Key。

   • 硅基流动API Key获取：登录硅基流动官网，进入“API密钥”页面创建。

二、全平台部署流程

1. Windows系统（推荐：管理员PowerShell）

Windows部署需以管理员身份运行PowerShell，避免权限不足导致的安装失败。

步骤1：安装Node.js与Git​

• 下载Node.js LTS版本（如v22.12.0），双击安装包，勾选“Add to PATH”，默认下一步完成安装。

• 下载Git，双击安装包，勾选“Use Windows’ default console window”，默认下一步完成安装。

步骤2：验证环境​

打开管理员PowerShell（右键“Windows PowerShell”→“以管理员身份运行”），执行以下命令：

node -v  # 需显示v22.x.x（如v22.12.0）
npm -v   # 需显示10.x.x（如10.5.0）
git --version  # 需显示2.x.x（如2.43.0）

若未显示版本号，需检查Node.js是否添加到PATH（可重新安装并勾选“Add to PATH”）。

步骤3：安装OpenClaw​

在管理员PowerShell中执行以下命令（使用国内镜像源加速）：

# 配置npm国内镜像（解决下载超时）
npm config set registry https://registry.npmmirror.com
# 全局安装OpenClaw最新版
npm install -g openclaw@latest

安装完成后，执行openclaw --version，若显示版本号（如OpenClaw 2026.3.8），说明安装成功。

步骤4：初始化配置​

执行以下命令启动交互式配置向导：

openclaw onboard

按以下提示完成配置（新手直接默认选择）：

• 安全警告：输入Yes（了解风险）。

• 配置模式：选择QuickStart（快速开始）。

• 模型选择：选择Skip for now（稍后配置模型）。

• 通讯渠道：选择Skip for now（稍后配置飞书/Telegram等）。

• 技能配置：选择No（后续按需安装）。

• 交互方式：选择Open the Web UI（打开Web控制台）。

配置完成后，OpenClaw会自动启动，浏览器会打开http://localhost:18789（需输入配置时生成的Token，如test123）。

2. MacOS系统（推荐：终端）

MacOS部署需安装Homebrew（包管理器），以简化依赖安装。

步骤1：安装Homebrew​

打开终端（Command+空格输入“终端”），执行以下命令：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装完成后，执行brew --version，若显示版本号（如Homebrew 4.2.0），说明安装成功。

步骤2：安装Node.js与Git​

执行以下命令：

brew install node@22 git

安装完成后，执行node -v与git --version，验证版本号。

步骤3：安装OpenClaw​

执行以下命令（使用国内镜像源加速）：

# 配置npm国内镜像
npm config set registry https://registry.npmmirror.com
# 全局安装OpenClaw最新版
npm install -g openclaw@latest

若安装失败（如sharp依赖错误），执行以下命令修复：

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

安装完成后，执行openclaw --version，验证版本号。

步骤4：初始化配置​

执行openclaw onboard，按提示完成配置（同Windows步骤4），配置完成后浏览器会打开http://localhost:18789。

3. Linux系统（推荐：Ubuntu 22.04+）

Linux部署需更新系统依赖，并使用sudo获取权限。

步骤1：更新系统依赖​

打开终端，执行以下命令：

sudo apt update && sudo apt upgrade -y

步骤2：安装Node.js与Git​

执行以下命令：

# 添加Node.js 22源
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
# 安装Node.js与Git
sudo apt install -y nodejs git

安装完成后，执行node -v与git --version，验证版本号。

步骤3：安装OpenClaw​

执行以下命令（使用国内镜像源加速）：

# 配置npm国内镜像
npm config set registry https://registry.npmmirror.com
# 全局安装OpenClaw最新版（使用sudo避免权限问题）
sudo npm install -g openclaw@latest

安装完成后，执行openclaw --version，验证版本号。

步骤4：初始化配置​

执行openclaw onboard，按提示完成配置（同Windows步骤4），配置完成后浏览器会打开http://localhost:18789。

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

OpenClaw需对接大模型才能实现“自然语言理解”，以下是阿里云百炼API配置步骤（全平台通用）：

步骤1：获取阿里云百炼API Key​

• 登录阿里云百炼控制台，进入“密钥管理”页面，点击“创建API Key”，复制生成的API Key（格式为sk-sp-xxxxx）。

步骤2：配置OpenClaw模型​

• 打开OpenClaw的Web控制台（http://localhost:18789），进入“配置”→“RAW”（或编辑~/.openclaw/openclaw.json文件）。

• 替换models部分为以下配置（替换为你的API Key）：

  "models": {
    "mode": "merge",
    "providers": {
      "bailian": {
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "apiKey": "你的阿里云百炼API Key",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3.5-plus",
            "name": "百炼Qwen3.5（免费版）",
            "contextWindow": 32768,
            "maxTokens": 2048,
            "reasoning": false
          }
        ],
        "timeout": 30000,
        "maxRetries": 2
      }
    },
    "default": "bailian/qwen3.5-plus"
  },

• 点击“Save”保存配置，重启OpenClaw服务（执行openclaw gateway restart）。

步骤3：验证模型配置​

在OpenClaw的Web控制台发送测试指令（如“帮我总结OpenClaw的核心模块与优势”），若能正常生成结构化回答，说明模型配置成功。

四、启动服务与验证

步骤1：启动OpenClaw服务​

• 执行以下命令启动网关（全平台通用）：

  openclaw gateway start

• 若要后台运行（避免终端关闭后服务停止），执行：

  • Windows：start /b openclaw gateway start（或使用PowerShell的nohup）。

  • MacOS/Linux：nohup openclaw gateway start > ~/.openclaw/logs/gateway.log 2>&1 &。

步骤2：验证服务状态​

• 执行openclaw gateway status，若显示“running”，说明服务正常。

• 浏览器访问http://localhost:18789，若能打开OpenClaw控制台，说明部署成功。

五、常见问题解决

1. 安装时npm install失败：

   • 原因：Node.js版本过低（需v22+）。

   • 解决：重新安装Node.js v22+，或使用fnm（Node版本管理器）切换版本。

2. MacOS安装时sharp依赖错误：

   • 原因：sharp库需要libvips依赖。

   • 解决：执行brew install vips，再重新安装OpenClaw。

3. 模型调用失败：

   • 原因：API Key错误、Base URL错误或模型名拼写错误。

   • 解决：检查openclaw.json中的apiKey、baseUrl与model.id，确保与阿里云百炼控制台一致。

4. 服务无法启动：

   • 原因：端口被占用（默认18789）。

   • 解决：执行lsof -i :18789（MacOS/Linux）或netstat -ano | findstr :18789（Windows），找到占用端口的进程并杀死，或修改OpenClaw端口（编辑openclaw.json中的gateway.bind为0.0.0.0:3000）。

六、总结

OpenClaw本地部署的核心流程是“环境准备→安装配置→模型对接→服务启动”，关键在于使用正确的Node.js版本、配置国内镜像源、正确对接大模型API。通过以上步骤，新手可在10-30分钟内完成部署，实现“自然语言指令驱动的全流程自动化”（如文件整理、代码生成、邮件处理）。

若需更高级的功能（如团队协作、7×24小时运行），可考虑阿里云部署（参考阿里云OpenClaw一键部署专题页面），但本地部署仍是隐私性与功能性最优的选择。