gate-exchange-bot

Gate Exchange Bot

一般ルール

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

• このスキルに明記されている MCP ツールのみ呼び出してください。 MCP サーバーに存在していても、ここに記載されていないツールを呼び出してはいけません。
• このスキルとその参照先に明記されている gate-cli サブコマンドのみ使用してください。 他のインターフェースから利用できる場合でも、ここに記載されていないコマンドをこれらのワークフローで実行してはいけません。

作成言語

このスキルは英語で作成されています。エンドユーザーへの返信では、通常の言語適応に従ってください。

スキルの依存関係

使用するgate-cliコマンド

クエリー操作（読み取り専用）

• gate-cli cex bot strategy recommend
• gate-cli cex bot portfolio running
• gate-cli cex bot portfolio detail

実行操作（書き込み）

• gate-cli cex bot spot-grid create
• gate-cli cex bot margin-grid create
• gate-cli cex bot infinite-grid create
• gate-cli cex bot futures-grid create
• gate-cli cex bot spot-martingale create
• gate-cli cex bot contract-martingale create
• gate-cli cex bot portfolio stop

MCP によるコマンドの対応関係

gate-cli コマンド	対応するボット機能
gate-cli cex bot strategy recommend	cex_bot_get_ai_hub_strategy_recommend
gate-cli cex bot portfolio running	cex_bot_get_ai_hub_portfolio_running
gate-cli cex bot portfolio detail	cex_bot_get_ai_hub_portfolio_detail
gate-cli cex bot spot-grid create	cex_bot_post_ai_hub_spot_grid_create
gate-cli cex bot margin-grid create	cex_bot_post_ai_hub_margin_grid_create
gate-cli cex bot infinite-grid create	cex_bot_post_ai_hub_infinite_grid_create
gate-cli cex bot futures-grid create	cex_bot_post_ai_hub_futures_grid_create
gate-cli cex bot spot-martingale create	cex_bot_post_ai_hub_spot_martingale_create
gate-cli cex bot contract-martingale create	cex_bot_post_ai_hub_contract_martingale_create
gate-cli cex bot portfolio stop	cex_bot_post_ai_hub_portfolio_stop

認証

• 対話型ファイル設定： ホスト上で**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**がサポートされている場合です。ユーザーにシークレットをチャットに貼り付けるよう求めてはいけません。
• API キーが必要です：はい
• 権限： Bot:Read、Bot: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を**PATH**に追加してください。
• setup.shのホスト依存関係： curl、tar、およびshasumかsha256sumのいずれか。ユーザー領域へのインストールに失敗した場合、setup.shはsudo installを使用して/usr/local/binにインストールすることがあります。
• 認証情報： ホストに**GATE_API_KEYとGATE_API_SECRET**の両方が（空でない値で）設定されている場合、gate-cli config initを必須にしないでください。両方とも未設定または空の場合は、オペレーターにgate-cli config initを実行するか、チャット以外で対応する環境変数を設定するよう伝えてください。
• 動作確認： 変更を伴う呼び出しの前に、gate-cli --versionやgate-cli cex bot strategy recommend --helpなどの読み取り専用プローブで、CLIが想定どおりに動作することを確認してください。

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）を参照してください。

実行

references/gate-cli.md を読み、厳密に従ってから、この SKILL.md 内の該当するルートを実行してください。

• SKILL.md では、意図のルーティング、安全ポリシー、製品の境界を定めます。
• references/gate-cli.md は、コマンドのプローブ、body ペイロードの処理、確認ゲート、検証に関する正式な実行仕様です。
• references/scenarios.md には、レビュー、テスト、公開の完全性を確認するためのシナリオ形式の例があります。

ドメイン知識

• 戦略の推奨は読み取り専用であり、作成とは切り分ける必要があります。
• グリッドとマーチンゲールのフローでは異なるペイロードスキーマが必要です。製品間でフィールドを共有してはいけません。
• 実行中の戦略の停止は常に単一戦略へのアクションです。一括停止は対象外です。
• パーセンテージ形式のビジネス入力は、書き込みコマンドを実行する前に10進比率の文字列へ正規化する必要があります。
• ポートフォリオの詳細表示と停止フローでは、正確な strategy_id と適切な strategy_type が必要です。

モジュール概要

モジュール	説明	トリガーキーワード
Discover	市場、戦略タイプ、フィルター、または更新コンテキストに基づいて、AIHub ボット戦略を推奨します	recommend strategy, bundle, top1, refresh recommendation, filter strategy
Spot Grid	手動の現物グリッド作成	spot grid, manual grid
Margin Grid	手動のマージングリッド作成	margin grid
Infinite Grid	手動のインフィニットグリッド作成	infinite grid
Futures Grid	手動の先物グリッド作成	futures grid, contract grid
Spot Martingale	手動の現物マーチンゲール作成	spot martingale
Contract Martingale	手動のコントラクトマーチンゲール作成	contract martingale, futures martingale
Portfolio List	実行中の戦略を一覧表示します	running strategies, bots I have running, portfolio running
Portfolio Detail	単一の戦略の詳細を照会します	strategy detail, bot detail, P&L detail
Portfolio Stop	実行中の戦略を1つ停止します	stop strategy, stop bot

ルーティングルール

