2026年OpenClaw（阿里云+Windows/Mac/Linux）保姆级部署步骤+ 免费大模型配置指南

2026年，AI领域的核心变革已从“生成内容”转向“落地执行”——OpenClaw（前身为Clawdbot/Moltbot）作为开源AI自动化代理引擎的领军者，凭借“本地优先、强执行能力、多端适配”的核心优势，成为个人与企业构建“自托管式数字员工”的首选工具。截至2026年3月，其GitHub星标已突破28万，社区贡献者超378人，技能生态覆盖办公、开发、生活等全场景，真正实现了从“对话式建议”到“自动化执行”的跨越。

与传统对话式AI（如ChatGPT、Claude）不同，OpenClaw更像一个24小时待命的“数字员工”：它能直接读写文件、控制浏览器、执行脚本、对接API，甚至通过飞书、钉钉、Telegram等20多种渠道接收指令，完成从“意图解析→任务规划→工具调用→结果反馈”的全闭环。本文基于2026年OpenClaw最新稳定版（v2026.3.8），整合官方规范与实战经验，从零拆解全流程：先详解阿里云+本地（Windows11/MacOS/Linux）的三种部署方案（一键脚本、Docker容器、源码部署），再配置阿里云百炼Coding Plan免费API激活“智能大脑”，最后落地高频实战场景与安全运维建议，所有代码可直接复制执行，全程保姆级指导，助力用户1-2小时内搭建专属AI自动化引擎。阿里云上OpenClaw极速一键部署最简单，步骤详情 访问阿里云OpenClaw一键部署专题页面 了解。

一、核心认知：OpenClaw到底是什么？为什么值得用？

（一）OpenClaw的核心定义与定位

OpenClaw是一款遵循MIT协议的开源、本地优先的AI自动化代理引擎，它以自然语言指令为驱动，在本地或私有云环境中完成各类真实任务，是面向个人与企业的自托管式“数字员工”。其核心价值在于打破了传统AI“只说不做”的局限，通过模块化架构与插件生态，实现了“任务执行”的核心目标。

（二）五大核心特性，重构AI自动化体验

（三）与传统工具的核心区别

很多人会混淆OpenClaw与其他AI或自动化工具，其实核心差异在于“任务统筹与执行能力”：

• 传统大模型（ChatGPT/千问）：像“顾问”，能解答问题、生成内容，但不会主动执行任务；
• 普通自动化工具（n8n/Zapier）：像“工具人”，需手动配置流程，AI原生程度低；
• OpenClaw：像“全能员工”，能理解自然语言指令、自动拆解任务、调用工具，全程无需人工干预。

（四）部署前必做准备（避免踩坑，一次成功）

1. 设备与环境要求

无论是云端还是本地部署，内存是核心硬性要求，低于4GB会导致服务启动失败，各部署方式的具体要求如下：

2. 必备凭证与工具

• 核心凭证：阿里云账号（注册阿里云账号，完成实名认证）、阿里云百炼Coding Plan API Key（格式为sk-sp-xxxxx，访问订阅阿里云百炼Coding Plan，新用户可领90天免费额度）及专属Base URL；
• 辅助工具：SSH远程工具（FinalShell，阿里云部署用）、系统终端（Windows11：PowerShell管理员模式；MacOS/Linux：原生终端）、文本编辑器（VS Code、记事本）、加密记事本（存储敏感凭证）；
• 可选工具：飞书/钉钉/Telegram账号（多渠道控制用）、Ollama（本地模型部署用）。

3. 基础工具安装（全系统通用，必做）

# 1. 安装Node.js（推荐v22+，确保兼容性）
# Windows11（PowerShell，管理员模式）
winget install OpenJS.NodeJS.LTS --version 22.2.0 -y

# MacOS（终端）
brew install node@22
echo 'export PATH="/usr/local/opt/node@22/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# Linux/Ubuntu（终端）
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 2. 验证Node.js版本（显示v22+即为成功）
node -v

# 3. 安装核心工具（Git、pnpm）
# Windows11
winget install Git.Git -y
npm install -g pnpm

