gate-exchange-collateralloan

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 マルチ担保ローン スキル

全般的なルール

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

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

スキルの依存関係

使用する gate-cli コマンド

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

• gate-cli cex mcl current-rate
• gate-cli cex mcl fix-rate
• gate-cli cex mcl ltv
• gate-cli cex mcl order
• gate-cli cex mcl orders
• gate-cli cex mcl records
• gate-cli cex mcl repay-records
• gate-cli cex mcl quota
• gate-cli cex mcl collateral

実行操作（書き込み）

• gate-cli cex mcl create
• gate-cli cex mcl repay

認証

• 対話式のファイル設定： ホスト上で 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 を指定する場合です。シークレットをチャットに貼り付けるようユーザーに求めてはいけません。
• 権限： Mcl: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 を読み、厳密に従ってください。

• SKILL.md ではルーティングと商品上の制約を扱います。
• references/gate-cli.md は、クォータ／LTV の事前確認、確認ゲート、操作後の検証に関する、gate-cli 実行契約の正式な基準です。

トリガー条件

このスキルは、ユーザーがマルチ担保ローンの操作について尋ねたときに有効になります。ルーティングルール（ケース 1～7）に従って意図を分類してください。トリガーとなる語句には、「担保ローン」、「現在のローン」、「固定ローン」、「返済」、「担保を追加」、「担保を償還」、または他の言語での同等の表現が含まれます。

ワークフロー

ステップ 1：意図を分類する

ルーティングルール（ケース 1～7）を使用して、ユーザーの意図を特定します。必要な入力（order_id、通貨、金額、固定期間）が不足している場合は、先に確認の質問をします。

ステップ 2：読み取り専用のリクエスト（レート、LTV、クォータ、注文）

ユーザーがレート、LTV、クォータ、注文一覧、または注文詳細を尋ねた場合は、対応する MCP ツールを呼び出します。

次のコマンドを呼び出します。gate-cli cex mcl quota

• type：collateral または borrow
• currency：カンマ区切り（borrow の場合は単一通貨）

次のコマンドを呼び出します。gate-cli cex mcl ltv

• （パラメーターなし）

次のコマンドを呼び出します。gate-cli cex mcl fix-rate

• （パラメーターなし）

次のコマンドを呼び出します。gate-cli cex mcl current-rate

• currencies：カンマ区切りの通貨リスト

次のコマンドを呼び出します。gate-cli cex mcl orders

• page、limit（任意）
• sort（任意）：time_desc、ltv_asc、ltv_desc
• order_type（任意）：current または fixed

次のコマンドを呼び出します。gate-cli cex mcl order

• order_id

抽出する重要なデータ：

• LTV のしきい値、固定／現在のレート、クォータの行、order_id、注文ステータス、担保と借入の詳細

ステップ 3：ローンを作成する（変動または固定）

変動ローンの場合：

1. 下書きを作成します（担保リスト＋借入通貨／金額）。
2. 確認を求めます。
3. gate-cli cex mcl create を order とともに呼び出します。order は JSON 文字列です（borrow_currency、borrow_amount、collateral_currencies、order_type: current）。

固定ローンの場合：

1. gate-cli cex mcl fix-rate を呼び出します（リストが返されます）。borrow_currency で絞り込み、rate_7d または rate_30d を fixed_rate として使用します（時間あたりのレートです。変換したり、年率／日率と表記し直したりせず、そのまま渡してください）。
2. fixed_type と fixed_rate を含む下書きを作成します（表示する場合は、時間あたりのレートであることをユーザーに説明します）。
3. 確認を求めます。
4. gate-cli cex mcl create を order とともに呼び出します。order は order_type: fixed、fixed_type 7d／30d、fixed_rate を含む JSON です。

ステップ 4：返済する

下書きを作成して確認を求めた後、次の内容を指定して gate-cli cex mcl repay を呼び出します。

• repay_loan：order_id と repay_items [{ currency, amount, repaid_all }] を含む JSON 文字列

ステップ 5：担保を追加または償還する

下書きを作成して確認を求めた後、次の内容を指定して gate-cli cex mcl collateral を呼び出します。

• collateral_adjust：order_id、type（append | redeem）、collaterals [{ currency, amount }] を含む JSON 文字列

判定ロジックの概要

• キーワードと必須入力（ローン作成／返済／追加／償還／一覧）に基づいてケースを判断します。
• 固定ローンには fix_rate の照会が必要です。利用できない場合は処理を中止し、ユーザーに伝えます。
• 書き込み操作はすべて、MCP を呼び出す前に確認を得る必要があります。
• 認証エラー（401/403）の場合は、API キーの設定を案内します。

