核心用法
ClawTV 是一款 AI 驱动的 Apple TV 遥控器，通过视觉+推理实现电视应用的自主导航。核心工作流：
1. AI Agent 模式（do）：用自然语言下达指令，如"打开 Netflix 搜索 Stranger Things"，系统自动截图→AI分析UI→发送遥控指令→验证结果，循环执行至完成（最多20步）
2. Plex 直控（plex）：绕过视觉循环，直接调用 Plex API 实现秒级播放，零视觉成本
3. 手动遥控（cmd/type/launch）：发送方向键、输入文字、启动应用等基础操作
4. 截图工具（screenshot）：支持 QuickTime（0.6s，推荐）、Lookout（0.1s）、Xcode（2.5s，DRM兼容）三种方式
显著优点
- 真正自主：不只是预设脚本，Claude 实时分析 UI 决定下一步操作，适配任意应用界面变化
- 成本优化：滑动窗口仅保留最近2张截图（省70% token）、JPEG压缩、Haiku/Sonnet 自动降级、Prompt 缓存
- 混合架构：AI 用于复杂导航，Plex API 用于已知媒体库，兼顾灵活性与经济性
- DRM 兼容：通过 Xcode 方法绕过 HDCP 限制，支持 Netflix/Disney+/HBO Max
潜在局限
- 平台锁定：必须 macOS + Apple TV 4K（gen2+），Windows/Linux 用户无法使用
- 隐私依赖：需要 Apple ID 配对、Xcode 开发者模式，对普通用户门槛较高
- 视觉成本累积：复杂导航任务（如多层级菜单）可能消耗 $0.10-0.20，高频使用成本不可忽视
- 网络依赖：所有 AI 决策需实时调用 Anthropic API，无离线模式
- 截图盲区：QuickTime 被 DRM 中断时需自动/手动切换，体验不连贯
适合人群
- 重度 Apple TV 用户：厌烦遥控器打字、多层菜单导航的繁琐
- Plex 自建库用户：直控功能带来极致播放体验
- 智能家居集成者：可通过脚本将电视控制接入 HomeKit 或其他自动化流程
- 技术尝鲜者：愿意接受初期配置复杂度换取 AI 自动化红利
常规风险
| 风险类别 | 说明 |
|---------|------|
| API 密钥泄露 | ANTHROPIC_API_KEY 需配置在环境变量，共享设备存在泄露风险 |
| 隐私截图 | 电视画面被持续截取并发送至 Anthropic，敏感内容可能被记录 |
| 配对凭证 | `~/.clawtv/config.json` 存储设备凭证，需妥善保管 |
| 误操作风险 | AI 可能误触购买、订阅或儿童不宜内容，建议监督使用 |
| 网络暴露 | Plex 直控需暴露服务器 URL 和 token，建议使用 HTTPS 和局域网隔离 |