# MacOS/Linux
brew install git  # MacOS
sudo apt install git -y  # Linux
npm install -g pnpm

# 4. 安装Docker（容器化部署必备，推荐）
# Windows11：下载Docker Desktop并安装，开启“以管理员身份运行”
# MacOS
brew install docker --cask
open -a Docker

# Linux/Ubuntu
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun
sudo systemctl start docker
sudo systemctl enable docker

# 5. 配置npm国内镜像，加速安装
npm config set registry https://registry.npmmirror.com
pnpm config set registry https://registry.npmmirror.com

# 6. 验证工具安装
git --version && pnpm --version && docker --version

二、2026年OpenClaw全平台部署流程（三种方案，按需选择）

（一）阿里云部署（企业/长期运行首选）

阿里云部署适合需要7×24小时稳定运行、多设备访问、团队共享的场景，依托云服务器的稳定性与弹性，避免本地设备关机、断网导致任务中断，提供三种部署方案，适配不同需求。

阿里云用户零基础部署 OpenClaw 喂饭级步骤流程

第一步：打开访问阿里云OpenClaw一键部署专题页面，找到并点击【一键购买并部署】。

第二步：打开选购阿里云轻量应用服务器，配置参考如下：

• 镜像：OpenClaw(Moltbot)镜像（已经购买服务器的用户可以重置系统重新选择镜像）
• 实例：内存必须2GiB及以上。
• 地域：默认美国（弗吉尼亚），目前中国内地域（除香港）的轻量应用服务器，联网搜索功能受限。
• 时长：根据自己的需求及预算选择。

第三步：打开访问阿里云百炼大模型控制台，找到密钥管理，单击创建API-Key。

前往轻量应用服务器控制台，找到安装好OpenClaw的实例，进入「应用详情」放行18789端口、配置百炼API-Key、执行命令，生成访问OpenClaw的Token。

• 端口放通：需要放通对应端口的防火墙，单击一键放通即可。
• 配置百炼API-Key，单击一键配置，输入百炼的API-Key。单击执行命令，写入API-Key。
• 配置OpenClaw：单击执行命令，生成访问OpenClaw的Token。
• 访问控制页面：单击打开网站页面可进入OpenClaw对话页面。

阿里云百炼Coding Plan 配置教程：创建API-Key，推荐访问订阅阿里云百炼Coding Plan，阿里云百炼Coding Plan每天两场抢购活动，从按tokens计费升级为按次收费，可以进一步节省费用！

• 购买后，在控制台生成API Key。注：这里复制并保存好你的API Key，后面要用。
  
• 回到轻量应用服务器-控制台，单击服务器卡片中的实例 ID，进入服务器概览页。
  
• 在服务器概览页面单击应用详情页签，进入服务器详情页面。
  
• 端口放通在OpenClaw使用步骤区域中，单击端口放通下的执行命令，可开放获取OpenClaw 服务运行端口的防火墙。
  
• 这里系统会列出我们第一步中创建的阿里云百炼 Coding Plan的API Key，直接选择就可以。
  
• 获取访问地址单击访问 Web UI 面板下的执行命令，获取 OpenClaw WebUI 的地址。
  
  

方案一：一键脚本部署（新手首选，5分钟完成）

适配阿里云轻量应用服务器特性，脚本自动优化系统配置、安装依赖并启动服务，无需手动干预，新手快速上手。

1. 服务器选购与基础配置：

   • 访问阿里云轻量应用服务器控制台，选择“Ubuntu 22.04 LTS”系统镜像；
   • 核心配置：2vCPU+4GiB内存+40GiB ESSD+200Mbps带宽，地域优先选择中国香港（免备案）或华东1（杭州）；
   • 提交订单后，记录服务器公网IP、默认登录账号（root）与密码，在控制台放行22（SSH）、80（HTTP）、443（HTTPS）、18789（OpenClaw网关）端口。

2. 一键部署操作：

# 1. SSH连接服务器（替换为你的公网IP）
ssh root@你的服务器公网IP

# 2. 执行阿里云专属一键部署脚本（国内优化版）
curl -fsSL https://openclaw.ai/aliyun-install.sh | bash