レポートテンプレート

確認を求める場合： 下書き：

• 種別：{current|fixed|repay|append|redeem}
• Order ID：{該当する場合は order_id}
• 借入：{borrow_amount} {borrow_currency}
• 担保：{collateral_amounts}
• 固定期間／レート：{fixed_type} / {fixed_rate}（時間あたりのレート）

続行するには確認してください。

成功時：

• 操作の概要と主要な識別情報（order_id、金額）。 失敗時：
• エラーメッセージと次の手順の案内（例：通貨／金額／LTV を確認）。

前提条件

• MCP の依存関係：gate-mcp をインストールする必要があります。
• 認証：注文一覧、注文詳細、返済、担保、クォータ、履歴には API キーが必要です。LTV、固定レート、現在のレートはキーなしで利用できる公開情報です。
• 免責事項：ローンおよび LTV の情報は参考目的であり、投資助言ではありません。借入の前に、商品の利用条件と清算リスクを理解してください。

利用可能な MCP ツール

ツール	認証	説明	リファレンス
gate-cli cex mcl fix-rate	不要	7日／30日の固定金利（一覧）	references/mcl-mcp-tools.md
gate-cli cex mcl ltv	不要	LTV のしきい値	references/mcl-mcp-tools.md
gate-cli cex mcl current-rate	不要	現在の金利	references/mcl-mcp-tools.md
gate-cli cex mcl quota	必要	借入／担保の上限	references/mcl-mcp-tools.md
gate-cli cex mcl create	必要	ローンの作成（order JSON）	references/mcl-mcp-tools.md
gate-cli cex mcl orders	必要	注文一覧	references/mcl-mcp-tools.md
gate-cli cex mcl order	必要	注文の詳細	references/mcl-mcp-tools.md
gate-cli cex mcl repay	必要	返済（repay_loan JSON）	references/mcl-mcp-tools.md
gate-cli cex mcl collateral	必要	担保の追加／償還（collateral_adjust JSON）	references/mcl-mcp-tools.md
gate-cli cex mcl repay-records	必要	返済履歴	references/mcl-mcp-tools.md
gate-cli cex mcl records	必要	担保履歴	references/mcl-mcp-tools.md

ルーティングルール

ケース	ユーザーの意図	キーワード	アクション
1	現在金利ローンの作成	"current loan", "pledge... borrow... (current)"	references/scenarios.md のシナリオ 1 を参照
2	固定金利ローンの作成	"fixed loan", "borrow... for 7/30 days"	references/scenarios.md のシナリオ 2 を参照
3	返済	"repay", "repay order..."	references/scenarios.md のシナリオ 3 を参照
4	担保の追加	"add collateral", "add margin"	references/scenarios.md のシナリオ 4 を参照
5	担保の償還	"redeem collateral", "reduce margin"	references/scenarios.md のシナリオ 5 を参照
6	注文一覧／注文の詳細	"loan orders", "order detail", "my orders"	gate-cli cex mcl orders ／ gate-cli cex mcl order — ユーザー向けの返信には、いかなる時間／日付フィールドも絶対に含めないでください（下記の「表示」を参照）
7	認証エラー（401/403）	MCP が 401/403 を返す	キーを開示せず、Gate CEX API Key（マルチ担保ローン）の設定をユーザーに促します。

実行

1. 上記のルーティングルール表から、ユーザーの意図を特定します。
2. ケース 1～5 の場合：references/scenarios.md の該当するシナリオを読み、ワークフローに従います（注文案を提示し、ユーザーの確認後にのみ MCP を呼び出します）。
3. ケース 6 の場合：必要に応じて一覧または詳細取得ツールを呼び出します。読み取り専用のため、確認は不要です。返信には、borrow_time、maturity、due date、operate_time、create_time、repay_time、Unix タイムスタンプ、その他あらゆる時間関連フィールドを絶対に表示しないでください。ユーザーが日付／時刻を尋ねた場合も同様です。タイミングの詳細は Gate アプリまたはウェブで確認するよう案内します。
4. ケース 7 の場合：API キーや生のエラーを開示せず、MCP でマルチ担保ローンの権限を持つ Gate CEX API Key を設定するようユーザーに促します。
5. ユーザーの意図が曖昧な場合（例：order_id、通貨、金額が不足している場合）は、ルーティングする前に確認の質問をします。

ドメイン知識

基本概念

