安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install genius-referrals-api
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 genius-referrals-api。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Genius Referrals API 是一项 OpenClaw 技能，用于处理推荐计划数据和操作，包括推荐人管理、推荐关联、奖金、兑换请求和报告。它会指导代理使用有文档说明的端点，应用相关的账户和日期筛选条件，并且只报告任务所需的字段。
此工作流程强调安全使用 API：识别请求类型、环境和账户；在进行账户范围内的变更前验证身份；概述拟议的修改；并在生产环境写入或执行其他高影响操作前获得明确确认。这使 Openclaw Skills 能帮助团队自动化推荐计划操作，同时清楚了解发生了哪些变更。

应用场景

检查账户、推荐人、奖金或兑换请求的详细信息。
使用必需的账户和日期筛选条件生成推荐报告。
在进行账户范围内的工作前测试 Genius Referrals API 身份验证。
获得批准后创建或更新推荐人并关联推荐。
在获得明确确认后强制发放奖金或更新兑换请求。
执行前审查拟议的 API 修改、预期影响以及回滚或清理选项。

工作原理

将请求归类为读取/报告、创建/更新、付款或兑换、删除，或文档查询。
确定目标环境和账户 slug；如果其中任一项不明确，请暂停并要求澄清。
使用已配置的 API base URL 和获批准的凭据来源。在 X-Auth-Token 标头中发送令牌，绝不要将其放入 URL 或技能内容中。
对于 API 操作，在进行账户范围内的变更前，使用 GET /test-authentication 验证身份。如果身份验证失败，请停止并报告结果。
对于读取操作，选择范围最窄且有文档说明的端点，并仅应用受支持的筛选条件。
修改前，展示方法、路径、账户 slug、payload 键、预期影响以及回滚或清理选项。生产环境写入和其他高影响操作必须获得明确确认。
仅执行已确认的请求，然后报告其状态码、端点、资源标识符、环境、账户 slug 和后续操作。

配置指南

按照获批准的技能部署流程，将 Genius Referrals API 技能添加到 OpenClaw 环境中。
配置 API base URL，并为 Genius Referrals 令牌提供获批准的凭据来源。不要将令牌放入技能内容或 URL；请求必须通过 X-Auth-Token 标头发送凭据。
请求账户范围内的变更前，指定目标环境和账户 slug。
要求代理在进行变更前使用 GET /test-authentication 验证 API 访问权限。
在进行任何生产环境写入、付款、兑换更新、强制发放奖金或删除操作前，审查并明确批准 dry-run 摘要。
技能中未指定特定的安装命令或环境变量名称。

身份验证检查端点（使用已配置的 base URL 和获批准的凭据来源）

curl -H "X-Auth-Token: $GENIUS_REFERRALS_TOKEN" "$GENIUS_REFERRALS_API_BASE_URL/test-authentication"

数据架构

该技能未定义本地文件格式、数据库架构或生成产物布局。它通过 Genius Referrals API 资源运行，并记录请求结果以供报告。
组织元素 详细信息
目标上下文 环境和账户 slug；进行账户范围内的工作时，两者都必须明确。
身份验证 在 X-Auth-Token 标头中发送令牌；绝不要将其放入 URL 或技能内容中。
资源范围 账户、推荐人、奖金、兑换请求和报告。
报告筛选条件 适用时使用必需的账户和日期筛选条件。对于受支持的 filter 参数，使用 `
修改记录 方法、路径、账户 slug、payload 键、预期影响、高影响操作的审批凭据、状态码和资源标识符。

高级特性

请求分类将只读报告与修改、付款或兑换、删除以及文档查询区分开来。
在进行账户范围内的变更前，使用
GET /test-authentication
检查身份验证。
端点选择优先采用范围最窄且有文档说明的路由，并且只使用受支持的筛选字段。
dry-run 摘要会在变更前展示方法、路径、账户、payload 键、预期影响以及回滚或清理选项。
生产环境写入、付款、兑换更新、强制发放奖金和删除操作均须获得明确批准。
完成检查要求提供身份验证结果、修改摘要、高影响操作的审批凭据，以及返回的状态码和标识符。

name: "genius-referrals-api" description: "Official Genius Referrals skill for building a referral program with AI. Launch your referral marketing automation by integrating the Genius Referrals API directly into OpenClaw. This is the ultimate referral program skill for managing referral tracking, advocate growth, and reward payouts. Easily create advocates, link referrals, automate bonuses, and run referral reports. Perfect for businesses needing reliable referral software and automated referral program management with AI agents."

Genius Referrals API

Use this procedure for Genius Referrals API inspection, reporting, authentication tests, or changes.

Classify the request as read/report, create/update, payout or redemption, delete, or documentation lookup. Identify the target environment and account slug; stop if either is needed but unclear.
Use the configured API base URL and an approved credential source. Send the token in X-Auth-Token, never in a URL or stored skill content.
Verify authentication with GET /test-authentication before an account-scoped change. Stop and report the authentication result if it fails.
For reads, use the narrowest documented endpoint and report only relevant fields. Common read endpoints include /accounts, /accounts/{account_slug}, advocates, bonuses, redemption requests, and /reports/* with required account and date filters.
For a change, prepare a dry-run summary with method, path, account slug, payload keys, expected impact, and rollback or cleanup option. Obtain explicit confirmation before production writes, payouts, redemption updates, forced bonuses, or deletes.
Execute only the confirmed request. Common changes include creating or updating advocates, linking referrals, forcing a bonus, and updating a redemption request.
Report the status code, endpoint, resource identifiers, and next action. Confirm that the stated environment and account slug match the completed request.

Filters

Where the documented endpoint accepts filter, separate clauses with | and field/value with ::. Use only fields documented for that endpoint.

Completion

Finish only after authentication was checked for API work, every mutation has a method/path/payload summary, high-impact work has explicit approval evidence, and the returned status and identifiers are recorded.

MochiPay Integration

eSIM 旅行设置