# 3. 按向导完成核心配置（新手直接按默认选择）
# 关键步骤：
# 1. 网关模式：选择remote（支持远程访问）
# 2. 绑定地址：0.0.0.0:18789
# 3. 模型选择：暂时选择“Custom Provider”（后续配置百炼API）
# 4. 认证设置：自动生成访问令牌，复制保存（登录WebUI用）

# 4. 验证部署与开机自启
systemctl status openclaw  # 显示active(running)即为成功
systemctl enable openclaw  # 设置开机自启
curl http://127.0.0.1:18789/api/v1/health  # 返回healthy即为正常

1. 远程访问：浏览器输入 http://服务器公网IP:18789，粘贴访问令牌，进入Web控制台。

方案二：Docker Compose部署（生产环境首选，稳定隔离）

遵循容器化部署最佳实践，通过Docker Compose实现环境隔离、数据持久化与快速升级，适配企业级生产需求。

1. 基础环境配置：

# 1. SSH连接服务器
ssh root@你的服务器公网IP

# 2. 安装Docker与Docker Compose
sudo apt update && sudo apt upgrade -y
curl -fsSL https://get.docker.com | bash
sudo apt install docker-compose-plugin -y
sudo systemctl start docker && sudo systemctl enable docker

# 3. 验证安装
docker --version && docker compose version

1. 创建配置与启动服务：

# 1. 创建项目目录
mkdir -p /opt/openclaw && cd /opt/openclaw

# 2. 编写docker-compose.yml文件
cat > docker-compose.yml << EOF
version: "3.8"
services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw
    ports:
      - "18789:18789"
    volumes:
      - openclaw-data:/root/.openclaw
      - /var/log/openclaw:/var/log/openclaw  # 日志持久化
    restart: unless-stopped
    command: ["openclaw", "gateway", "run"]
    network_mode: bridge
    environment:
      - TZ=Asia/Shanghai
      - GATEWAY_MODE=remote
      - GATEWAY_BIND=0.0.0.0:18789
volumes:
  openclaw-data:
EOF

# 3. 启动容器
docker compose up -d

# 4. 初始化配置（设置访问令牌）
docker compose exec openclaw openclaw config set gateway.auth.token "你的高强度令牌"

# 5. 查看日志，确认启动成功
docker compose logs -f

1. 安全加固：在阿里云控制台将18789端口访问来源限制为企业内网IP或个人常用IP，提升安全性。

方案三：源码部署（开发者首选，支持二次开发）

适用于需要自定义插件、二次开发的技术团队，结合阿里云Git镜像加速，提升开发效率。

1. 安装基础开发环境：

# 1. SSH连接服务器
ssh root@你的服务器公网IP

# 2. 安装Git、Node.js、pnpm
sudo apt install git -y
curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
sudo apt install nodejs -y
npm install -g pnpm

1. 克隆仓库与启动服务：

# 1. 克隆OpenClaw仓库（国内镜像加速）
git clone https://gitee.com/openclaw/openclaw.git
cd openclaw

# 2. 安装项目依赖
pnpm install

# 3. 构建UI与核心代码
pnpm ui:build && pnpm build

# 4. 初始化配置
node dist/cli.js onboard

# 5. 启动网关服务（绑定所有网卡）
node dist/cli.js gateway run --bind 0.0.0.0:18789

# 6. 配置进程守护（PM2）
npm install -g pm2
pm2 start dist/cli.js --name openclaw -- gateway run --bind 0.0.0.0:18789
pm2 startup && pm2 save

（二）本地部署（Windows11+MacOS+Linux，适合测试与隐私需求）

1. Windows11本地部署（兼容适配，新手易上手）

# 1. 管理员模式打开PowerShell，解决执行策略限制
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force

# 2. 安装核心依赖（Git、Python、Docker）
winget install Git.Git -y
winget install Python.Python.3.10 -y
# Docker需手动下载安装：https://www.docker.com/products/docker-desktop/

# 3. 安装Node.js与pnpm
winget install OpenJS.NodeJS.LTS --version 22.2.0 -y
npm install -g pnpm

