【养“龙虾”🦞教程】10分钟上手OpenClaw：全平台部署（阿里云/Win11/MacOS/Linux）+API配置+Skill安装+避坑指南-阿里云开发者社区

“听说OpenClaw能自动干活，兴冲冲部署完，却只会让它陪聊？”——这是2026年无数“龙虾养殖户”（OpenClaw用户昵称）的入门困境。其实OpenClaw的核心魅力不在基础对话，而在Skills（技能）生态——就像给“龙虾”装APP，装上之后就能自动查资料、整理文件、处理PDF、总结内容，真正实现“解放双手”。

参考零基础上手OpenClaw的实战心得，避开专业术语与复杂逻辑，聚焦“能落地、能复用”的操作步骤。本文基于参考文章的“简单易懂、一步不落”核心思路，补充2026年新手零基础全平台部署流程（阿里云+Windows11/MacOS/Linux本地）、阿里云百炼免费大模型API配置步骤，用保姆级细节拆解技能安装的3种方法、高频技能实战及新手避坑要点，所有代码可直接复制执行，让零基础用户10分钟从“不会用”到“熟练干”。阿里云上OpenClaw极速一键部署最简单，步骤详情访问阿里云OpenClaw一键部署专题页面 了解。

一、核心认知：OpenClaw不难，关键抓准“3个核心”

（一）OpenClaw是什么？一句话讲透

OpenClaw本质是“能听懂人话、自动干活的AI助手”，核心由三部分组成：

Gateway（网关）：运行核心，相当于“龙虾”的身体；
Agent（智能体）：决策中心，相当于“龙虾”的大脑，负责理解需求、调用技能；
Skills（技能）：功能插件，相当于“龙虾”的工具，装得越多，能干的活越多。

新手不用纠结底层逻辑，记住一句话：OpenClaw=基础助手+Skills=能干实事的AI员工。没装Skills，它只是“陪聊机器人”；装上技能，就能自动处理重复工作，帮你省出大量时间。

（二）Skills是什么？不用懂代码，会装会用就行

很多新手看到“技能”“插件”就头大，其实Skills超简单：

本质：别人做好的“自动化脚本”，你直接安装就能用，不用写一行代码；
用法：装完后说“人话”触发，比如“帮我总结这份PDF”“整理桌面文件”，AI会自动调用对应技能；
核心价值：覆盖80%日常场景（信息检索、文件处理、内容总结、自动化办公），把重复、麻烦的事交给AI，你聚焦重要工作。

（三）部署方案选型：新手选本地，长期用阿里云

结合新手操作难度与使用场景，双部署方案对比清晰，直接对号入座：

部署方案	核心优势	适用人群	操作难度	维护成本
本地部署（Win11/MacOS/Linux）	零服务器费用、操作便捷、数据本地存储	零基础新手、个人用户、短期使用	★★☆☆☆	中（需保持设备开机）
阿里云部署	7×24小时运行、多设备访问、支持长期任务	团队用户、需要自动化部署、长期使用	★★★☆☆	低（阿里云自带运维）

新手建议：先从本地部署入手，熟悉操作后再根据需求迁移到阿里云，避免一开始就被服务器配置劝退。

（四）前置准备：3件事搞定，后续不卡壳

账号准备：注册阿里云账号并完成实名认证（用于领取免费大模型API）；
工具准备：文本编辑器（VS Code/记事本，编辑配置文件）、Git（部分技能安装必需）、Chrome浏览器（验证服务）；
心态准备：不用怕命令行，本文所有命令可直接复制粘贴；不用懂技术，跟着步骤点就行，一遍不行再来一遍，真的很简单。

二、2026新手零基础全平台部署流程（OpenClaw+核心环境）

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

本地部署零成本、操作简单，适合个人用户入门，分系统拆解步骤，每一步都标清“怎么做”：

1. 前置依赖安装（Node.js是核心，必须装对）

OpenClaw依赖Node.js 22.x及以上版本，按系统执行命令，复制粘贴即可：

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

# 安装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
# 安装Git（部分技能安装需要，提前装避免后续报错）
winget install Git.Git
# 配置npm国内镜像（解决技能下载慢、超时问题）
npm config set registry https://registry.npmmirror.com
# 验证安装（出现版本号即为成功，不用记具体数字）
node --version  # 需显示v22.x.x（如v22.10.0）
git --version    # 需显示2.40.x及以上

