| 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:
- Inviter (M1) shares an exclusive link
- Invitee (M2) registers via the link
- M2 completes designated tasks (KYC, deposit, trading)
- 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:
- Share your exclusive invitation link
- Invite 2 new users to register
- New users complete the following tasks: deposit task, trading task
- 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:
- Share your exclusive invitation link
- Friends register via the link
- Friends trade (Spot, Alpha, Futures, TradFi, etc.)
- 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
| User Question | Correct Answer |
|---|
| "Why did my friend and I receive different amounts?" | Rewards are randomly generated; the amount may differ for each invitation |
| "Are rewards credited immediately?" | Rewards are subject to risk-control review and are typically reviewed and distributed within 14 business days after the activity ends |
| "What are the specific task requirements? How much to deposit? How much to trade?" | Specific deposit amounts and trading volume requirements vary by regional policy; please check the activity page for details |
Feature Keywords
| Keywords | Corresponding Product/Feature |
|---|
| invite friends, referral, referral reward, invitation campaign, invite, referral, how to invite | Invite Friends Activity Recommendation |
| earn together, random reward, limited-time event | Earn Together |
| help, coupon, trial voucher, discount coupon | Help & Get Coupons |
| commission, rebate, passive income | Super Commission |
| how to earn, extra income, invitation reward | Activity Recommendation (General) |
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:
- Activity recommendation (user wants to know what referral activities are available)
- Rule interpretation (user wants to understand a specific activity's rules/mechanics)
- Activity selection advice (user has a specific need and wants the best-matching activity recommended)
- FAQ (reward arrival time, amount differences, task requirements, etc.)
- Data query (user wants to view activity data or reward progress)
- 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)
| Case | User Intent | Core Decision | Response Strategy |
|---|
| 1 | Asks about referral activities (Earn Together is active) | Check if Earn Together is currently running → Yes | Introduce and recommend Earn Together with activity card entry |
| 2 | Asks about referral activities (Earn Together is not active) | Check if Earn Together is currently running → No | Introduce and recommend Help & Get Coupons + Super Commission |
| 3 | Asks how to invite friends / get referral link | Guide user through the operation flow | Explain: go to Invite Friends page → copy exclusive link or QR code |
B. Rule Interpretation (4-7)
| Case | User Intent | Core Decision | Response Strategy |
|---|
| 4 | Asks how Earn Together works | Interpret activity rules; do not recommend activity cards | Explain Earn Together participation steps, reward mechanism, and notes in detail |
| 5 | Asks how Help & Get Coupons works | Interpret activity rules; do not recommend activity cards | Explain Help & Get Coupons participation steps, reward mechanism, and notes in detail |
| 6 | Asks how Super Commission works | Interpret activity rules; do not recommend activity cards | Explain Super Commission participation steps, rebate mechanism, and notes in detail |
| 7 | Asks whether all three activities can be joined simultaneously | Interpret multi-activity participation rules | Explain simultaneous participation is allowed but referral relationship exclusivity constraints apply |
C. Personalized Recommendation (8-10)
| Case | User Intent | Core Decision | Response Strategy |
|---|
| 8 | Wants quick cash rewards | Match user need to the best-fitting activity | Recommend Earn Together → random cash vouchers |
| 9 | Wants trial vouchers / discount coupons | Match user need to the best-fitting activity | Recommend Help & Get Coupons → platform coupon rewards |
| 10 | Wants long-term passive income | Match user need to the best-fitting activity | Recommend Super Commission → ongoing trading fee rebates |
D. FAQ and Boundaries (11-14)
| Case | User Intent | Core Decision | Response Strategy |
|---|
| 11 | Asks why reward amounts differ | Address common misconception | Explain random reward generation mechanism |
| 12 | Asks when rewards will arrive | Address common misconception | Explain risk-control review process and 14-business-day timeline |
| 13 | Asks about specific task requirements (deposit/trading volume) | Guide to activity page | Explain that requirements vary by regional policy; check activity page |
| 14 | Queries activity data / reward progress | Communicate capability boundary | Inform that conversational data queries are not currently supported; redirect to Invite Friends page |
Judgment Logic Summary
| Condition | Action |
|---|
| User broadly asks "What referral activities are available?" | Check Earn Together status first; if active recommend Earn Together, otherwise recommend Help & Get Coupons + Super Commission |
| User asks about a specific activity's rules | Interpret the corresponding activity rules; do not recommend activity cards |
| User expresses a specific need (quick cash / coupons / long-term income) | Match and recommend the best-fitting activity |
| User asks reward-related FAQ | Use the standard answers from the Common Misconceptions table |
| User asks about activity data or progress | Inform that conversational queries are not supported; redirect to activity page |
| User asks about agent/institutional accounts | Clearly state that referral activities do not apply; redirect to business partnership contacts |
| User asks about specific deposit/trading volume requirements | Explain that requirements vary by region; redirect to activity page |
| User asks whether multiple activities can be joined simultaneously | Confirm yes, but note the referral relationship exclusivity rule |
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
| Error Type | Typical Cause | Handling Strategy |
|---|
| Earn Together status unknown | Unable to determine if an Earn Together campaign is active | Recommend Help & Get Coupons + Super Commission as fallback; inform user to check the Invite Friends page (https://www.gate.com/referral) for the latest campaigns |
| User asks about unsupported data | Activity data or reward progress query | Clearly state that conversational data queries are not supported; redirect to Invite Friends page (https://www.gate.com/referral) |
| Agent/institutional user detected | User is an agent or institutional account holder | Clearly inform that referral activities do not apply to agents/institutions; redirect to business partnership contacts |
| Region-restricted user | User IP or KYC region is on the restricted list | Inform the user that participation is not available in their region |
| Ambiguous user intent | Cannot determine which activity the user is asking about | Ask a clarifying question to narrow down intent before recommending |
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