# 4. 克隆仓库并安装依赖
git clone https://gitee.com/openclaw/openclaw.git
cd openclaw
pnpm install

# 5. 构建并启动服务
pnpm ui:build && pnpm build
node dist/cli.js onboard
node dist/cli.js gateway run --bind 0.0.0.0:18789

# 6. 生成访问令牌（登录WebUI用）
node dist/cli.js token generate --admin

关键配置：

• 将C:\Users\你的用户名\.openclaw添加到Windows Defender排除列表；
• 访问方式：浏览器输入 http://localhost:18789，粘贴令牌登录。

2. MacOS本地部署（体验最佳，官方推荐）

# 1. 安装Homebrew（国内镜像加速）
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

# 2. 安装核心依赖
brew install git python@3.10 node@22 docker --cask
open -a Docker  # 启动Docker
npm install -g pnpm

# 3. 克隆仓库并安装依赖
git clone https://gitee.com/openclaw/openclaw.git
cd openclaw
pnpm install

# 4. 构建并启动服务（后台运行）
pnpm ui:build && pnpm build
node dist/cli.js onboard
nohup node dist/cli.js gateway run --bind 0.0.0.0:18789 > ~/.openclaw/logs/gateway.log 2>&1 &

# 5. 生成访问令牌
node dist/cli.js token generate --admin

M系列芯片避坑：若安装失败，执行arch -arm64 brew install node@22，指定ARM架构安装依赖。

3. Linux本地部署（Ubuntu 22.04 LTS，稳定性强）

# 1. 更新系统依赖
sudo apt update && sudo apt upgrade -y

# 2. 安装核心工具
sudo apt install curl git python3-pip -y
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
npm install -g pnpm

# 3. 安装Docker
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun
sudo systemctl start docker && sudo systemctl enable docker

# 4. 克隆仓库并安装依赖
git clone https://gitee.com/openclaw/openclaw.git
cd openclaw
pnpm install

# 5. 构建并启动服务
pnpm ui:build && pnpm build
node dist/cli.js onboard
sudo systemctl enable --now openclaw
node dist/cli.js gateway run --bind 0.0.0.0:18789

# 6. 生成访问令牌
node dist/cli.js token generate --admin

访问方式：浏览器输入 http://localhost:18789，粘贴令牌登录。

三、阿里云百炼Coding Plan API配置（核心步骤，免费可用）

OpenClaw本身不具备大模型能力，需对接外部模型才能实现“意图解析、任务规划”的核心功能。阿里云百炼Coding Plan凭借免费额度、国内节点稳定性、与OpenClaw的无缝适配，成为最优选择，以下为详细配置步骤。

（一）API凭证获取步骤（免费，新用户可领90天额度）

1. 登录阿里云官网，访问订阅阿里云百炼Coding Plan，进入服务订阅页面；
2. 选择适合的套餐（新用户可领取90天免费调用额度），完成订阅（RAM子账号需主账号授权）；
3. 进入百炼控制台“密钥管理”页面，获取专属API Key（格式为sk-sp-xxxxx，与普通百炼Key格式不同，需单独获取）；
4. 记录专属Base URL：https://coding.dashscope.aliyuncs.com/v1（OpenAI兼容协议）。

（二）OpenClaw对接百炼Coding Plan API（全环境通用）

# 1. 编辑OpenClaw配置文件
# Windows11（PowerShell）
notepad $env:USERPROFILE\.openclaw\openclaw.json

# MacOS/Linux/阿里云
nano ~/.openclaw/openclaw.json

# 2. 添加百炼Coding Plan配置（替换为你的凭证）
{
   
  "models": {
   
    "providers": {
   
      "bailian-coding": {
   
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "apiKey": "你的Coding Plan API Key",
        "api": "openai-completions",
        "models": [
          {
   
            "id": "qwen3.5-coding",
            "name": "百炼Coding Plan Qwen3.5",
            "contextWindow": 32768,
            "maxTokens": 4096,
            "reasoning": false  // 国内模型必设，否则回复为空
          }
        ]
      }
    },
    "default": "bailian-coding/qwen3.5-coding"
  },
  "tools": {
   
    "agentCommunication": {
   
      "enabled": true,
      "allowCrossAgent": true
    }
  }
}

