gate-exchange-simpleearn

gate-cli の解決（バイナリパス）

gate-cli は次の順に解決します：（1） command -v gate-cli と gate-cli --version が成功すること、（2） 実行可能な場合は ${HOME}/.local/bin/gate-cli、（3） 実行可能な場合は ${HOME}/.openclaw/skills/bin/gate-cli。標準ルールについては、exchange-runtime-rules.md §4（または gate-runtime-rules.md §4）を参照してください。

Gate Exchange Simple Earn スキル

一般ルール

⚠️ 停止 — 続行する前に、共有ランタイムルールを必ず読み、厳守してください。 すべてのルールを読むまで、ツールを選択または呼び出してはいけません。これらのルールが最優先です。 → gate-runtime-rules.md を読んでください

• このスキルに明記されている gate-cli コマンドのみを使用してください。 ここに記載されていないコマンドは、他のインターフェースで使用できる場合でも、これらのワークフローでは実行してはいけません。

スキルの依存関係

使用する gate-cli コマンド

照会操作（読み取り専用）

• gate-cli cex earn uni change
• gate-cli cex earn uni currency
• gate-cli cex earn uni interest
• gate-cli cex earn fixed history
• gate-cli cex earn fixed lends
• gate-cli cex earn fixed products
• gate-cli cex earn fixed products-asset
• gate-cli cex earn uni rate
• gate-cli cex earn uni lends

実行操作（書き込み）

• gate-cli cex earn fixed create
• gate-cli cex earn fixed pre-redeem
• gate-cli cex earn uni lend

認証

• 対話形式でのファイル設定： ホスト上で GATE_API_KEY と GATE_API_SECRET の両方が設定されていない場合、gate-cli config init を実行し、API キー、シークレット、プロファイル、デフォルト値のウィザードを完了してください（gate-cli を参照）。
• 環境変数／フラグ： 認証情報がすでに指定されている場合は、gate-cli config init は不要です。たとえば、ホスト上で GATE_API_KEY と GATE_API_SECRET の両方が設定されている場合、または対応している場合に --api-key／--api-secret を使用する場合です。シークレットをチャットに貼り付けるようユーザーに求めてはいけません。
• 権限： Earn:Write
• ポータル： キーの作成またはローテーションはチャット外で行ってください：https://www.gate.com/myaccount/profile/api-key/manage

インストール確認

• 必須： gate-cli（見つからない場合は、このスキルのディレクトリから sh ./setup.sh を実行してください。GATE_CLI_SETUP_MODE=release は任意です）。
• gate-cli を名前で呼び出す場合は、$HOME/.openclaw/skills/bin（または setup.sh がインストールするディレクトリ）を PATH に追加してください。
• 認証情報： ホストに GATE_API_KEY と GATE_API_SECRET の両方が（空ではない値で）設定されている場合、gate-cli config init を必須としてはいけません。これは gate-cli の有効な設定と同等です。両方とも未設定または空の場合、オペレーターに gate-cli config init を実行するか、スキルライブラリ内の対応するスキルで GATE_API_KEY／GATE_API_SECRET を設定するよう通知してください（シークレットをチャットに貼り付けるようユーザーに求めてはいけません）。
• 動作確認： CLI が想定どおりに動作するまで、認証が必要な呼び出しに進んではいけません（例：gate-cli --version、またはこのスキルの読み取り専用 gate-cli cex ... コマンド）。変更操作の前に、認証情報が正しく解決されることを確認してください。

実行モード

references/gate-cli.md を読み、厳守したうえで、このスキルの Simple Earn ワークフローを実行してください。

• SKILL.md ではルーティングとビジネス上の制約を定めています。
• references/gate-cli.md は、照会とアクションの分離、確認ゲート、アクション後の検証に関する、権威ある gate-cli 実行契約です。

トリガー条件

ユーザーが次のいずれかの意図を表明した場合、このスキルを有効にします：

• Simple Earn、Uni、フレキシブル運用、固定運用、固定期間、申し込み、償還、ポジション、利息、最高 APY
• Simple Earn の申し込み、償還、ポジション照会、利息照会、固定期間商品の一覧、または固定期間の履歴照会に関するリクエスト

前提条件

• MCP の依存関係：gate-mcp をインストールする必要があります。
• 認証：ポジションの照会と書き込み操作には API キー認証が必要です。金利と通貨の照会は公開されています。
• 免責事項：APY または金利を表示する際は、必ず次の文言を末尾に追加してください：「この情報は参考目的のみであり、投資助言を構成するものではありません。APY は変更される場合があります。申し込みの前に、商品の条件をご確認ください。」

