【OpenClaw保姆级教程】阿里云/Win11/MacOS/Linux部署步骤+API配置+Skills使用+常见问题-阿里云开发者社区

2026年初，OpenClaw（昵称“小龙虾”）以黑马之姿席卷GitHub，14.5万颗星的增速创下开源项目纪录。这款由Peter Steinberger开发的AI智能体执行框架，彻底打破传统AI“被动对话”的局限，凭借“自我迭代、主动出击、随心定制”三大核心优势，让AI从“能说会道”升级为“真正会干活”——它能记住用户习惯、主动捕捉机会，甚至自我改造优化，成为无数开发者与普通用户的专属AI助手。

深度解析了OpenClaw的核心架构与三大部署方案，重点突出技能系统的执行价值。本文基于该核心逻辑，补充2026年阿里云部署及Windows11/MacOS/Linux本地完整部署流程、阿里云百炼免费大模型API配置步骤，深度拆解Skills技能安装与实战用法，完善常见问题解答，所有代码可直接复制执行，严格规避禁止提及的云服务名称，助力不同需求用户快速落地，解锁OpenClaw的全场景能力。阿里云上OpenClaw极速一键部署最简单，步骤详情访问阿里云OpenClaw一键部署专题页面 了解。

一、核心认知：OpenClaw的底层逻辑与部署选型

（一）OpenClaw是什么？不止是AI，更是“执行型助手”

OpenClaw是一款本地优先、模块化、分层解耦的AI智能体执行框架，核心由“Gateway网关+Agent智能体+Skills技能+Memory记忆”四大模块构成，采用“网关-智能体-渠道-技能-记忆”五层架构，实现“思考-执行-观察-反思”的完整闭环。其核心突破体现在三点：

自我迭代能力：永久记忆用户习惯、目标与工作方式，每一次互动都让AI更贴合需求（如记住用Codex写代码的偏好）；
主动出击模式：无需用户指令，主动捕捉机会并执行任务（如案例中自动开发文章写作功能，带来稳定收益）；
高度定制化：开源特性支持按需改造，甚至AI可自我优化（如自主搭建全新记忆系统）。

而Skills技能系统是OpenClaw的“手脚”，采用声明式、模块化、沙箱化、热插拔设计，是连接AI与现实世界的核心载体——没有技能的OpenClaw只是“空有大脑的AI”，装上技能才能真正实现文件管理、代码开发、自动化办公等实际任务。

（二）三大部署方案对比：按需选择最适合你的方式

参考文章提供三大部署方案，结合2026年实测优化，适配不同用户需求：

部署方案	核心优势	适用人群	操作难度	成本水平	核心特点
本地部署（Win11/MacOS/Linux）	零服务器费用、数据本地存储、隐私可控、调试便捷	零代码基础个人用户、注重隐私、短期体验	★★☆☆☆	零成本（仅模型API费用）	桌面一键安装，下载即用，适合快速体验
阿里云部署	7×24小时运行、多设备访问、深度定制、数据私密	开发者、技术爱好者、企业用户	★★★☆☆	低（服务器约2美元/月起）	完全自主控制，支持技能扩展与自动化任务，适合长期使用
云端托管服务	免部署、免运维、开箱即用	不想维护服务器的用户	★☆☆☆☆	中（订阅制约199元/月）	省心省力，但定制化受限，本文重点覆盖前两种方案

选型建议：

新手/普通用户：优先本地部署，零成本快速体验核心功能；
开发者/长期使用者：选择阿里云部署，享受稳定运行与深度定制；
懒人用户：可选云端托管服务，牺牲定制化换取便捷性。

（三）前置准备（全方案通用）