# 3. 保存文件后重启网关生效
# 阿里云/Linux
openclaw gateway restart  # 脚本/源码部署
docker compose restart openclaw  # Docker部署

# MacOS
pkill -f openclaw && nohup node dist/cli.js gateway run --bind 0.0.0.0:18789 > ~/.openclaw/logs/gateway.log 2>&1 &

# Windows11（PowerShell）
Stop-Process -Name node -Force
node dist/cli.js gateway run --bind 0.0.0.0:18789

（三）API配置验证与避坑要点

1. 验证方法：在OpenClaw Web控制台输入“帮我整理本周下载文件夹的文件，按类型分类”，若返回“任务已执行，已创建文档、图片、视频等分类文件夹”，即为配置成功；
2. 避坑要点：
   • 凭证混用：Coding Plan API Key前缀为sk-sp-，与普通百炼Key不同，混用会导致鉴权失败；
   • 接口地址错误：必须使用专属Base URL，否则无法抵扣免费额度；
   • 未设置reasoning：国内模型需添加"reasoning": false，否则回复为空；
   • 配置不生效：修改后必须重启网关，Docker部署需重启容器。

四、实战场景：让OpenClaw立刻干活（落地即用）

部署与配置完成后，通过以下高频场景实战，快速感受OpenClaw的自动化价值，所有指令可直接在WebUI或IM平台发送。

（一）场景1：系统级操作——文件自动整理

# 1. 安装文件管理技能
pnpm add @openclaw/skill-file-manager

# 2. 发送自然语言指令（WebUI/IM平台）
“帮我整理~/Downloads文件夹的所有文件，按类型（文档、图片、视频、安装包）创建子文件夹，将对应文件移动到各文件夹，删除空文件夹”

# 3. 查看执行结果
# 指令执行后，OpenClaw会返回整理报告，包含各文件夹文件数量与名称

（二）场景2：办公自动化——会议纪要生成与邮件发送

# 1. 安装办公技能
pnpm add @openclaw/skill-office-automation @openclaw/skill-email

# 2. 发送指令
“将以下会议记录整理为结构化纪要（包含参会人、讨论内容、行动项、截止日期），生成Markdown文件并发送到team@example.com邮箱：
参会人：张三、李四、王五
讨论内容：1. OpenClaw部署进度：完成80% 2. 下周计划：完成测试与上线 3. 问题：服务器资源不足
行动项：张三负责测试（周五前），李四协调服务器（周三前）”

# 3. 执行结果
# 自动生成规范纪要，保存到本地并发送邮件，返回邮件发送成功回执

（三）场景3：浏览器自动化——网页数据抓取

# 1. 安装浏览器自动化技能
pnpm add @openclaw/skill-puppeteer

# 2. 发送指令
“帮我抓取某电商平台手机销量前10的产品数据（品牌、型号、价格、销量），整理为Excel文件，保存到~/Documents/电商数据.xlsx”

# 3. 执行结果
# 自动启动浏览器，抓取数据并生成Excel，返回文件路径

（四）场景4：多渠道控制——飞书远程指挥

# 1. 安装飞书集成技能
pnpm add @openclaw/skill-feishu

# 2. 配置飞书凭证
openclaw config set skills.feishu.appId "你的飞书App ID"
openclaw config set skills.feishu.appSecret "你的飞书App Secret"

# 3. 重启网关生效
openclaw gateway restart

# 4. 飞书发送指令
# 在飞书群@OpenClaw机器人，发送“帮我查看服务器当前CPU使用率，生成简易报告”，机器人自动执行并返回结果

五、安全与运维建议（企业级规范）

（一）安全加固措施

1. 权限最小化：以非root账号运行OpenClaw服务，限制文件系统访问范围，仅授权必要目录；
2. 端口防护：公网部署时，限制18789端口访问来源，优先通过VPN/SSH隧道访问；
3. 凭证保护：敏感凭证（API Key、密码）存储在环境变量或加密文件，避免明文写入配置；
4. 定期更新：通过Docker镜像更新或源码拉取，及时修复安全漏洞，保持版本最新。