• 現在金利ローン：変動金利ローンです。order JSON の order_type: current を指定して、gate-cli cex mcl create で作成します。
• 固定金利ローン：7日／30日ローンです。order JSON には order_type: fixed、fixed_type：7d または 30d（小文字）、fixed_rate：gate-cli cex mcl fix-rate から取得した時間あたりの金利を含める必要があります（該当する borrow_currency の rate_7d または rate_30d をそのまま渡し、年利や日利として説明しないでください）。固定金利関連のフィールドがないと、INVALID_PARAM_VALUE が返されることがあります。
• 返済：repay_loan JSON を指定して gate-cli cex mcl repay を実行します。
• 担保の追加：gate-cli cex mcl collateral の collateral_adjust で type: append を指定します。
• 担保の償還：同じツールで type: redeem を指定します。
• LTV：gate-cli cex mcl ltv — init_ltv、alert_ltv、liquidate_ltv。

ローン作成フロー（ケース 1 および 2）

1. 担保、借入通貨／金額を解析します。期間は、7 日なら 7d、30 日なら 30d に固定します。
2. 変動金利：必要に応じて gate-cli cex mcl quota または現在の金利ツールを使用します。確認後、order JSON を指定して gate-cli cex mcl create を実行します。
3. 固定金利：gate-cli cex mcl fix-rate を実行し、借入通貨でリストを絞り込みます。結果が空、または該当する行がない場合は、ユーザーにその旨を伝えて終了します。それ以外の場合は、fixed_rate に rate_7d または rate_30d を設定します（時間単位の金利です。そのまま order JSON に渡してください。年利または日利と説明してはいけません）。確認後、固定金利用のフィールドを含む order JSON を指定します。

返済フロー（ケース 3）

1. order_id と返済額（または全額）を解析します。
2. 確認用の内容を表示します。確認後、repay_loan JSON を指定して gate-cli cex mcl repay を実行します。

担保の追加／償還フロー（ケース 4 および 5）

1. order_id と担保の金額／通貨を解析します。
2. 確認用の内容を表示します。確認後、collateral_adjust JSON を指定して gate-cli cex mcl collateral を実行します。

表示 — 注文一覧／注文詳細（ケース 6）

ユーザーが自分の担保ローン注文または注文詳細の表示を求めた場合：

• 時刻情報なし：時刻や日付に関する情報は一切出力しないでください。MCP から取得したタイムスタンプ形式のフィールド（例：borrow_time、満期、返済期限、operate_time、create_time、repay_time、暦日、日付としての Unix 秒）はすべて省略します。これらのフィールドから算出した相対的な期間（例：「あと 3 日で期限切れです」）に言い換えることも禁止です。
• 回答で使用できる情報：order_id、status、借入側（通貨、元本／未払い利息）、担保側（通貨、金額）、取得できる場合は現在の LTV、固定期間を示すラベルのみの fixed_type 7d／30d（暦日は含めません）。
• ユーザーが日付や満期を具体的に尋ねた場合：ここでは時期を表示できないため、注文スケジュール全体を確認するには Gate（アプリ／ウェブ）を開くよう案内します。それでも、API の時刻フィールドをチャットに貼り付けてはいけません。

安全ルール

• 書き込み操作（gate-cli cex mcl create、gate-cli cex mcl repay、gate-cli cex mcl collateral）：実行前に、必ず明示的な確認を取り、注文内容の確認用表示を行ってください。
• 投資助言をしない：LTV／金利を提示し、判断はユーザーに委ねます。
• 機密データ：API キーや内部エラーの生データを決して公開しないでください。
• 金額：0 以下の金額は拒否してください。返済／担保操作では order_id を検証してください。
• 注文表示：注文一覧／詳細への回答で、時刻の列、日付、タイムスタンプフィールドをユーザーに決して表示しないでください。

エラー処理

条件	応答
401/403	"Gate CEX API キーにマルチ担保ローンの権限を設定してください。"
gate-cli cex mcl create が失敗	order JSON を確認します。借入関連フィールド、および固定金利の場合は fixed_type 7d／30d と、fix_rate ツールから取得した fixed_rate を確認します。
fixed_type が不正	7d または 30d（小文字）である必要があります。
固定金利が空	"固定金利を一時的に利用できません。後でもう一度試すか、変動金利ローンをご利用ください。"
返済／操作が失敗	JSON ペイロード内の order_id、通貨、金額を確認します。
注文が見つからない	"注文が見つかりません。" / "ローン注文はありません。"

プロンプト例とシナリオ

プロンプト例と想定される動作（変動／固定金利での作成、返済、担保の追加、担保の償還）については、references/scenarios.md を参照してください。