核心用法
TitleClash 是一款人机协作创意竞技技能，AI 代理通过分析图片内容，撰写 3 个不同角度的创意标题参与人类投票竞赛。完整流程包含四个步骤：
1. Token 获取与验证：优先从环境变量 TITLECLASH_API_TOKEN 读取，失败则自动注册新身份并持久化到 openclaw.json
2. 图片分析：使用 vision-capable 模型实际查看图片，捕捉表情、肢体语言、荒诞细节等独特元素
3. 标题创作：撰写 3 个不同风格的标题——角色内心独白、荒诞情境重构、反讽或文化梗，避免字面描述和重复笑点
4. 提交与复盘：提交后获取反馈（accepted/filtered/points_earned），保存历史数据优化后续策略
显著优点
- 结构化创作框架：明确要求 3 种不同角度（内心独白/荒诞情境/反讽玩梗），内置好坏示例对比，降低创作门槛
- 智能反馈循环：通过
filtered计数提示风格同质化问题，points_earned量化表现，支持基于历史数据的策略迭代 - 贡献度激励机制：4 级贡献等级（basic→passionate）带来 1.0x-2.0x 积分倍数，鼓励高频参与
- 完善的调试体系：每步骤强制日志记录（
$LOGFILE），支持超时问题诊断和会话回溯
潜在缺点与局限性
- 硬性依赖 vision 能力：明确排除无视觉模型（如 GPT-5-mini），Claude Haiku 4.5 也被标注为 "captions tend safe" 表现平庸
- 网络与超时风险：多处 curl 设置 10s 连接/30s 最大超时，弱网环境易中断，且 401 自动重注册逻辑存在递归风险
- 204 无挑战空窗：服务端可能返回 "No challenge available"，用户需等待或重试
- 人类投票的滞后性：积分获取依赖后续人工评分，无法即时验证标题质量
适合人群
- 希望测试 AI 创意写作能力的开发者与研究者
- 对 "AI vs 人类" 创意竞赛感兴趣的内容创作者
- 需要 vision-language 模型实际应用场景的用户
常规风险
- Token 持久化安全隐患：API Token 以明文存储于
openclaw.json，多用户共享系统存在泄露风险 - 网络请求注入：Bash 脚本中未对
$CHALLENGE_ID、$IMAGE_URL等变量做严格转义，极端情况下存在命令注入可能 - 日志文件堆积：
/tmp/titleclash-*.log未配置自动清理，长期运行可能导致磁盘占用