OpenClaw是一款开源免费的AI代理框架，本身不具备独立的大语言模型推理能力，需对接阿里云百炼等大模型平台，通过API-Key获取授权，才能实现自然语言理解与任务自动化执行。其部署的核心逻辑可概括为“三步闭环”：搭建运行环境（服务器/本地设备）→ 安装OpenClaw核心程序 → 配置大模型API解锁智能能力，三者缺一不可。

值得注意的是，2026年1月Anthropic已明确禁用Claude Pro/Max账号通过OAuth连接OpenClaw的权限，旧版配置全部失效，新手无需尝试该方式，优先选择阿里云百炼免费API，零成本即可解锁全部核心功能。同时，OpenClaw的会话记录、偏好设置会以纯文本Markdown文件形式存储在本地或服务器，需注意存储位置与访问权限，避免隐私泄露。

实测3天，分别在Windows11、MacOS14、Linux（Ubuntu22.04）本地设备与阿里云轻量服务器部署OpenClaw，从操作难度、稳定性、适用场景等维度对比，明确不同需求的最优选择，具体如下：

无论选择哪种部署方案，新手需提前完成以下3项基础准备，避免部署中断，重点做好敏感凭证的保存：

1. 账号准备：注册阿里云账号 并完成实名认证（个人用户支付宝刷脸验证，即时通过；企业用户需上传资质，审核1-3个工作日），用于服务器购买、百炼API开通与密钥获取。
2. 工具准备：远程连接工具（FinalShell/Xshell，用于阿里云服务器进阶操作）、加密文本编辑器（记录公网IP、API-Key等敏感信息）、最新版Chrome浏览器（网页自动化技能必需）、Git（部分技能安装与源码克隆必需）。
3. 环境认知：明确OpenClaw依赖Node.js 22.x及以上版本，低于该版本会导致安装失败；阿里云百炼API是解锁智能能力的核心，需提前领取免费额度；本地部署需确保设备内存≥4GiB，服务器部署最低配置为2vCPU+2GiB内存，否则会出现服务卡顿、频繁重启。

本地部署适合个人轻量使用与短期测试，以下流程结合实测优化，解决了依赖安装超时、端口占用、权限不足等常见问题，所有命令可直接复制执行。

1. 前置依赖安装（核心：Node.js+Git）

（1）Windows11系统（管理员模式操作，实测关键步骤）

新手最易出现“权限不足”“脚本无法执行”问题，需严格按以下步骤操作：

1. 解锁脚本执行权限（避免安装报错）：
   按提示输入“Y”确认，完成权限解锁。
2. 安装Node.js（22.x稳定版，国内镜像加速，避免超时）：

3. 安装Git与配置npm国内镜像（解决技能安装超时）：

4. 验证依赖安装（确保版本达标）：

（2）MacOS 12+系统（实测无权限报错版）

MacOS用户易出现“权限不足”“环境变量配置失败”问题，步骤如下：

1. 安装Homebrew（包管理工具，已安装可跳过）：
   输入电脑开机密码（输入时不显示字符，属于正常现象），等待安装完成。
2. 安装Node.js、Git并配置环境变量：

3. 验证安装：
   三个命令均正常输出版本号，即依赖安装成功。

（3）Linux（Ubuntu 20.04+系统）（实测最简版）

Linux系统依赖安装相对简单，重点解决权限问题：

1. 安装依赖并配置国内镜像：

2. 验证安装：

2. OpenClaw核心安装与初始化（全系统通用，实测优化版）

1. 全局安装OpenClaw（全平台通用命令，支持npm安装）：
   实测提示“安装成功”后，执行版本验证命令：

2. 初始化配置向导（新手直接按提示选默认值，无需手动修改）：
   初始化关键选项（实测最优选择，新手直接按以下操作）：
   • I understand this is powerful and inherently risky. Continue? → 输入Y并回车
   • Onboarding mode → 按回车选择QuickStart（快速启动）
   • Model/auth provider → 按回车选择Skip for now（后续单独配置百炼API）
   • Select channel → 按回车选择Skip for now（后续配置办公软件）
   • Configure skills now? → 输入N并回车（先完成基础部署，再安装技能）
   • Enable hooks? → 按空格键选中，回车下一步
   • How do you want to hatch your bot? → 按回车选择Do this later
3. 启动Gateway服务（核心步骤，服务未启动则无法使用）：

4. 验证本地部署成功：
   打开浏览器，输入，能正常打开OpenClaw Web控制台，即本地部署完成。
   
   
   
   

阿里云部署适合长期使用、团队协作，依托预置镜像实现一键部署，无需手动安装依赖，实测15分钟即可完成，步骤如下：

新手零基础阿里云上部署OpenClaw喂饭级步骤流程

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

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

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

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

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

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

步骤1：购买阿里云轻量应用服务器（实测最优配置）