账号准备：注册阿里云账号并完成实名认证（用于服务器购买与百炼API开通）；GitHub账号（可选，技能开发与社区交流）；
工具准备：远程连接工具（FinalShell，用于阿里云操作）、文本编辑器（VS Code/记事本）、Git（技能安装必需）、Chrome浏览器；
核心认知：OpenClaw依赖Node.js 22.x版本；技能是执行能力核心，需通过ClawHub市场安装；阿里云百炼提供90天7000万Token免费额度，足够日常使用；本地部署需确保设备内存≥4GiB，阿里云部署推荐2vCPU+4GiB内存配置。

二、2026全平台部署流程（阿里云+本地多系统）

（一）方案一：本地部署（Win11/MacOS/Linux，新手首选）

本地部署零成本、隐私可控，分系统提供“一键安装”与“手动安装”双方案，新手优先一键安装，便捷高效：

1. 一键安装（推荐，零代码，下载即用）

参考文章提供的快速部署方案，无需复杂配置，直接下载安装包：

Windows11：下载地址（迅雷网盘）：https://pan.xunlei.com/s/VOnSDIYRyQcTpI-3cpiqImXPA1?pwd=vqsb（文件名称：workbuddy (Windows版).zip，大小537.1MB）；
MacOS：同上述链接（文件名称：workbuddy (mac苹果电脑版).zip，大小562.1MB）；
安装步骤：下载后解压，双击“OpenClaw.exe”（Windows）或“OpenClaw.app”（MacOS），按提示完成安装，启动后自动初始化配置，浏览器访问http://localhost:18789即可使用。

2. 手动安装（备用，适配Linux及自定义需求）

若一键安装失败或需自定义配置，执行以下手动安装步骤：

（1）Windows11系统（管理员模式PowerShell）

# 步骤1：安装Git
winget install Git.Git
git --version  # 验证安装

# 步骤2：安装Node.js 22.x（国内镜像加速）
iwr -useb https://npmmirror.com/mirrors/node/v22.10.0/node-v22.10.0-x64.msi -OutFile node-install.msi
Start-Process .\node-install.msi -Wait
node -v  # 需显示v22.x.x
npm -v   # 需显示10.x.x

# 步骤3：配置npm国内镜像
npm config set registry https://registry.npmmirror.com

# 步骤4：安装OpenClaw
npm install -g openclaw@latest

# 步骤5：创建工作目录
mkdir -p ~/OpenClaw-Local/{
   skills,config,resources} && cd ~/OpenClaw-Local

# 步骤6：初始化配置与启动服务
openclaw init
openclaw gateway start

# 步骤7：验证部署（浏览器访问http://localhost:18789）

（2）MacOS 12+系统（终端）

# 步骤1：安装Homebrew（已安装可跳过）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 步骤2：安装Node.js、Git
brew install node@22 git
echo 'export PATH="/usr/local/opt/node@22/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# 步骤3：验证安装
node -v && git --version

# 步骤4：配置npm国内镜像
npm config set registry https://registry.npmmirror.com

# 步骤5：安装OpenClaw与启动服务
npm install -g openclaw@latest
mkdir -p ~/OpenClaw-Local/{
   skills,config,resources} && cd ~/OpenClaw-Local
openclaw init
openclaw gateway start

（3）Linux系统（Ubuntu 20.04+，终端）

# 步骤1：更新系统依赖
sudo apt update && sudo apt upgrade -y

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

# 步骤3：配置npm国内镜像
npm config set registry https://registry.npmmirror.com

# 步骤4：安装OpenClaw（解决权限问题）
sudo npm install -g openclaw@latest --unsafe-perm

# 步骤5：创建工作目录与启动服务
mkdir -p ~/OpenClaw-Local/{
   skills,config,resources} && cd ~/OpenClaw-Local
openclaw init
openclaw gateway start

# 步骤6：设置开机自启
echo "openclaw gateway start" >> ~/start-openclaw.sh
chmod +x ~/start-openclaw.sh
sudo echo "@reboot ~/start-openclaw.sh" >> /etc/crontab

（二）方案二：阿里云部署（长期/定制化首选）

