核心用法
gemini-sub-agent 是一种成本优化型技能，允许用户通过 Google One / Gemini Advanced 订阅（无需 API key 或积分）在 OpenClaw 工作流中调用 Gemini 作为子代理。
三大核心场景：
1. 成本替代：用 Gemini 免费层替代 Claude Sonnet/Haiku 的付费 API 调用
2. 长上下文处理：利用 100 万 token 窗口分析大型文档、代码库或报告
3. 自主编码：通过 -y yolo 模式让 Gemini 自动读写文件、执行命令，处理 30-200 行的中等复杂度任务
技术实现：基于官方 gemini-cli 工具，通过 gcloud OAuth 完成认证（支持无浏览器 VPS 流程），缓存凭证自动刷新。封装 ask-gemini 命令行工具，支持管道输入（cat file | ask-gemini）和交互式提示。
显著优点
- 零边际成本：订阅用户无 API 用量焦虑，适合高频调用
- 超长上下文：1M token 窗口远超 Claude 200k，适合整本手册、大型代码库分析
- Agentic 能力：支持自主文件操作，可替代 Swift/Sonnet 完成中等复杂度任务
- 模型选择丰富：从 Gemini 2.5 Flash（轻量快速）到 3.1 Pro（旗舰推理）灵活切换
潜在局限与风险
| 局限 | 说明 |
|------|------|
| 无实时数据 | 无法访问网络，需配合 Grok 等工具完成搜索任务 |
| 复杂度天花板 | 复杂架构设计、深度调试建议升级至 Codex (Opus) |
| 认证依赖 | 需维护 Google 订阅有效，OAuth 流程在部分环境较繁琐 |
| 上下文隔离 | 无法访问 OpenClaw 原生工具（web_search、Telegram 等）和主会话上下文 |
失败回退机制：同一任务 Gemini 失败两次 → 自动升级至 Swift (Sonnet) 或 Codex (Opus)，并记录失败模式到 failures/hot_antipatterns.md。
适合人群
- 订阅用户：已有 Google One/Gemini Advanced 账户，希望最大化订阅价值
- 高频轻量用户：需要大量文本分析、摘要、中等规模代码生成，但 Claude API 成本敏感
- 长文档处理者：法律、学术、技术文档分析，需要超大上下文窗口
常规风险
- 订阅续费依赖：服务可用性与 Google 订阅状态绑定
- OAuth 安全风险：凭证缓存于本地，共享环境需额外隔离
- 质量漂移：Pro/Flash 模型输出质量差异大，复杂任务需人工校验降级策略