补充说明：双击安装Node.js时，记得勾选“Add to PATH”，否则后续会提示“command not found”；安装完成后重启PowerShell。

（2）MacOS 12+系统（终端，不用管理员）

# 安装Homebrew（包管理器，已安装可跳过，复制粘贴一键执行）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 安装Node.js、Git（核心依赖，一步到位）
brew install node@22 git
# 配置环境变量（避免命令无法识别）
echo 'export PATH="/usr/local/opt/node@22/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
# 配置npm国内镜像
npm config set registry https://registry.npmmirror.com
# 验证安装
node --version && git --version

补充说明：M芯片Mac若提示“command not found”，执行echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc再重启终端。

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

# 安装Node.js 22.x（国内镜像，快速不超时）
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash
sudo apt install -y nodejs git
# 配置npm国内镜像
npm config set registry https://registry.npmmirror.com
# 解决权限问题（避免后续安装技能提示“权限不足”）
sudo chmod -R 777 /usr/local/lib/node_modules
# 验证安装
node --version && git --version

2. OpenClaw核心安装与启动（一步到位，不用改配置）

依赖安装完成后，执行以下命令，全程自动完成：

# 全局安装OpenClaw（最新稳定版，新手不用指定版本）
npm install -g openclaw@latest
# 创建工作目录（存放技能、配置、文件，避免混乱）
mkdir -p ~/OpenClaw-Worker && cd ~/OpenClaw-Worker
# 初始化配置（按提示操作，全部选默认即可，不用手动改）
openclaw init
# 启动Gateway服务（核心命令，启动成功就能用）
openclaw gateway start

3. 验证部署（关键一步，确认没白装）

打开Chrome浏览器，输入 http://localhost:18789，若出现OpenClaw登录界面（需要输入Token），说明部署成功；
若提示“无法访问”，按以下步骤排查：

检查命令是否执行成功（没报错）；
重启Gateway服务（openclaw gateway restart）；
换浏览器重试（优先Chrome）。

（二）方案二：阿里云部署（长期使用/团队协作首选）

如果需要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部署（复制命令执行）

用FinalShell连接服务器：输入服务器公网IP、用户名（默认root）、登录密码，连接成功；

执行以下命令部署（直接复制粘贴，顺序执行）：

# 更新系统依赖（避免安装失败）
sudo apt update -y && sudo apt upgrade -y
# 安装Node.js、Git（核心依赖）
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash
sudo apt install -y nodejs git
# 配置npm国内镜像
npm config set registry https://registry.npmmirror.com
# 安装OpenClaw
npm install -g openclaw@latest
# 创建工作目录
mkdir -p /data/openclaw/worker && cd /data/openclaw/worker
# 初始化配置
openclaw init
# 启动服务并设置开机自启（服务器重启后自动运行）
openclaw gateway start
echo "openclaw gateway start" >> /etc/rc.d/rc.local
chmod +x /etc/rc.d/rc.local

3. 验证部署

浏览器输入 http://服务器公网IP:18789，能打开OpenClaw登录界面即为成功。

三、阿里云百炼免费API配置（“龙虾”有大脑，才能干活）

OpenClaw的“大脑”需要大模型支撑，才能理解需求、调用技能。阿里云百炼提供7000万Token免费额度（90天有效期），足够新手日常使用，配置步骤超简单：

1. 获取百炼API-Key（3步搞定）

访问登录阿里云百炼大模型服务平台（官网搜索“百炼大模型”）；
进入“密钥管理”页面，点击“创建API-Key”，在弹窗中确认，复制生成的API-Key（仅显示一次，记好别丢）；
进入“额度管理”页面，点击“领取免费额度”，7000万Token自动到账。

2. 配置OpenClaw关联API（全部署方案通用）

# 进入OpenClaw配置目录（本地/阿里云路径一致）
cd ~/.openclaw
# 编辑配置文件（Win11用notepad，Mac/Linux用nano）
# Windows11执行
notepad config.yaml
# MacOS/Linux执行
nano config.yaml

