openclaw-trakt

核心用法

OpenClaw Trakt 技能通过 Python 脚本与 Trakt.tv 官方 API 深度集成，为用户提供完整的观影数据追踪与内容发现服务。首次使用需运行交互式设置脚本完成 OAuth 2.0 认证流程，创建 Trakt 应用并配置 Client ID/Secret 后，通过 PIN 码完成授权。支持四大核心功能：使用 recommend 命令基于观看历史和评分习惯获取个性化影视推荐；通过 history 查看近期观影记录；利用 watchlist 管理待看清单；借助 search 和 trending 发现特定内容或当前热门影视作品。

显著优点

该技能采用标准的 PIN-based OAuth 2.0 认证机制，确保用户凭据安全；所有认证令牌仅存储在本地配置文件 (~/.openclaw/trakt_config.json)，不上传至第三方服务器，数据隐私性良好。依托 Trakt.tv 成熟的影视数据库，推荐算法基于真实观看行为和评分数据，准确性随使用时长逐步提升。代码结构清晰，依赖单一且可靠（仅使用 requests>=2.31.0），无动态代码加载或危险函数执行风险。交互式设置流程降低了配置门槛，即使非技术用户也能顺利完成初始化。

潜在缺点与局限性

功能完整性依赖 Trakt.tv Pro 订阅，免费用户无法享受自动同步流媒体观看记录的便利。推荐质量与用户历史数据量正相关，新用户或观看记录较少时，推荐精准度可能受限。受 Trakt API 速率限制约束（认证用户每 5 分钟 1000 次请求），高频查询场景下可能触发限流。此外，技能完全依赖外部网络服务，Trakt.tv 平台维护或网络中断时将无法使用。Python 环境配置对小白用户仍有一定门槛，特别是虚拟环境与依赖安装环节。

适合的目标群体

影视爱好者与追剧用户是核心受众，特别是已通过 Trakt.tv 管理多平台观看记录的用户。适合需要基于历史口味获取个性化推荐、避免剧荒的观众；以及希望统一管理 Netflix、Disney+ 等多平台观影历史的数据整理者。对影视博主、影评人或需要追踪行业热门内容的专业人士同样适用。不推荐无 Trakt 账户、对云端同步敏感或处于完全离线环境的用户使用。

使用风险与注意事项

主要风险集中于凭证管理：虽然令牌本地存储，但用户需自行确保 ~/.openclaw 目录的访问权限安全，避免多用户环境下敏感信息泄露。网络依赖风险显著，API 服务中断或 Trakt.tv 政策变更可能影响功能可用性。setup.py 脚本建议使用 --break-system-packages 安装依赖，可能污染系统 Python 环境，强烈建议在虚拟环境中运行。此外，技能本身不提供数据备份机制，Trakt 账户数据丢失风险需通过平台自身功能规避。