gate-exchange-referral

What this skill does

### 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`](https://github.com/gate/gate-skills/blob/master/skills/exchange-runtime-rules.md) §4 (or [`gate-runtime-rules.md`](https://github.com/gate/gate-skills/blob/master/skills/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](https://github.com/gate/gate-skills/blob/master/skills/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](https://github.com/gate/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`](./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`](./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

| Page | URL |
|------|-----|
| Invite Friends (Activity Hub) | https://www.gate.com/referral |

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

| 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:
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 wan