粘贴以下配置（替换为你的API-Key，其他参数不用改）：

model:
  provider: alibaba-cloud
  apiKey: "你的百炼API-Key"  # 替换成自己的API-Key
  baseUrl: "https://dashscope.aliyuncs.com/compatible-mode/v1"
  defaultModel: "bailian/qwen3.5-turbo"  # 免费模型，足够日常使用
  parameters:
    temperature: 0.7  # 平衡创造性与准确性，不用改
    maxTokens: 4096   # 足够处理长文本与复杂任务
skills:
  autoLoad: true  # 自动加载已安装技能
security:
  sensitiveDataFilter: true  # 过滤敏感数据，保护隐私

保存文件后，重启OpenClaw生效：

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

3. 验证API配置（确保“大脑”能用）

启动OpenClaw会话，输入简单指令，能正常响应即为成功：

# 启动会话
openclaw
# 对话框输入
帮我总结一句话：OpenClaw是能自动干活的AI助手，装上Skills之后能处理文件、查资料、总结内容。

若能生成简洁总结，说明API配置成功；若提示“API密钥无效”，检查API-Key是否复制正确（无多余空格），重新配置后重启服务。

四、Skills安装：3种方法，新手首选“最懒的”

参考文章作者分享了3种技能安装方法，按“简单程度”排序，新手直接选前两种，不用纠结第三种：

（一）方法一：对话安装（最懒、最推荐，零命令门槛）

直接跟OpenClaw说“人话”，让它自己找、自己装，你等提示就行，适合完全不懂命令行的新手：

操作步骤：

启动OpenClaw会话：
```
openclaw
```

在对话框中输入指令（直接复制，替换技能名称即可）：

帮我安装“summarize”（内容总结）和“file-manager”（文件管理）这两个技能，安装完成后告诉我。

等待安装完成：OpenClaw会自动搜索技能、下载安装，完成后提示“安装成功”；
验证技能：输入“查看已安装的技能”，OpenClaw会列出已装技能，确认目标技能在列即可。

进阶用法（指定来源安装）：

如果知道技能的GitHub链接，可直接让AI安装：

帮我安装这个技能，GitHub链接是：https://github.com/openclaw/skills/tree/main/summarize，安装完成后帮我测试能不能用。

（二）方法二：命令安装（稳定不抽风，复制粘贴就行）

用现成的命令安装，比对话安装更快，适合想精准控制安装过程的用户，步骤如下：

核心命令（直接复制执行）：

# 1. 安装技能管理工具clawhub（官方工具，必装）
npm install -g clawhub
# 2. 配置国内镜像（解决下载超时）
clawhub config set registry https://clawhub-mirror.aliyuncs.com
# 3. 安装单个技能（以summarize为例）
clawhub install summarize
# 4. 批量安装多个技能（推荐新手必装的4个高频技能）
clawhub install summarize file-manager pdf-processor tavily-web-search
# 5. 查看已安装技能
clawhub list
# 6. 卸载技能（装错了或不用了，替换技能名称即可）
clawhub uninstall 技能名称

新手必装的4个高频技能（装完就能用，覆盖80%场景）：

技能名称	核心功能	触发指令示例
summarize	总结网页、文档、文本，提取核心要点	“帮我总结这份PDF”“提取这段文字的关键信息”
file-manager	自动整理文件、批量重命名、分类归档	“整理桌面文件”“批量重命名图片”
pdf-processor	处理PDF（提取文本、合并/拆分、转换格式）	“提取这个PDF的文字”“把这两个PDF合并”
tavily-web-search	实时联网搜索，获取最新信息	“查一下2026年AI行业热点”“搜索今天的新闻”

（三）方法三：本地添加（进阶玩法，新手可先跳过）

把别人做好的技能包（文件夹）放到指定目录，重启OpenClaw就能加载，适合安装小众、自定义技能：

操作步骤：

下载技能包（从可信来源获取，如GitHub）；
找到OpenClaw技能目录：
- 本地部署：~/.openclaw/workspace/skills；
- 阿里云部署：/data/openclaw/worker/.openclaw/workspace/skills；
把技能包解压到该目录；
重启OpenClaw：openclaw gateway restart；
验证：clawhub list，查看技能是否在列。