1. 访问阿里云轻量应用服务器控制台，点击“创建实例”，按以下配置选择（新手直接套用，避免出错）：
   • 地域选择：中国香港、新加坡（免备案，网络通畅，避免国内地域备案繁琐）；
   • 实例规格：最低2vCPU+2GiB内存+40GiB ESSD，推荐2vCPU+4GiB内存（实测2GiB内存易卡顿，4GiB更稳定）；
   • 镜像选择：应用镜像→OpenClaw（阿里云官方预置，已安装Node.js、OpenClaw核心程序，无需手动配置）；
   • 付费类型：按需付费（短期测试，按小时计费，成本低）或包年包月（长期使用，性价比更高）；
   • 登录密码：设置强密码（含大小写字母+数字+特殊符号），妥善保存（远程连接必需）。
2. 确认订单并支付，等待1-3分钟，实例状态变为“运行中”，记录服务器公网IP（如47.xx.xx.xx），服务器创建完成。

步骤2：端口放行（实测关键，否则无法访问控制台）

1. 进入服务器实例详情页，点击“防火墙”→“添加规则”，依次放行以下端口（OpenClaw运行必需）：
   • 22端口（远程连接）：TCP协议，授权对象“个人IP地址”（提升安全性）；
   • 18789端口（Web控制台访问）：TCP协议，授权对象“0.0.0.0/0”（所有设备可访问）；
   • 443端口（API通信）：TCP协议，授权对象“0.0.0.0/0”（百炼API调用必需）；
   • 9222端口（网页自动化技能必需）：TCP协议，授权对象“0.0.0.0/0”。
2. 端口放行后，用FinalShell输入公网IP、用户名（root）、密码，远程连接服务器，测试连接是否成功。

步骤3：OpenClaw初始化与服务验证

1. 远程连接成功后，执行以下命令，完成OpenClaw初始化（预置镜像已安装核心程序，无需重新安装）：

2. 启动Gateway服务并设置开机自启（避免服务器重启后服务停止）：

3. 验证部署成功：
   浏览器输入，能正常打开Web控制台，即阿里云部署完成。
   
   
   
   

OpenClaw需配置大模型API才能实现自然语言理解与任务自动化，阿里云百炼提供7000万免费Token（90天有效期），适合新手零成本入门，步骤如下（实测两种配置方式，新手首选图形化配置）：

1. 访问登录阿里云百炼大模型服务平台，登录后进入“密钥管理”页面；
2. 点击“创建API-Key”，系统自动生成Access Key ID与Access Key Secret，立即复制并保存Access Key Secret（仅创建时可见，后续无法找回）；
3. 领取免费额度：进入“额度管理”页面，新用户可领取7000万Token（90天有效期），足够日常使用；建议开启消费限额，避免超额计费。

1. 访问OpenClaw Web控制台（本地：http://localhost:18789；阿里云：http://公网IP:18789）；
2. 左侧导航栏选择“Config”→“Authentication”→“Raw”；
3. 找到“models”节点，替换为以下配置（替换为你的Access Key Secret，注意地域对应baseUrl）：
   不同地域baseUrl对应关系（实测适配，避免API调用失败）：
   • 华北2（北京）：https://dashscope.aliyuncs.com/compatible-mode/v1
   • 新加坡：https://dashscope-intl.aliyuncs.com/compatible-mode/v1
   • 美国（弗吉尼亚）：https://dashscope-us.aliyuncs.com/compatible-mode/v1
4. 点击“Save”保存，重启Gateway服务使配置生效：

1. 进入OpenClaw配置目录：

2. 编辑配置文件（Windows用notepad，MacOS/Linux用nano）：

3. 粘贴上述“models”配置片段，保存退出；
4. 重启服务：。

执行以下命令，发送测试指令，验证AI响应：

若返回结构化工作清单（含时间安排、任务细节），说明API配置成功；若无响应或提示“模型连接失败”，检查API-Key是否正确、baseUrl是否与地域匹配、服务是否重启。

部署完成后，安装核心技能可扩展OpenClaw功能，新手优先安装以下2个高频技能，覆盖网页自动化与文件管理，所有命令可直接复制执行：

1. 网页自动化实操：

   执行完成后，在当前目录可找到截取的截图文件，实测动态渲染页面也能精准解析。

2. 文件管理实操：

3. 简单任务自动化：

ClawHub市场有2800多个技能，但Snyk报告显示，13.4%的技能存在严重安全问题，17%-20%包含恶意代码，新手安装技能需注意：

• 优先选择高下载量、带验证标识的官方技能，避免安装第三方未知技能；
• 安装前可通过ClawDex安全扫描工具（https://clawdex.koi.security/）扫描技能安全性；
• 不安装功能重复的技能，定期清理30天未使用技能，避免占用资源：

结合实测经验与全网踩坑案例，梳理部署、API配置、技能使用三大环节的关键坑点与解决方案，所有坑点均经过实测验证，确保新手可快速排查问题：

1. 坑点1：Node.js版本过低（最常见）
   • 现象：安装OpenClaw时提示“node版本不兼容”，或安装后无法启动服务；
   • 原因：Node.js版本低于22.x，不满足OpenClaw 2026版本运行要求；
   • 解决方案：用nvm升级Node.js版本（全系统通用）：

