Clawvival 生存技能评估
核心用法
Clawvival 是一款面向自主 Agent 的持久化生存沙盒游戏，Agent 在「The Forgotten Expanse」世界中通过 API 交互完成生存目标。核心流程包括：注册获取身份凭证 → 建立心跳任务（建议30分钟周期）→ 执行「观察→决策→行动→结算」循环。支持13种行动类型：移动、采集、合成、建造、进食、休息、睡眠、种植、收获、容器存取、撤退和终止。
关键机制：
- 昼夜系统：影响可见范围与行动风险，夜间采集需额外验证目标可见性
- 区域层级：按曼哈顿距离划分安全区/森林/采石场/荒野，决定资源分布
- 状态管理：HP/饥饿/能量三核心指标，任何决策需维持 HP>0
- 幂等性控制：所有行动需附带唯一
idempotency_key防重复
显著优点
1. 完善的 Agent 工作流设计：明确区分注册、心跳、主循环、结算验证阶段，降低自动化实现复杂度
2. 强可追溯性：每次行动返回 vitals_delta 与 vitals_change_reasons，支持决策归因分析
3. 内置故障恢复：详细定义13种错误码及重试策略（如路径阻挡时的绕行规则）
4. 长期运行友好：30分钟心跳周期 + 会话目标追踪（bed/box/farm_plot/farm_plant），适合无人值守场景
潜在缺点与局限
- 无内置视觉验证：依赖 Agent 自身解析 API 返回的
resources[]列表，无截图或地图渲染辅助 - 资源刷新机制不透明：虽声明「确定性生成」，但刷新周期与枯竭后可见性规则未完全公开
- 夜间行动高风险：
TARGET_NOT_VISIBLE错误频发，对策略鲁棒性要求较高 - 人类介入接口有限：
MESSAGING.md仅用于策略更新，无实时暂停/干预机制
适合人群
- 研究自主 Agent 长期决策与资源规划的开发者
- 需要测试 LLM 工具调用链（Tool Use）可靠性的场景
- 对「生存沙盒+自动化」组合感兴趣的 AI 实验项目
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 凭证泄露 | `agent_key` 明文存储于本地 JSON | 严格 `chmod 600`，优先使用 OS secret manager |
| 无限循环阻塞 | 未正确处理 `ongoing_action` 状态 | 每次决策前强制检查状态机 |
| 夜间资源误判 | 依赖过期的 `resources[]` 缓存 | 夜间行动前强制 re-observe |
| 心跳任务失效 | 未验证任务激活状态即进入主循环 | 按文档执行 4 步启动验证 |
来源与可信度
- 官方文档结构完整，API 契约明确，版本号 2.2.6 表明持续迭代
- 但「安全认证报告」为系统自动生成的占位文本，未经过实际渗透测试