（四）技能使用：说“人话”就行，不用手动切换

很多新手装完技能不知道怎么用，其实超简单——不用手动选技能，直接说需求，AI会自动调用对应工具：

实战示例1：用summarize总结文本

openclaw
# 对话框输入
帮我总结以下文字的核心要点：OpenClaw是一款开源AI智能体，支持多平台部署，通过安装Skills可以扩展功能，覆盖办公自动化、信息检索、文件处理等场景，新手也能快速上手。

实战示例2：用file-manager整理文件

# 对话框输入
帮我整理桌面文件，按“文档（Word/PDF/Excel）、图片（PNG/JPG）、视频（MP4）、其他”分类，移动到对应文件夹。

实战示例3：用pdf-processor处理PDF

# 对话框输入
帮我提取~/OpenClaw-Worker/资料.pdf中的所有文字，保存为文本文件，路径还是~/OpenClaw-Worker/资料.txt。

实战示例4：用tavily-web-search联网搜索

# 对话框输入
查一下2026年最新的AI工具排行榜，总结前3个工具的核心优势。

五、新手最容易踩的坑（避坑指南，少走弯路）

参考文章作者分享了自己踩过的坑，整理成8个高频问题，遇到问题先查这里：

（一）部署与API问题

问题1：安装Node.js后，执行node --version提示“command not found”？
解决方案：Windows重启PowerShell，Mac/Linux执行source ~/.zshrc；检查安装Node.js时是否勾选“Add to PATH”，没勾选就重新安装并勾选。
问题2：启动OpenClaw后，浏览器访问http://localhost:18789无法打开？
解决方案：检查Gateway服务是否启动（openclaw gateway status，显示“running”才正常）；确认端口没被占用（Windows用netstat -ano | findstr :18789，Linux/Mac用lsof -ti:18789 | xargs kill -9）；换端口启动（openclaw gateway run --port 8080）。
问题3：配置API后，提示“额度不足”或“密钥无效”？
解决方案：
- 密钥无效：重新复制API-Key，确保无多余空格，重新配置后重启服务；
- 额度不足：进入阿里云百炼控制台领取免费额度，日常使用减少高频无效调用。

（二）技能安装与使用问题

问题1：装完技能没反应，触发指令后AI不调用？
解决方案：装完技能后重启OpenClaw会话（exit退出后重新执行openclaw）；或在对话框输入“刷新已安装的技能”；检查技能名称是否正确，避免拼写错误。
问题2：安装技能提示“网络超时”？
解决方案：配置clawhub国内镜像（clawhub config set registry https://clawhub-mirror.aliyuncs.com）；检查网络通畅性，避免下载中断；换对话安装方式重试。
问题3：技能执行失败，提示“权限不够”？
解决方案：Windows用管理员模式打开终端，Linux/Mac在命令前加sudo（如sudo clawhub install summarize）；日常使用别给OpenClaw太高权限，够用就行，安全第一。

（三）其他高频坑

问题1：命令执行报错，提示“依赖缺失”？
解决方案：回到第一步，重新安装Node.js、Git等依赖；执行openclaw doctor，自动诊断并修复依赖问题。
问题2：阿里云部署后，远程访问不了控制台？
解决方案：检查服务器18789端口已放行；确认服务器公网IP正确；执行openclaw gateway status，确保服务在运行；关闭服务器防火墙（sudo systemctl stop firewalld）。

六、实战：用OpenClaw完成1个完整工作流（从安装到落地）

以“整理资料→提取信息→总结要点”为例，演示OpenClaw的完整用法，新手可跟着操作：

步骤1：安装所需技能

# 批量安装file-manager（文件整理）、pdf-processor（PDF处理）、summarize（总结）
clawhub install file-manager pdf-processor summarize
# 启动会话
openclaw

步骤2：整理本地PDF资料

# 对话框输入
帮我整理~/Documents/工作资料文件夹中的所有PDF文件，移动到~/OpenClaw-Worker/PDF资料文件夹，按“2026-原文件名”重命名。

步骤3：提取PDF文本

# 对话框输入
帮我提取~/OpenClaw-Worker/PDF资料/2026-项目方案.pdf中的所有文本，保存为~/OpenClaw-Worker/项目方案文本.txt。