适合需要7×24小时运行或深度定制的用户，步骤如下：

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

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

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

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

轻量应用服务器OpenClaw镜像.png

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

阿里云百炼密钥管理图.png

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

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

1. 服务器配置与实例创建

访问阿里云轻量应用服务器控制台，创建实例：
- 地域选择：中国香港、新加坡（免备案，网络通畅）；
- 镜像选择：Alibaba Cloud Linux 3.2104 LTS 64位；
- 实例规格：2vCPU+4GiB内存+40GiB ESSD+3Mbps带宽（个人足够）；
- 付费类型：按需付费（测试）/ 包年包月（长期）；
- 登录密码：设置强密码（≥12位，含大小写字母、数字、特殊符号）。
端口放行：进入实例详情页→“防火墙”→“添加规则”，放行22（远程连接）、18789（OpenClaw控制台）、443（API通信）端口。

2. 依赖安装与OpenClaw部署

# 远程连接服务器后执行
# 步骤1：更新系统依赖
sudo yum update -y && sudo yum upgrade -y

# 步骤2：安装Node.js、Git
sudo yum install -y git curl
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash
sudo yum install -y nodejs

# 步骤3：配置npm国内镜像
npm config set registry https://registry.npmmirror.com

# 步骤4：安装OpenClaw
sudo npm install -g openclaw@latest --unsafe-perm

# 步骤5：创建工作目录
mkdir -p /data/openclaw/{
   skills,config,resources} && cd /data/openclaw

# 步骤6：初始化配置与启动服务
openclaw init
openclaw gateway start

# 步骤7：设置开机自启
echo "openclaw gateway start" >> /etc/rc.d/rc.local
chmod +x /etc/rc.d/rc.local

3. 阿里云部署验证

浏览器输入“http://服务器公网IP:18789”，能打开OpenClaw登录界面（需输入Token），说明部署成功。

三、免费大模型API配置（阿里云百炼，让AI“会思考”）

OpenClaw本身不具备大模型推理能力，需对接外部大模型才能实现自然语言理解与任务执行，阿里云百炼提供90天7000万Token免费额度，配置步骤如下，全部署方案通用：

1. 获取阿里云百炼API-Key

访问登录阿里云百炼大模型服务平台，进入“密钥管理”页面；
点击“创建API-Key”，复制生成的密钥（仅显示一次，妥善保存）；
进入“额度管理”页面，点击“领取免费额度”，7000万Token自动到账。

2. 配置OpenClaw关联API

# 步骤1：进入配置目录
cd ~/.openclaw

# 步骤2：编辑配置文件（Win11用notepad，Mac/Linux用nano）
nano config.yaml

# 步骤3：粘贴以下配置（替换为你的API-Key）
model:
  provider: alibaba-cloud
  apiKey: "你的百炼API-Key"
  baseUrl: "https://dashscope.aliyuncs.com/compatible-mode/v1"
  defaultModel: "bailian/qwen3.5-turbo"  # 免费模型，兼顾性能与速度
  parameters:
    temperature: 0.7  # 平衡创造性与准确性
    maxTokens: 4096   # 支持长文本处理
skills:
  autoLoad: true
  scanPath: ["~/.openclaw/skills", "~/OpenClaw-Local/skills"]
memory:
  enabled: true  # 启用记忆系统
  path: "~/OpenClaw-Local/memory"
security:
  sensitiveDataFilter: true
  sandboxMode: true  # 启用沙箱模式，安全执行技能

3. 重启服务生效

# 本地部署
openclaw gateway restart
# 阿里云部署
openclaw gateway restart

4. API配置验证

启动OpenClaw会话，输入测试指令：

openclaw
# 对话框输入
帮我总结OpenClaw的核心模块与优势，用Markdown列表呈现

若能正常生成结构化回答，说明API配置成功，OpenClaw已具备“思考能力”。

