alibabacloud-emr-cluster-manage 是阿里云 EMR 提供的 Agent Skill,可在 Claude Code 或 OpenClaw 中通过自然语言管理 EMR on ECS 集群。支持创建集群、TASK 节点扩缩容、续费管理、状态查询和故障诊断等操作,帮助您提升集群运维效率。
Skill 概述
alibabacloud-emr-cluster-manage 用于管理阿里云 EMR on ECS 集群的全生命周期,通过自然语言交互即可完成常见运维操作。
|
能力 |
说明 |
|
创建集群 |
支持 Hadoop、Data Lake、Dataflow、Custom 多种集群类型。 |
|
扩缩容 |
TASK 节点组扩缩容、配置弹性伸缩规则。 |
|
续费管理 |
包年包月集群续费、资源组续费。 |
|
状态查询 |
查看集群/节点组/节点状态、服务部署情况。 |
|
故障诊断 |
创建失败原因排查、操作日志查询。 |
|
安全限制 |
不支持删除/释放集群,必须通过控制台操作。 |
适用场景:"建个 Hadoop 集群"、"数据湖集群"、"资源不够了"、"帮我看看集群"、"续费"等。
前置条件
安装阿里云 CLI
Agent Skill 依赖阿里云 CLI 执行云资源操作,请先安装并确认版本 >= 3.3.1。
# macOS
brew install aliyun-cli
# 或通过官方脚本
curl -fsSL https://aliyuncli.alicdn.com/aliyun-cli-install.sh | bash
# 验证版本
aliyun version
配置阿里云凭据
# 交互式配置
aliyun configure
# 输入 AccessKey ID、AccessKey Secret、默认 Region
或通过环境变量配置:
export ALIBABACLOUD_ACCESS_KEY_ID="your-ak"
export ALIBABACLOUD_ACCESS_KEY_SECRET="your-sk"
export ALIBABACLOUD_REGION_ID="cn-hangzhou"
确保 RAM 权限
操作 EMR on ECS 资源需要对应的 RAM 权限,建议使用包含 EMR 相关权限的 RAM 用户或角色。
在 Claude Code 中安装和使用
安装方式一:使用 npx skills CLI(推荐)
所有阿里云官方 Skills 均托管在 GitHub 仓库 aliyun/alibabacloud-aiops-skills,通过 npx skills 命令一键安装:
# 安装 EMR on ECS 集群管理 Skill
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-emr-cluster-manage
安装方式二:手动安装
将 Skill 目录放置到项目根目录下的 .claude/skills/ 目录中:
your-project/
└── .claude/
└── skills/
└── alibabacloud-emr-cluster-manage/
├── SKILL.md
└── references/
也可安装到用户级目录 ~/.claude/skills/,这样所有项目都可使用。
使用 Skill
安装完成后,在 Claude Code 中用自然语言交互即可,Agent 会自动匹配并加载对应 Skill。示例:
-
"帮我创建一个 Hadoop 集群"
-
"建个数据湖集群,3 台 CORE 节点"
-
"帮我看看集群 c-xxx 的状态"
-
"给集群扩容 2 个 TASK 节点"
-
"集群续费 3 个月"
工作原理:Claude Code 启动时扫描 .claude/skills/ 目录,读取每个 SKILL.md 的 name 和 description 元数据。当用户请求匹配某个 Skill 的描述时,Agent 自动加载该 Skill 的完整内容并按指令执行。
进阶:安装 alibabacloud-find-skills(可选)
alibabacloud-find-skills 是一个元技能(Meta Skill),安装后 Agent 可以自动搜索、浏览和安装其他阿里云 Skills:
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-find-skills
安装后,用户可以通过自然语言让 Agent 搜索并安装其他阿里云 Skills,例如:"帮我找一个管理 ECS 的 Skill"、"阿里云有哪些数据库相关的 Skill"。它依赖 aliyun CLI >= 3.3.1 和 agentexplorer 插件。
在 OpenClaw 中安装和使用
安装 OpenClaw
# macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bash
# 验证安装(需 Node.js >= 22.0)
openclaw --version
安装方式一:使用 npx skills CLI(推荐)
与 Claude Code 相同,通过 npx skills 从官方 GitHub 仓库安装:
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-emr-cluster-manage
安装时可选择 project 级别或 global 级别。安装后验证:
openclaw skills list
安装方式二:手动安装
将 Skill 目录复制到以下任一位置(按优先级从高到低):
|
优先级 |
路径 |
说明 |
|
1 |
|
工作空间级,最高优先 |
|
2 |
|
项目 Agent 级 |
|
3 |
|
用户 Agent 级 |
|
4 |
|
用户 OpenClaw 级 |
使用 Skill
启动 OpenClaw 后直接用自然语言交互:
# 终端模式
openclaw tui
# 或 Web 模式
openclaw dashboard
在对话中输入指令,Agent 自动匹配 Skill:
-
"帮我创建一个 Hadoop 集群"
-
"建个数据湖集群,3 台 CORE 节点"
-
"查看集群 c-xxx 的节点列表"
安全建议:安装 HITL 插件
建议安装阿里云 HITL(Human-in-the-Loop)插件,对高风险云资源操作自动拦截并要求人工确认:
openclaw plugins install @alicloud/alibabacloud-hitl-claw-plugin
安装后,创建或修改云资源的操作会暂停,等待用户在终端确认后才执行。
平台对比一览
|
特性 |
Claude Code |
OpenClaw |
|
Skill 安装目录 |
|
|
|
推荐安装方式 |
|
|
|
Skill 发现机制 |
启动时扫描目录,按元数据匹配 |
启动时扫描目录,按元数据匹配 |
|
交互方式 |
终端 CLI |
终端 TUI 或 Web Dashboard |
|
HITL 安全插件 |
无内置(需配合 permission mode) |
支持 |
常见问题
Q1: 安装后 Skill 不生效?
-
Claude Code:确认 Skill 目录位于
.claude/skills/下,且包含SKILL.md文件。 -
OpenClaw:运行
openclaw skills list确认 Skill 已加载。 -
重启 Agent 会话后再试。
Q2: Skill 加载了但执行报错?
-
确认阿里云 CLI 已安装并配置凭据(
aliyun configure list)。 -
确认 RAM 用户有 EMR 相关的操作权限。
-
检查 Region 是否正确。
Q3: npx skills 安装到了错误目录?
npx skills 默认安装到 ~/.agents/skills/,而 Claude Code 扫描 ~/.claude/skills/。解决方法:
# 创建符号链接
ln -s ~/.agents/skills/alibabacloud-emr-cluster-manage ~/.claude/skills/
或在 ~/.claude/settings.json 中配置 SessionStart Hook 自动同步。
Q4: 如何更新 Skill?
# 检查更新
npx skills check
# 执行更新
npx skills update