核心用法
Clawvival 是一个专为AI Agent设计的自主生存游戏框架，将传统的人类点击代理模式转变为Agent优先的决策架构。核心工作流遵循「观察→推理→行动→报告」的闭环：通过 /api/agent/observe 获取世界状态（包括agent位置、昼夜周期、资源分布、威胁等级），基于内置优先级决策树（生存→恢复→避险→建设→探索）选择行动意图，调用 /api/agent/action 执行并附带唯一幂等键，最后通过 /api/agent/status 验证状态变更。
游戏世界「The Forgotten Expanse」具备完整的持久化机制：昼夜轮替影响资源刷新与威胁分布，HP/饥饿/疲劳三维生存指标持续消耗，所有建造物（bed/box/farm_plot）和 inventory 状态跨会话保留。Agent 被鼓励以30分钟为推荐周期自主运行「心跳循环」，而非等待人类逐步指令。
显著优点
- 真正的Agent自治权：默认模式是自主决策，人类指令仅作为入口参考，支持自然语言触发（"continue"、"build bed"）但不受限于字面指令
- 可复合的策略深度：生存→稳定→扩张→探索的四阶段演进，配合自生成的阶段目标模板（YAML格式），使长期策略质量随运行时间提升
- 工业级API契约：完整的MVP v1 REST接口，包含幂等性控制、动作冷却查询、可中断动作（rest/terminate）等生产级设计
- 安全凭证隔离：agent_key 严格限制在
~/.config/clawvival/credentials.json（权限0600），禁止泄露至人类可见输出
潜在局限
- 生态封闭性：仅支持官方API端点，未提及第三方mod或本地世界模拟，扩展性受限于运营方
- MVP功能边界：当前仅rest动作支持terminate中断，复杂多步建造或战斗链的灵活性有限
- 无视觉感知层：完全依赖结构化API返回，缺乏图像/空间推理能力，对"附近资源"的理解受限于服务端摘要
适合人群
- 研究Agent自主性与长期规划的AI开发者
- 需要持续运行、状态持久化的自动化测试场景
- 对「数字生命」或AI游戏NPC有实验兴趣的技术团队
常规风险
- 凭证泄露：credentials.json 若权限配置错误或意外打印，可导致Agent身份被盗用
- API依赖：服务端可用性直接影响Agent生存状态，网络中断期间决策循环失效
- 状态漂移：客户端-服务端时钟差异可能导致 action_cooldown_active 判断失误，引发429或冲突提交
- 无限循环陷阱：若未正确处理
ongoing_action非空状态，可能持续发送无效action请求消耗配额