步骤4：总结核心要点

# 对话框输入
帮我总结~/OpenClaw-Worker/项目方案文本.txt的核心要点，包含项目目标、执行步骤、预期成果，用Markdown列表呈现。

步骤5：查看结果

打开~/OpenClaw-Worker目录，就能看到整理好的PDF、提取的文本和总结要点，全程不用手动操作，AI自动完成。

七、总结：OpenClaw不难，关键“别想太多，直接动手”

很多新手被“AI智能体”“开源框架”等术语吓到，其实OpenClaw的核心是“简单实用”——部署不难，跟着命令复制粘贴就行；技能安装不难，对话或复制命令就搞定；使用不难，说“人话”就能触发。

本文基于参考文章的“零基础友好”思路，补充了全平台部署、API配置、实战流程，新手按以下步骤推进，10分钟就能上手：

部署：选本地部署，按系统执行依赖安装与OpenClaw启动；
配置：申请阿里云百炼API-Key，完成关联配置；
装技能：用对话或命令安装4个高频技能（summarize、file-manager、pdf-processor、tavily-web-search）；
用技能：说“人话”触发需求，让AI自动干活；
避坑：遇到问题查“新手避坑指南”，不用盲目搜教程。

工具是为人服务的，OpenClaw的核心价值是“解放双手”——把整理文件、处理PDF、总结资料等重复工作交给它，你聚焦更重要的事。不用追求“装所有技能”，先把1-2个高频技能用熟，就能感受到效率提升；后续再根据需求添加其他技能，逐步解锁更多功能。

探索云世界

热门

云计算

大数据

云原生

人工智能

数据库

开发与运维

活动广场

任务中心

训练营

直播

乘风者计划

下载

镜像站

技术资料

【养“龙虾”🦞教程】10分钟上手OpenClaw：全平台部署（阿里云/Win11/MacOS/Linux）+API配置+Skill安装+避坑指南

一、核心认知：OpenClaw不难，关键抓准“3个核心”

（一）OpenClaw是什么？一句话讲透

（二）Skills是什么？不用懂代码，会装会用就行

（三）部署方案选型：新手选本地，长期用阿里云

（四）前置准备：3件事搞定，后续不卡壳

二、2026新手零基础全平台部署流程（OpenClaw+核心环境）

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

1. 前置依赖安装（Node.js是核心，必须装对）

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

（2）MacOS 12+系统（终端，不用管理员）

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

2. OpenClaw核心安装与启动（一步到位，不用改配置）

3. 验证部署（关键一步，确认没白装）

（二）方案二：阿里云部署（长期使用/团队协作首选）

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

1. 服务器配置与实例创建（新手直接照搬参数）

2. 远程连接与OpenClaw部署（复制命令执行）

3. 验证部署

三、阿里云百炼免费API配置（“龙虾”有大脑，才能干活）

1. 获取百炼API-Key（3步搞定）

2. 配置OpenClaw关联API（全部署方案通用）

3. 验证API配置（确保“大脑”能用）

四、Skills安装：3种方法，新手首选“最懒的”

（一）方法一：对话安装（最懒、最推荐，零命令门槛）

操作步骤：

进阶用法（指定来源安装）：

（二）方法二：命令安装（稳定不抽风，复制粘贴就行）

核心命令（直接复制执行）：

新手必装的4个高频技能（装完就能用，覆盖80%场景）：

（三）方法三：本地添加（进阶玩法，新手可先跳过）

操作步骤：

（四）技能使用：说“人话”就行，不用手动切换

实战示例1：用summarize总结文本

实战示例2：用file-manager整理文件

实战示例3：用pdf-processor处理PDF

实战示例4：用tavily-web-search联网搜索

五、新手最容易踩的坑（避坑指南，少走弯路）

（一）部署与API问题

（二）技能安装与使用问题

（三）其他高频坑

六、实战：用OpenClaw完成1个完整工作流（从安装到落地）

步骤1：安装所需技能

步骤2：整理本地PDF资料

步骤3：提取PDF文本

步骤4：总结核心要点

步骤5：查看结果

七、总结：OpenClaw不难，关键“别想太多，直接动手”

热门文章

最新文章

相关电子书