E-MapReduce:EMR エージェントスキルを使用したクラスターの管理

Alibaba Cloud CLI のインストール

このエージェントスキルは、Alibaba Cloud CLI を使用してクラウドリソースを管理します。バージョン 3.3.1 以降がインストールされていることを確認してください：

# macOS の場合
brew install aliyun-cli

# または、公式スクリプトを使用
curl -fsSL https://aliyuncli.alicdn.com/aliyun-cli-install.sh | bash

# バージョンを確認
aliyun version

Alibaba Cloud 認証情報の設定

# 対話型設定
aliyun configure
# AccessKey ID、AccessKey Secret、およびデフォルトリージョンを入力します。

または、環境変数を使用して設定することもできます：

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 ユーザーまたはロールを使用することを推奨します。

方法 1：npx skills CLI の使用 (推奨)

すべての公式 Alibaba Cloud スキルは GitHub リポジトリ aliyun/alibabacloud-aiops-skills でホストされており、npx skills を使用して単一のコマンドでインストールできます。

# EMR on ECS クラスター管理スキルをインストール
npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-emr-cluster-manage

方法 2：手動インストール

プロジェクトのルートディレクトリにある .claude/skills/ ディレクトリにスキルディレクトリを配置します：

your-project/
└── .claude/
    └── skills/
        └── alibabacloud-emr-cluster-manage/
            ├── SKILL.md
            └── references/

ユーザーレベルのディレクトリ ~/.claude/skills/ にインストールすることもでき、これによりすべてのプロジェクトで使用可能になります。

使用方法

インストール後、自然言語を使用して Claude Code と対話します。エージェントは自動的に適切なスキルを照合してロードします。例：

• 「Hadoop クラスターを作成してください。」

• 「コアノードが 3 つあるデータレイククラスターを作成してください。」

• 「クラスター c-xxx のステータスを確認してください。」

• 「タスクノードをさらに 2 つ追加してクラスターをスケールアウトしてください。」

• 「クラスターを 3 ヶ月間更新してください。」

仕組み：Claude Code が起動すると、.claude/skills/ ディレクトリをスキャンし、各 SKILL.md ファイルから name と description のメタデータを読み取ります。ユーザーのリクエストがスキルの説明と一致すると、エージェントはそのスキルの完全なコンテンツを自動的にロードし、指示に従って実行します。

高度な設定：alibabacloud-find-skills のインストール (オプション)

alibabacloud-find-skills はメタスキルです。インストール後、エージェントは他の Alibaba Cloud スキルを自動的に検索、参照、インストールできます。

npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-find-skills

インストール後、自然言語を使用してエージェントに他の Alibaba Cloud スキルを検索・インストールさせることができます。例えば、「ECS を管理するスキルを探して」 や 「Alibaba Cloud にはどんなデータベース関連のスキルがありますか？」 などです。この機能は、aliyun CLI >= 3.3.1 と agentexplorer プラグインに依存します。

OpenClaw のインストール

# macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bash

# インストールを確認 (Node.js >= 22.0 が必要)
openclaw --version

方法 1：npx skills CLI の使用 (推奨)

Claude Code と同様に、npx skills を使用して公式 GitHub リポジトリからインストールします。

npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-emr-cluster-manage

インストール中に、プロジェクトレベルまたはグローバルレベルのインストールを選択します。インストール後、次のコマンドを実行して確認します：

openclaw skills list

方法 2：手動インストール

スキルディレクトリを次のいずれかの場所 (優先度の高い順) にコピーします：

使用方法

OpenClaw を起動し、自然言語で直接対話してください：

# ターミナルモード
openclaw tui

# または Web モード
openclaw dashboard

チャットでコマンドを入力すると、エージェントが自動的にスキルを照合します：

• 「Hadoop クラスターを作成してください」

• 「コアノードが 3 つあるデータレイククラスターを作成してください」

• 「クラスター c-xxx 内のノードを一覧表示してください」

セキュリティの推奨事項：HITL プラグインのインストール

Alibaba Cloud HITL (ヒューマンインザループ) プラグインのインストールを推奨します。このプラグインは、高リスクなクラウドリソース操作を自動的にインターセプトし、手動での確認を要求します：

openclaw plugins install @alicloud/alibabacloud-hitl-claw-plugin

インストール後、クラウドリソースを作成または変更する操作は一時停止され、実行前にターミナルでの確認が必要になります。

Q1：インストール後にスキルが機能しない

• Claude Code：スキルディレクトリが .claude/skills/ にあり、SKILL.md ファイルが含まれていることを確認してください。

• OpenClaw：openclaw skills list を実行して、スキルがロードされていることを確認してください。

• エージェントセッションを再起動して、もう一度お試しください。

Q2：スキルはロードされるがコマンドが失敗する

• Alibaba Cloud CLI がインストールされ、認証情報が設定されていることを確認してください (aliyun configure list)。

• RAM ユーザーが必要な EMR 権限を持っていることを確認してください。

• 正しいリージョンが指定されていることを確認してください。

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：スキルを更新するにはどうすればよいですか？

# 更新を確認
npx skills check

# 更新を実行
npx skills update