対応ワークフロー

フレキシブル（Uni）

• 単一通貨またはすべてのポジションの照会
• 単一通貨の利息照会
• 推定 APY の照会
• ユーザーの確認を伴う申し込み（貸し出し）、償還、最低金利の変更操作

定期型

• 商品一覧および通貨別の商品一覧
• ユーザーの確認を伴う申し込みと早期償還
• 現在のポジション総数および単一注文の詳細照会
• 申し込み、償還、利息、追加ボーナスの履歴照会

利用可能な MCP ツール

フレキシブル（Uni）

ツール	認証	説明	リファレンス
gate-cli cex earn uni rate	なし	通貨別の推定 APY（通貨の列挙。上限の確認には get_uni_currency と併用）	references/earn-uni-mcp-tools.md
gate-cli cex earn uni currency	なし	単一通貨の詳細（申し込み時の min_rate）	references/earn-uni-mcp-tools.md
gate-cli cex earn uni lend	あり	貸し出し（申し込み）または償還の実行	references/earn-uni-mcp-tools.md
gate-cli cex earn uni change	あり	貸し出しの min rate を変更	references/earn-uni-mcp-tools.md
gate-cli cex earn uni lends	あり	ユーザーのポジション（通貨による絞り込みは任意）	references/earn-uni-mcp-tools.md
gate-cli cex earn uni interest	あり	単一通貨の累積利息	references/earn-uni-mcp-tools.md
gate-cli cex earn uni rate	なし	通貨別の推定 APY（最高 APY の確認用）	references/earn-uni-mcp-tools.md

定期型

ツール	認証	説明	リファレンス
gate-cli cex earn fixed products	なし	定期型商品の一覧	references/fixed-earn-mcp-tools.md
gate-cli cex earn fixed products-asset	なし	通貨別の定期型商品の一覧	references/fixed-earn-mcp-tools.md
gate-cli cex earn fixed create	あり	定期型の貸し出し（申し込み）を実行	references/fixed-earn-mcp-tools.md
gate-cli cex earn fixed pre-redeem	あり	定期型注文を早期償還	references/fixed-earn-mcp-tools.md
gate-cli cex earn fixed lends	あり	ユーザーの定期型ポジション	references/fixed-earn-mcp-tools.md
gate-cli cex earn fixed history	あり	定期型の履歴記録	references/fixed-earn-mcp-tools.md

ルーティングルール

フレキシブル運用のリクエスト

ケース	ユーザーの意図	シグナルキーワード	アクション
1	申込（貸付）	"subscribe", "lend to Simple Earn"	通貨／金額／min_rateを収集して確認し、その後type: lendを指定してgate-cli cex earn uni lendを呼び出します。
2	償還	"redeem", "redeem from Simple Earn"	通貨／金額を収集して確認し、その後type: redeemを指定してgate-cli cex earn uni lendを呼び出します。
3	単一通貨のポジション	"my USDT Simple Earn", "position for one currency"	references/scenarios.mdのフレキシブル運用シナリオのセクションを参照してください
4	すべてのポジション	"all Simple Earn positions", "total positions"	references/scenarios.mdのフレキシブル運用シナリオのセクションを参照してください
5	単一通貨の利息	"interest", "USDT interest"	references/scenarios.mdのフレキシブル運用シナリオのセクションを参照してください
6	APY上位に申込	"top APY", "one-click subscribe top APY"	gate-cli cex earn uni rateでAPY上位を表示して確認を求め、その後gate-cli cex earn uni lendを呼び出します。
7	貸付設定の変更（例：最小金利）	"change min_rate", "change Simple Earn settings"	通貨／min_rateを収集して確認し、その後gate-cli cex earn uni changeを呼び出します。
8	認証エラー（401/403）	MCPが401/403を返す	キーを公開せず、Gate CEX APIキー（earn）の設定をユーザーに促します。

期間固定型運用のリクエスト

