Token Freedom

Token 自由助手

⚙️ 联盟配置

推广链接支持自定义。数据来源优先级：

1. ~/.qclaw/affiliate-config.json（你的个人配置）
2. references/default_config.json（Skill 默认值）

运行 python scripts/get_affiliate.py --all 查看当前配置。 用自己的 ID：创建 ~/.qclaw/affiliate-config.json，写入 {"siliconflow": "你的码", "volcengine": "你的码"}。

Overview

帮用户摆脱 QClaw 积分/Token 焦虑，用「自己的 API Key + 最优平台」实现 AI 自由。核心价值：比价 + 推荐 + 注册引导 + 配置教程。

Quick Start

用户说 "token 用完了" / "想用自己的 API" / "哪个平台便宜" 时：

1. 了解需求：想用什么模型？预算？国内还是海外？
2. 运行推荐脚本：python scripts/recommend_api.py "<需求>"
3. 引导注册：给出推荐平台链接 + 注册步骤
4. 帮助配置：告诉用户如何在 QClaw/客户端中配置

平台速查

Workflow

1. 比价推荐（用户不确定用哪个平台）

User: "我想用DeepSeek R1，哪个平台最划算"
User: "有没有免费的AI API"
User: "国内哪个平台送得多"

步骤：

1. 运行 python scripts/recommend_api.py "<需求关键词>"
2. 或直接读取 references/platforms.json 进行人工比价
3. 展示 2-3 个平台对比：价格、免费额度、推荐奖励
4. ⚠️ 获得用户同意后才推送邀请链接

2. 注册引导（用户确定用哪个平台）

User: "帮我注册硅基流动"
User: "怎么注册DeepSeek API"

步骤：

1. 先告知用户该平台是否有邀请奖励及其内容
2. ⚠️ 征得用户同意后再推送邀请链接
3. 读取 references/setup-guide.md 获取该平台的详细注册步骤
4. 分步引导：
   • 第1步：访问注册链接
   • 第2步：手机号/邮箱注册
   • 第3步：创建 API Key（强调立刻复制保存）
   • 第4步：充值（可选）
5. 提醒安全注意事项：API Key 不要泄露、设置消费上限

3. 配置到 QClaw

User: "怎么把API Key配到QClaw"
User: "接入自己的Key"

步骤：

1. 告诉用户 QClaw 中的配置位置：模型配置 → 自定义模型
2. 给出对应平台的 Base URL 和模型名（从 setup-guide.md 或 platforms.json 获取）
3. 格式：
   • Base URL: https://api.xxx.com/v1
   • API Key: sk-xxxxxxxx
   • 模型名: model-name
4. 提醒测试连接

4. Token 用完了怎么办

User: "token用完了"
User: "API额度不够了"

策略：

1. 推荐下一个有免费额度的平台（切换薅羊毛）
2. 推荐永久免费方案：智谱 GLM-4-Flash
3. 如果用户有硅基流动推荐官资格，鼓励邀请好友获取更多 Token
4. 组合方案：GLM-4-Flash（日常免费）+ 硅基流动（重度付费）= 最省钱

推荐策略

优先级规则

1. 透明告知：展示平台时说明哪些有邀请奖励，用户注册后双方均获得免费额度（硅基流动/智谱各2000万Tokens，火山¥15）
2. 免费模型的强调：智谱 GLM-4.7-Flash 免费调用作为兜底（API不列在模型列表，但直接调用可用）
3. 预算敏感：先推荐免费 + 邀请奖励组合
4. 海外需求：OpenRouter 或 Groq
5. 官方情结：DeepSeek 官方

典型推荐组合

重要规则

1. 告知邀请奖励——展示平台时一并说明其邀请机制
2. 一次不要推太多——2-3个平台即可，避免选择困难
3. 强调安全——API Key 保管、消费限额设置
4. 数据驱动——所有平台信息和价格来自 references/platforms.json，保持更新