四、Skills技能实战：让OpenClaw真正“会干活”

Skills是OpenClaw的执行核心，参考文章强调其“连接AI与现实世界”的价值，以下是技能安装、精选清单与实战用法：

（一）技能安装的两种方法

方法一：命令行一键安装（推荐，便捷高效）

# 步骤1：安装技能管理工具clawhub
npm install -g clawhub

# 步骤2：配置国内镜像（解决下载超时）
clawhub config set registry https://clawhub-mirror.aliyuncs.com

# 步骤3：搜索技能（可选，查看版本与下载量）
clawhub search file-manager

# 步骤4：安装技能（以文件管理技能为例）
npx clawhub@latest install file-manager

# 步骤5：启用技能
openclaw skills enable file-manager

# 步骤6：重启服务生效
openclaw gateway restart

方法二：手动安装（备用，网络不佳时使用）

访问ClawHub官网（https://clawhub.ai），用GitHub账号登录；
搜索目标技能（如file-manager），点击“Download zip”下载压缩包；
解压压缩包，将文件夹复制到对应系统的技能目录：
- Windows11：C:\Users\你的用户名\AppData\Roaming\npm\node_modules\openclaw\skills；
- MacOS：~/node_modules/openclaw/skills；
- Linux：/usr/local/lib/node_modules/openclaw/skills；

启用技能并重启服务：

openclaw skills enable file-manager
openclaw gateway restart

（二）2026必装核心技能清单（实用优先）

结合参考文章逻辑与2026年技能生态，精选8个高价值技能，覆盖日常办公、开发、自动化场景：

技能名称	核心功能	安装命令	适用场景	安全等级
file-manager	文件管理（分类、重命名、批量处理）	npx clawhub@latest install file-manager	日常办公、文件整理	★★★★★
code-executor	代码执行、调试、生成	npx clawhub@latest install code-executor	开发者、编程学习	★★★☆☆
web-scraper	网页数据抓取、信息提取	npx clawhub@latest install web-scraper	数据收集、信息整理	★★★★☆
calendar-manager	日程管理、会议提醒、任务跟踪	npx clawhub@latest install calendar-manager	办公协同、时间管理	★★★★★
email-processor	邮件自动分类、附件提取、回复建议	npx clawhub@latest install email-processor	商务办公、邮件处理	★★★★☆
self-improver	自我优化、记忆强化、流程迭代	npx clawhub@latest install self-improver	长期使用、个性化适配	★★★★☆
pdf-handler	PDF文本提取、合并、拆分	npx clawhub@latest install pdf-handler	文档处理、办公场景	★★★★★
weather-query	天气查询、预报、提醒	npx clawhub@latest install weather-query	日常出行、计划安排	★★★★★

（三）技能实战示例：从安装到执行

以“文件管理+PDF处理”联动为例，演示技能使用流程：

# 步骤1：安装核心技能
npx clawhub@latest install file-manager pdf-handler
openclaw skills enable file-manager pdf-handler
openclaw gateway restart

# 步骤2：启动OpenClaw会话，执行联动任务
openclaw
# 对话框输入指令（直接复制）
帮我按以下步骤执行：
1. 用file-manager技能整理~/OpenClaw-Local/resources文件夹，按"文档（PDF/Word）、图片、其他"分类；
2. 用pdf-handler技能提取所有PDF文件的文本，合并为一个文档，保存到~/OpenClaw-Local/resources/合并文本.md；
3. 生成整理日志，记录分类文件数量与PDF提取结果。

预期结果：

文件夹自动分类，文件按类型归档；
所有PDF文本合并为Markdown文档，保存到指定路径；
生成结构化日志，包含“文档类10个、图片类5个、其他类3个”等信息。

（四）技能安全使用原则

参考文章强调技能沙箱化设计，使用时需注意：