2. 坑点2：浏览器无法访问控制台（连接超时）
   • 现象：输入控制台地址后显示“无法连接”或“超时”；
   • 原因：18789端口未放行（阿里云部署），或防火墙拦截（本地部署）；
   • 解决方案：
     • 阿里云部署：实例详情→防火墙→添加规则，放行18789端口（TCP协议，授权对象0.0.0.0/0）；
     • 本地部署：关闭杀毒软件/防火墙，或手动放行18789端口。
3. 坑点3：服务频繁重启（内存不足）
   • 现象：服务运行几分钟后自动停止，或响应极慢，终端提示“out of memory”；
   • 原因：服务器/本地设备配置过低，无法支撑OpenClaw及技能运行；
   • 解决方案：
     • 阿里云部署：升级实例规格至2vCPU+4GiB内存及以上；
     • 本地部署：关闭其他占用内存的程序，卸载不常用技能；
     • 通用：执行查看已安装技能，卸载无用技能。
4. 坑点4：权限不足（本地部署高频）
   • 现象：安装技能或启动服务时提示“permission denied”（权限不足）；
   • 原因：Windows未以管理员模式运行PowerShell，MacOS/Linux未提升权限；
   • 解决方案：
     • Windows：右键PowerShell，选择“以管理员身份运行”；
     • MacOS/Linux：在命令前加sudo提升权限，或执行解决权限问题。

1. 坑点1：对话无响应（API-Key无效）
   • 现象：能登录控制台，但发送指令后无回复或提示“模型连接失败”；
   • 原因：API-Key填写错误（混淆Access Key ID与Secret）、未开通百炼服务、免费额度耗尽；
   • 解决方案：
     • 核对密钥：确保配置的是Access Key Secret，而非Access Key ID；
     • 检查额度：登录百炼控制台，查看“额度管理”确认有可用额度；
     • 重新配置：若密钥错误，生成新API-Key重新配置，重启服务。
2. 坑点2：回复内容为空（reasoning参数错误）
   • 现象：API配置成功，但回复仅为空字符串，无任何内容；
   • 原因：配置文件中参数设为true，2026年OpenClaw版本仅支持false；
   • 解决方案：编辑配置文件，将，保存后重启服务。
3. 坑点3：地域不匹配（baseUrl错误）
   • 现象：提示“API调用失败”“地域不匹配”，无法正常使用；
   • 原因：baseUrl与API-Key归属地域不一致，导致API调用被拦截；
   • 解决方案：根据API-Key地域修改baseUrl（参考本文API配置部分的地域对应关系）。

1. 坑点1：网页自动化技能无法运行
   • 现象：执行网页自动化指令时提示“browser not found”；
   • 原因：未安装Playwright依赖，或Chrome浏览器未安装；
   • 解决方案：执行安装依赖，确保本地安装最新版Chrome浏览器。
2. 坑点2：技能安装超时
   • 现象：执行时提示“network timeout”（网络超时）；
   • 原因：网络卡顿或npm镜像未配置；
   • 解决方案：配置npm国内镜像：，重新执行安装命令。
3. 坑点3：文件管理技能无法访问本地文件
   • 现象：执行文件管理指令时提示“file not found”（文件未找到）；
   • 原因：工作目录路径错误，或文件权限不足；
   • 解决方案：进入正确的工作目录（），确保文件有读写权限。

经过3天全平台实测，OpenClaw本地部署与阿里云部署各有优势，新手可根据自身需求选择，核心总结如下：

1. 选型建议：个人轻量使用、短期测试、隐私敏感场景，优先选择本地部署（零成本，操作便捷）；团队协作、长期自动化任务、多设备访问，优先选择阿里云部署（稳定性强，无需维护设备）。
2. 部署核心：无论哪种部署方案，都需确保Node.js版本≥22.x，阿里云部署需放行关键端口，本地部署需以管理员模式操作，避免权限不足。
3. API配置关键：务必使用阿里云百炼API，确保API-Key正确、baseUrl与地域匹配、参数设为false，否则无法正常使用。
4. 避坑核心：新手不要盲目安装过多技能，优先安装高频核心技能；定期清理无用技能，避免占用资源；敏感凭证（API-Key、服务器密码）妥善保存，避免泄露。

2026年，OpenClaw的核心竞争力在于“开源免费+全场景自动化”，无需专业编程技能，新手只需跟随本文步骤操作，即可快速完成部署，解锁“私人AI员工”的全部价值。建议新手先完成基础部署与API配置，熟悉核心技能的使用，再逐步拓展办公软件对接、定时任务等进阶功能，循序渐进发挥其最大价值。

结合实测经验，新手最易在依赖安装、端口配置、API密钥填写三个环节踩坑，建议收藏本文，部署过程中遇到问题可快速查阅避坑指南；若需长期使用，阿里云部署是更优选择，无需担心本地设备关机导致服务中断，真正实现“一次部署，长期受益”。