ケース	ユーザーの意図	シグナルキーワード	アクション
1	すべての期間固定型商品	"fixed-term products"	references/scenarios.mdの期間固定型セクション1とreferences/fixed-earn-mcp-tools.md §1を参照してください
2	通貨別の期間固定型商品	"USDT fixed-term products"	references/scenarios.mdの期間固定型セクション2とreferences/fixed-earn-mcp-tools.md §2を参照してください
3	期間固定型商品の申込	"subscribe 1 SOL fixed-term"	通貨／金額／期間を収集して確認し、その後gate-cli cex earn fixed createを呼び出します。
4	期間固定型商品の早期償還	"redeem order 5862443199"	order_idを収集して確認し、その後gate-cli cex earn fixed pre-redeemを呼び出します。
5	期間固定型商品の全ポジション	"total fixed-term positions", "current total fixed-term position amount"	order_type: "1"、page、limitを指定してgate-cli cex earn fixed lendsを呼び出します。
6	単一の期間固定型注文の詳細	"order 5862443199"	order_type: "1"とorder_idを指定してgate-cli cex earn fixed lendsを呼び出します。
7	期間固定型商品の履歴	"subscription records", "redeem records", "interest records"	type、page、limit、および任意の期間を指定してgate-cli cex earn fixed historyを呼び出します。
8	コンプライアンス／地域制限	地域制限に関する質問	APIがリクエストを拒否した場合は、標準のコンプライアンスエラーメッセージを返します。
9	コンプライアンスチェックの失敗	コンプライアンス検証に失敗	再試行や内部ロジックの公開は行わず、APIエラーメッセージがあればそれを返します。

実行

1. 上記の振り分けルールに基づいて、ユーザーの意図を特定します。
2. フレキシブル運用の申込／償還／APY上位への申込、および期間固定型商品の申込／早期償還では、必要なパラメーターを収集し、ユーザーに確認してから対応するMCPツールを呼び出します。
3. フレキシブル運用または期間固定型商品の読み取り専用クエリでは、references/scenarios.mdの該当するシナリオセクションを読み、そこに記載されたワークフローに従います。
4. 認証エラーの場合は、APIキーや未加工のエラーを公開せず、APIキーの設定または再ログインをユーザーに促します。
5. 意図が曖昧な場合は、振り分けの前に確認の質問をします。

ドメイン知識

フレキシブル（Uni）

• 購読（貸し出し）とは、ユーザーが指定した金額の通貨を Simple Earn プールに貸し出すことです。
• 償還とは、ユーザーがプールから指定した金額を償還することです。
• min_rate は、その通貨で許容できる最低時間利率です。貸し出しでは必須です。
• 精算時間帯：毎正時の前後2分間は、貸し出しと償還ができません（エラー処理やロジックでのみ使用してください。ユーザーから精算が適用される時間を明示的に尋ねられない限り、具体的な時刻やタイムスタンプをユーザーに表示しないでください）。
• ユーザー向け表示（フレキシブルのみ）：フレキシブル Uni MCP のデータに基づく返信では、時間関連のフィールドを表示しないでください。タイムスタンプ、日付、時刻、カウントダウン、チャートの時間軸、履歴の操作時刻、および発生した「時」を示す API フィールドを省略してください。時間以外の情報（通貨、金額、残高、利率／APY、interest_status、成功／失敗）のみを表示してください。ツールが時系列データのみ（例：APY チャート）を返す場合は、タイムスタンプを含めずに要約する（例：最新の推定 APY のみ）か、系列を省略してください。

固定期間

• 購読には、status=2（購読中）かつ show_status=2（表示中）の商品のみを使用します。
• 商品一覧のクエリは、通貨と商品タイプで絞り込めます。
• 固定期間のポジションと履歴は、references/scenarios.md および references/fixed-earn-mcp-tools.md で定義されている表形式で表示してください。
• 早期償還には固定期間の注文 ID を使用し、償還された元本が返されます。

安全ルール

• 書き込み MCP を呼び出す前に、必ず通貨、金額、および min_rate（フレキシブルの貸し出しの場合）、または通貨／金額／期間（固定期間の購読の場合）を確認してください。
• 固定期間の早期償還を呼び出す前に、必ず order_id を確認してください。
• 特定の通貨を推奨したり、利率を予測したりしないでください。
• API キー、内部エンドポイント URL、生のエラートレースをユーザーに決して公開しないでください。
• 負またはゼロの金額は拒否し、通貨がサポートされていることを確認してください。

エラー処理

条件	応答
認証エンドポイントが 401/403 を返す	「MCP で earn/account 権限を持つ Gate CEX API Key を設定してください。」キーや内部情報は公開しないでください。
フレキシブルの購読／償還、または固定期間の書き込みリクエストが検証に失敗する	入力を検証し、詳細を確認してから、該当する書き込みツールを呼び出してください。
ポジションまたは履歴のクエリに失敗する	「ポジション／履歴を読み込めません。API キーに earn/account の読み取り権限があることを確認してください。」
ポジションが空、または利率データがない	「ポジションが見つかりません。」／「現在、利率データを利用できません。」

参照ファイル

• フレキシブル（Uni）MCP ツール：references/earn-uni-mcp-tools.md
• 固定期間 MCP ツール：references/fixed-earn-mcp-tools.md
• プロンプトの例とルーティング：references/scenarios.md