（二）数据备份策略

# 1. 手动备份（全环境通用）
# 备份配置与数据目录
cp -r ~/.openclaw ~/.openclaw-backup-$(date +%Y%m%d)

# 2. 定时备份（Linux/MacOS/阿里云）
# 添加定时任务，每周日晚10点自动备份
crontab -e
# 添加以下内容
0 22 * * 0 cp -r ~/.openclaw ~/.openclaw-backup-$(date +%Y%m%d)

（三）日志审计

# 查看OpenClaw运行日志
# 脚本/源码部署
tail -f ~/.openclaw/logs/gateway.log

# Docker部署
docker compose logs -f openclaw

# 筛选执行日志
grep "task executed" ~/.openclaw/logs/gateway.log  # 查看所有执行成功的任务

六、新手高频问题解答（避坑指南）

（一）部署类问题

1. 问题1：OpenClaw启动提示“Node.js版本过低”？

   • 解决方案：执行node -v验证，确保≥22.0.0；Linux/MacOS用sudo npm install -g n && sudo n 22.2.0升级，Windows重新安装Node.js。

2. 问题2：端口无法访问，提示“连接超时”？

   • 解决方案：① 检查服务器安全组/防火墙是否放行18789端口；② 确认网关绑定地址为0.0.0.0:18789；③ 验证服务是否正常运行（systemctl status openclaw）。

3. 问题3：Docker部署后，容器启动失败？

   • 原因：端口被占用或挂载目录权限不足；
   • 解决方案：① 检查18789端口是否被占用（lsof -i:18789），终止占用进程；② 赋予挂载目录权限（sudo chmod -R 775 /opt/openclaw）；③ 查看日志（docker compose logs -f）排查具体报错。

（二）API与技能类问题

1. 问题1：百炼API调用提示“额度不足”？

   • 解决方案：① 登录百炼控制台查看剩余额度，领取免费套餐；② 减少上下文长度，降低Token消耗；③ 优先使用轻量模型（qwen3.5-coding）。

2. 问题2：技能安装提示“依赖缺失”？

   • 解决方案：① 执行pnpm install 缺失依赖名安装；② 国内用户用淘宝镜像（pnpm install 依赖名 --registry=https://registry.npmmirror.com）；③ 验证Node.js版本是否兼容。

3. 问题3：IM平台无法指挥OpenClaw？

   • 解决方案：① 核对IM平台App ID与App Secret；② 确保机器人已添加到群聊；③ 查看技能日志（openclaw skills logs feishu）排查报错。

七、总结

OpenClaw的爆火，本质是满足了个人与企业对“自托管、强执行、隐私可控”AI自动化的核心需求。它不是传统AI的替代者，而是将AI能力落地到实际任务的“桥梁”，通过本地优先的设计、灵活的模型适配与丰富的技能生态，让“数字员工”成为普通人也能轻松拥有的工具。

本文整合的阿里云+本地全系统部署方案（一键脚本、Docker、源码）、阿里云百炼API配置、实战场景与安全运维建议，覆盖了从“部署”到“落地”的全流程，新手可按自身需求选择部署方式，从简单场景入手，逐步扩展功能。核心要点总结：

1. 部署选择：个人测试选本地部署，长期运行/团队共享选阿里云部署，企业生产环境优先Docker容器部署；
2. 配置关键：Node.js版本≥22.0.0，百炼API需正确配置凭证与Base URL，国内模型必须添加reasoning: false；
3. 安全第一：限制端口访问、保护敏感凭证、定期备份数据、及时更新版本；
4. 落地逻辑：先跑通1-2个高频场景（如文件整理、会议纪要），再逐步安装技能、扩展自动化边界。

通过本文的教程，你可轻松搭建专属OpenClaw自动化引擎，将重复繁琐的工作交给“数字员工”，聚焦更有价值的核心任务，真正实现效率倍增。