意図	フレーズの例	ルート先
戦略の推奨	「BTC 戦略を推奨して」「現物グリッドの推奨を教えて」「その推奨を更新して」	references/strategy-recommend.md を読む
現物グリッドの作成	「60000 から 72000 の範囲で、グリッド数 50、1000 USDT の BTC 現物グリッドを作成して」	references/create-spot-grid.md を読む
マージングリッドの作成	「レバレッジ 3 倍、グリッド数 50 のマージングリッドを作成して」	references/create-margin-grid.md を読む
インフィニットグリッドの作成	「グリッドあたりの利益率が 1.5% の BTC インフィニットグリッドを作成して」	references/create-infinite-grid.md を読む
先物グリッドの作成	「レバレッジ 5 倍、中立方向の BTC 先物グリッドを作成して」	references/create-futures-grid.md を読む
現物マーチンゲールの作成	「2% 下落したら追加する現物マーチンゲールを作成して」	references/create-spot-martingale.md を読む
コントラクトマーチンゲールの作成	「レバレッジ 5 倍、ショート寄りのコントラクトマーチンゲールを作成して」	references/create-contract-martingale.md を読む
実行中の一覧	「実行中のボットは何がありますか？」	references/list-running.md を読む
戦略の詳細	「そのボットの損益の詳細を表示して」	references/get-detail.md を読む
戦略の停止	「その BTC グリッドボットを停止して」	references/stop-strategy.md を読む

gate-cli コマンド一覧

#	コマンド	目的
1	gate-cli cex bot strategy recommend	top1、bundle、filter、refresh のシーンに関するおすすめを見つけます
2	gate-cli cex bot spot-grid create	手動で現物グリッドを作成します
3	gate-cli cex bot margin-grid create	手動でマージングリッドを作成します
4	gate-cli cex bot infinite-grid create	手動で無限グリッドを作成します
5	gate-cli cex bot futures-grid create	手動で先物グリッドを作成します
6	gate-cli cex bot spot-martingale create	手動で現物マーチンゲールを作成します
7	gate-cli cex bot contract-martingale create	手動でコントラクトマーチンゲールを作成します
8	gate-cli cex bot portfolio running	実行中のストラテジーを一覧表示します
9	gate-cli cex bot portfolio detail	1 つのストラテジーの詳細を照会します
10	gate-cli cex bot portfolio stop	1 つのストラテジーを停止します

実行ワークフロー

1. 意図の分類

• リクエストが 検出、手動作成、ポートフォリオ のいずれにあたるかを判断します。
• 手動作成の場合は、参照ファイルを読む前に、正確なボットタイプを特定します。
• ポートフォリオの場合は、ユーザーが 一覧表示、詳細、停止 のどれを求めているかを特定します。

2. パラメーターの取り扱い

• おすすめのフローでは、クエリ形式のパラメーターのみを使用します。
• 作成と停止のフローでは、最終的な業務ペイロードを JSON 文字列として body に渡します。
• パーセンテージ形式の入力は、書き込みコマンドを実行する前に、該当するリファレンスドキュメントの指定どおりに正規化する必要があります。

3. シナリオの網羅

• 公開向けのシナリオ一覧として references/scenarios.md を使用します。
• 詳細なパラメーターとガードレールのルールについては、モジュール固有のリファレンスファイルを使用します。

安全ルール

確認

• おすすめの取得と読み取り専用のポートフォリオ照会には、確認は不要です。
• 書き込みを伴うすべての操作では、最初に操作案または確認用の概要を提示する必要があります。
• 作成または停止の操作はそれぞれ、直後のターンでユーザーから個別に確認を得る必要があります。
• ユーザーが明示的に確認しない場合、書き込みコマンドを実行してはいけません。

検証

• HTTP 200 だけを根拠に成功と判断してはいけません。
• 返されたペイロードの code、message、主要な data フィールドを必ず確認します。
• 書き込みに失敗した場合、しきい値や非公開の制限を作り上げず、バックエンドの message を忠実に返します。

エラー処理

• 認証または権限のエラー：書き込みを停止し、オペレーターに gate-cli config init またはホスト側での認証情報の復旧を案内します。
• 業務上必要な入力が不足している、または曖昧な場合：不足している項目のみを尋ね、推測してはいけません。
• バックエンドのペイロードが無効、または業務ルールにより拒否された場合：バックエンドの message を提示し、修正されるまで処理を中断します。
• 停止対象が曖昧な場合：停止を試みる前に、実行中の一覧から選択するフローに切り替えます。

データとプライバシー

• ユーザーのプロンプト、ストラテジーのパラメーター、コマンドのペイロードは、依頼されたボット操作に必要な範囲で、ホストランタイム、gate-cli、Gate API を経由します。
• このスキルでは、独自の追加テレメトリー、分析、カスタム永続化の仕組みは定義していません。
• オペレーターの環境によっては、ローカルのシェル履歴、ターミナルログ、ホスト側の監査ログが残る場合があります。
• API シークレットをチャットに貼り付けるようユーザーに求めてはいけません。認証情報は gate-cli config init または同等の安全なホスト側環境管理を通じて設定する必要があります。

重要な境界

• 教育のみ、または相談のみを目的とする質問を、書き込み操作に変えてはいけません。
• 範囲、グリッド数、レバレッジ、方向、マーチンゲールの偏差、損切り比率などの主要なストラテジーパラメーターを推測してはいけません。
• 一括停止には対応していません。停止リクエストが曖昧な場合は、実行中の一覧から選択した後、単一ストラテジーの停止確認を行う必要があります。
• おすすめ、作成、一覧表示、詳細、単一の停止を超える高度な実行中ストラテジー管理は、リファレンスファイルに明示的に記載されていない限り対象外です。