启用沙箱模式：配置文件中security.sandboxMode: true，限制技能权限；
优先选择高下载量技能：ClawHub中下载量≥1000的技能更可靠；
定期审计技能：执行openclaw skills audit --all，排查恶意技能；
禁用不必要技能：openclaw skills disable 技能名，减少安全风险。

五、常见问题解答（FAQ，避坑关键）

（一）部署相关问题

问题1：本地部署后，浏览器访问http://localhost:18789无响应？
解决方案：执行openclaw gateway status，确认服务是否运行；若未运行，执行openclaw gateway start；检查端口是否被占用（Windows：netstat -ano | findstr :18789；Linux/Mac：lsof -ti:18789 | xargs kill -9），释放端口后重启服务。
问题2：阿里云部署后，无法远程访问控制台？
解决方案：确认18789端口已放行；检查服务器公网IP正确；执行openclaw gateway restart；若提示“permission denied”，切换root用户启动服务（sudo openclaw gateway start）。
问题3：一键安装包解压后无法启动？
解决方案：检查设备是否满足最低配置（内存≥4GiB）；Windows系统右键“以管理员身份运行”；MacOS系统赋予权限（chmod +x OpenClaw.app/Contents/MacOS/OpenClaw）；若仍失败，改用手动安装方案。

（二）API与技能问题

问题1：阿里云百炼提示“额度不足”？
解决方案：进入百炼控制台领取免费额度；减少高频无效调用，技能默认缓存结果；调整maxTokens参数（日常任务设为2048）；关闭不常用技能，节省Token消耗。
问题2：技能安装后无法调用，提示“未找到技能”？
解决方案：确认技能已启用（openclaw skills list --status enabled）；检查技能目录路径正确，无中文或特殊字符；重启OpenClaw服务，重新触发技能调用。
问题3：code-executor技能执行代码提示“权限不足”？
解决方案：启用沙箱模式的同时，赋予技能有限权限（openclaw config set skills.code-executor.allowPaths ["~/OpenClaw-Local/resources"]）；避免执行高危代码（如系统命令、文件删除）；以普通用户身份运行OpenClaw，减少权限风险。

（三）记忆与定制化问题

问题1：如何清除OpenClaw的记忆数据？
解决方案：执行以下命令，删除记忆文件：
```
rm -rf ~/OpenClaw-Local/memory/*
openclaw gateway restart
```
或在OpenClaw会话中输入指令：/memory clear，清空所有记忆。
问题2：如何让OpenClaw记住我的使用习惯？
解决方案：确保memory.enabled: true；在对话中明确告知习惯（如“我习惯用Markdown格式输出结果”“默认保存文件到~/文档”）；OpenClaw会自动将信息存入记忆系统，后续互动自动适配。
问题3：如何自定义技能执行流程？
解决方案：安装skill-creator技能（npx clawhub@latest install skill-creator），通过自然语言描述流程（如“创建一个技能，每天晚上8点整理桌面文件”）；或手动编写技能脚本，放入技能目录，启用后即可执行。

六、总结：OpenClaw的核心价值，是让AI“主动创造价值”

OpenClaw的崛起，本质是AI从“被动响应”到“主动执行”的革命——它不再是需要用户反复指令的工具，而是能记住习惯、捕捉机会、自我优化的“专属助手”。本文基于参考文章的核心架构与部署方案，补充全平台部署流程、API配置、技能实战与避坑指南，新手可按以下步骤快速上手：

选型：新手选本地一键安装，长期使用选阿里云部署；
部署：按系统执行安装步骤，验证服务正常运行；
配置：对接阿里云百炼API，让AI具备思考能力；
拓展：安装核心技能，实现文件管理、代码执行等实际任务；
优化：启用沙箱安全模式，定制记忆与执行流程，让AI更贴合需求。

