gate-exchange-referral

name: gate-exchange-referral description: "Gate invite-friends and referral campaign skill. Use when the user asks about invitation rewards, referral links, or earn-together rules. Triggers on 'invite friends', 'referral reward', 'referral link', 'earn together'." user-invocable: true disable-model-invocation: false metadata: openclaw: emoji: "💱" os: - darwin - linux primaryEnv: GATE_API_KEY requires: bins: - gate-cli env: - GATE_API_KEY - GATE_API_SECRET

install:
  - kind: download
    os:
      - linux
    url: "https://github.com/gate/gate-cli/releases/download/v0.6.2/gate-cli_0.6.2_linux_amd64.tar.gz"
    bins:
      - gate-cli
    targetDir: "bin"
    label: "Download gate-cli (Linux x64)"
  - kind: download
    os:
      - linux
    url: "https://github.com/gate/gate-cli/releases/download/v0.6.2/gate-cli_0.6.2_linux_arm64.tar.gz"
    bins:
      - gate-cli
    targetDir: "bin"
    label: "Download gate-cli (Linux arm64)"
  - kind: download
    os:
      - darwin
    url: "https://github.com/gate/gate-cli/releases/download/v0.6.2/gate-cli_0.6.2_darwin_amd64.tar.gz"
    bins:
      - gate-cli
    targetDir: "bin"
    label: "Download gate-cli (macOS Intel)"
  - kind: download
    os:
      - darwin
    url: "https://github.com/gate/gate-cli/releases/download/v0.6.2/gate-cli_0.6.2_darwin_arm64.tar.gz"
    bins:
      - gate-cli
    targetDir: "bin"
    label: "Download gate-cli (macOS Apple Silicon)"

Resolving gate-cli (binary path)

Resolve gate-cli in order: (1) command -v gate-cli and gate-cli --version succeeds; (2) ${HOME}/.local/bin/gate-cli if executable; (3) ${HOME}/.openclaw/skills/bin/gate-cli if executable. Canonical rules: exchange-runtime-rules.md §4 (or gate-runtime-rules.md §4).

Gate Invite Friends Activity Recommendation & Rule Interpretation

General Rules

⚠️ STOP — You MUST read and strictly follow the shared runtime rules before proceeding. Do NOT select or call any tool until all rules are read. These rules have the highest priority. → Read gate-runtime-rules.md

• Only use the gate-cli commands explicitly listed in this skill. Commands not documented here must NOT be run for these workflows, even if other interfaces expose them.

Skill Dependencies

Authentication

• Interactive file setup: when GATE_API_KEY and GATE_API_SECRET are not both set on the host, run gate-cli config init to complete the wizard for API key, secret, profiles, and defaults (see gate-cli).
• Env / flags: gate-cli config init is not required when credentials are already supplied — e.g. both GATE_API_KEY and GATE_API_SECRET set on the host, or --api-key / --api-secret where supported — never ask the user to paste secrets into chat.
• API Key Required: May be required, depending on runtime and whether account-specific referral data is needed
• Note: The main workflow in this skill is read-only guidance and rule interpretation. Account-scoped rebate or referral-detail queries may require authenticated Exchange MCP access in some deployments.

Installation Check

• Required: gate-cli (run sh ./setup.sh from this skill directory if missing; optional GATE_CLI_SETUP_MODE=release).
• Add $HOME/.openclaw/skills/bin to PATH if you invoke gate-cli by name (or the directory where setup.sh installs it).
• Credentials: When GATE_API_KEY and GATE_API_SECRET are both set (non-empty) for the host, do not require gate-cli config init — that is equivalent valid config for gate-cli. When both are unset or empty and authenticated referral data is needed, remind the operator to run gate-cli config init or to configure GATE_API_KEY / GATE_API_SECRET in the matching skill from the skill library (never ask the user to paste secrets into chat).
• Sanity check: Confirm the CLI works for this setup (e.g. gate-cli --version or a documented read in this skill) before relying on authenticated referral queries.

Execution mode

Read and strictly follow references/gate-cli.md, then execute this skill's recommendation/interpretation flow.

• SKILL.md keeps referral policy logic and decision tables.
• references/gate-cli.md is the authoritative gate-cli execution contract for capability boundaries, fallback behavior, and output constraints.

Domain Knowledge

Page Entry Points

When recommending activities, guiding users to check details, or mentioning the "Invite Friends page", always include the above URL so the user can navigate directly.

Product Definitions

1. Earn Together

• Definition: A limited-time invitation campaign (viral mechanism) where the inviter (M1) shares an exclusive link, the invitee (M2) registers via the link and completes tasks, and both parties receive random token rewards
• Activity Characteristics:
• Time-limited: Each campaign has a clear start and end date
• Exclusive: Only one Earn Together campaign runs at a time
• Random rewards: Reward amounts are randomly generated within a configured range
• How to Participate:

1. Inviter (M1) shares an exclusive link
2. Invitee (M2) registers via the link
3. M2 completes designated tasks (KYC, deposit, trading)
4. Both parties receive random cash vouchers

• Important Notes:
• Specific task requirements (deposit amount, trading volume) vary by region; please check the activity page for details
• Rewards are subject to risk-control review and are typically distributed within 14 business days after claiming

2. Help & Get Coupons

• Definition: Invite 2 friends to complete tasks and receive platform coupon rewards; suitable for users who want trial vouchers or discount coupons
• How to Participate:

1. Share your exclusive invitation link
2. Invite 2 new users to register
3. New users complete the following tasks: deposit task, trading task
4. Receive coupon rewards (e.g., 200 USDT position trial voucher; rewards may be adjusted based on actual conditions)

• Important Notes:
• Assistance rewards are distributed to the Coupon Center with a 5-day validity period
• Coupons have usage rules and expiration restrictions
• Please check the activity page for detailed task requirements

3. Super Commission

• Definition: A permanent invitation system that provides commission rebates based on friends' trading fees, generating continuous passive income
• How to Participate:

1. Share your exclusive invitation link
2. Friends register via the link
3. Friends trade (Spot, Alpha, Futures, TradFi, etc.)
4. Both you and your friends receive trading fee rebates

• Important Notes:
• Commission rates vary by trading type; please check the activity page for detailed rebate rules

Activity Constraints

• All three activities can be joined simultaneously; Earn Together is a time-limited event that opens irregularly
• Each invitee can only be invited through one invitation mode
• Referral relationships created through Super Commission cannot earn rewards from other activities; users invited through other activities cannot earn commission rebates

Common Misconceptions

Feature Keywords

Workflow

When the user asks any question related to inviting friends, follow this sequence.

Step 1: Identify Intent Type

Classify the request into one of the following categories:

1. Activity recommendation (user wants to know what referral activities are available)
2. Rule interpretation (user wants to understand a specific activity's rules/mechanics)
3. Activity selection advice (user has a specific need and wants the best-matching activity recommended)
4. FAQ (reward arrival time, amount differences, task requirements, etc.)
5. Data query (user wants to view activity data or reward progress)
6. Multi-activity participation rules (user wants to join multiple activities simultaneously)

Step 2: Check Activity Status

For activity recommendation requests:

• Check whether there is an active Earn Together campaign
• If yes → Prioritize recommending Earn Together (1 activity)
• If no → Recommend Help & Get Coupons + Super Commission

Step 3: Respond by Scenario

Select the corresponding response strategy based on the Case Routing Map.

Step 4: Return Result

The response must include:

• Activity name and brief description
• Core participation steps (simplified version)
• Key notes and caveats
• Guide the user to the activity page with the direct URL (https://www.gate.com/referral) for details (if applicable)

Case Routing Map (1-14)

A. Activity Recommendation (1-3)

B. Rule Interpretation (4-7)

C. Personalized Recommendation (8-10)

D. FAQ and Boundaries (11-14)

Judgment Logic Summary

Report Template

## Invite Friends Activity Recommendation

| Item | Details |
|------|---------|
| Activity Name | {activity_name} |
| Activity Type | {activity_type} |
| How to Participate | {participation_steps} |
| Reward Description | {reward_description} |
| Activity Page | https://www.gate.com/referral |

{additional_notes}

Capability Boundaries

Supported

• Activity recommendation and introduction: Recommend suitable referral activities based on user needs
• Activity comparison: Explain the differences and characteristics of the three activities
• Rule interpretation: Explain participation steps for each activity (do not recommend activity cards when interpreting rules)
• Task description: Describe task requirements (simplified version)
• FAQ answering
• Activity selection advice: Recommend the best-fitting activity based on user needs

Not Supported

• Activity data queries (number of invitees, reward amounts, etc.) → Redirect to Invite Friends page
• Reward progress queries → Redirect to Invite Friends page
• Agent/institutional account applications → Redirect to business partnership contacts

Error Handling

Safety Rules

• Disclaimer: Fake accounts, fraudulent transactions, and similar abuse are strictly prohibited; violators will be disqualified from receiving rewards
• Identity restriction: Agents and institutional users are not eligible for referral activities
• Regional restriction: Identify user IP or KYC region; if on the restricted list, inform the user that participation is not available
• Do not promise specific reward amounts (rewards are randomly generated)
• Do not bypass guidance by providing specific deposit/trading volume requirements (vary by region)
• All activity data query requests must be redirected to the Invite Friends page