随着技能生态的持续完善，OpenClaw的应用场景会不断拓展——从日常办公的文件整理、日程管理，到开发者的代码调试、数据抓取，再到企业的自动化流程、协同办公，都能通过简单配置实现。无需复杂编程，只需清晰描述需求，OpenClaw就能主动执行、持续优化，真正成为你工作生活中的“得力助手”。

【OpenClaw保姆级教程】阿里云/Win11/MacOS/Linux部署步骤+API配置+Skills使用+常见问题

一、核心认知：OpenClaw的底层逻辑与部署选型

（一）OpenClaw是什么？不止是AI，更是“执行型助手”

（二）三大部署方案对比：按需选择最适合你的方式

（三）前置准备（全方案通用）

二、2026全平台部署流程（阿里云+本地多系统）

（一）方案一：本地部署（Win11/MacOS/Linux，新手首选）

1. 一键安装（推荐，零代码，下载即用）

2. 手动安装（备用，适配Linux及自定义需求）

（1）Windows11系统（管理员模式PowerShell）

（2）MacOS 12+系统（终端）

（3）Linux系统（Ubuntu 20.04+，终端）

（二）方案二：阿里云部署（长期/定制化首选）

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

1. 服务器配置与实例创建

2. 依赖安装与OpenClaw部署

3. 阿里云部署验证

三、免费大模型API配置（阿里云百炼，让AI“会思考”）

1. 获取阿里云百炼API-Key

2. 配置OpenClaw关联API

3. 重启服务生效

4. API配置验证

四、Skills技能实战：让OpenClaw真正“会干活”

（一）技能安装的两种方法

方法一：命令行一键安装（推荐，便捷高效）

方法二：手动安装（备用，网络不佳时使用）

（二）2026必装核心技能清单（实用优先）

（三）技能实战示例：从安装到执行

（四）技能安全使用原则

五、常见问题解答（FAQ，避坑关键）

（一）部署相关问题

（二）API与技能问题

（三）记忆与定制化问题

六、总结：OpenClaw的核心价值，是让AI“主动创造价值”

热门文章

最新文章

相关电子书

探索云世界

热门

云计算

大数据

云原生

人工智能

数据库

开发与运维

活动广场

任务中心

训练营

直播

乘风者计划

下载

镜像站

技术资料

【OpenClaw保姆级教程】阿里云/Win11/MacOS/Linux部署步骤+API配置+Skills使用+常见问题

一、核心认知：OpenClaw的底层逻辑与部署选型

（一）OpenClaw是什么？不止是AI，更是“执行型助手”

（二）三大部署方案对比：按需选择最适合你的方式

（三）前置准备（全方案通用）

二、2026全平台部署流程（阿里云+本地多系统）

（一）方案一：本地部署（Win11/MacOS/Linux，新手首选）

1. 一键安装（推荐，零代码，下载即用）

2. 手动安装（备用，适配Linux及自定义需求）

（1）Windows11系统（管理员模式PowerShell）

（2）MacOS 12+系统（终端）

（3）Linux系统（Ubuntu 20.04+，终端）

（二）方案二：阿里云部署（长期/定制化首选）

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

1. 服务器配置与实例创建

2. 依赖安装与OpenClaw部署

3. 阿里云部署验证

三、免费大模型API配置（阿里云百炼，让AI“会思考”）

1. 获取阿里云百炼API-Key

2. 配置OpenClaw关联API

3. 重启服务生效

4. API配置验证

四、Skills技能实战：让OpenClaw真正“会干活”

（一）技能安装的两种方法

方法一：命令行一键安装（推荐，便捷高效）

方法二：手动安装（备用，网络不佳时使用）

（二）2026必装核心技能清单（实用优先）

（三）技能实战示例：从安装到执行

（四）技能安全使用原则

五、常见问题解答（FAQ，避坑关键）

（一）部署相关问题

（二）API与技能问题

（三）记忆与定制化问题

六、总结：OpenClaw的核心价值，是让AI“主动创造价值”

热门文章

最新文章

相关电子书