Clawvival Survival

核心用法

Clawvival 是一款Agent-first 生存模拟游戏，核心设计是让 AI 代理（而非人类玩家）成为游戏主体。系统提供完整的 API 运行时契约，代理通过自主心跳循环完成：观察(Observe) → 决策 → 行动(Action) → 状态确认(Status) → 报告。

关键机制：

• 持久化世界：昼夜轮换、资源压力、动态风险，每个决策永久改变代理状态（位置、生命值、库存、定居点布局）
• 自主心跳循环：默认不等待人类逐步指令，代理主动观察、推理、行动并附带证据链报告
• API 驱动：基于 REST API 的完整运行时契约，支持注册、观察、行动、状态查询等端点

新手里程碑优先级：床(bed) → 箱子(box) → 农田(farm_plot) → 种植(farm_plant)，建议单会话内完成。

显著优点

| 维度 | 亮点 |

|------|------|

| 自主性 | 真正的 Agent-first 设计，代理拥有持久化决策所有权，策略质量随时间复利增长 |

| 完整性 | 从世界设定、API 契约、凭证管理到安全规则的全栈文档 |

| 可扩展性 | 阶段目标模板支持自定义策略，心跳机制支持复杂长期规划 |

| 安全设计 | 凭证文件权限 0600、agent_key 禁止暴露给人类、强制 HTTPS 端点验证 |

| 开发体验 | 版本锁定安装脚本、幂等键机制、明确的错误码处理指南 |

潜在缺点与局限性

• 依赖外部服务：所有游戏状态托管于 api.clawvival.app，离线不可用，存在服务中断风险
• MVP 限制：v1 版本仅支持有限行动类型（如 terminate 仅可中断 rest）
• 学习曲线陡峭：需要理解状态机、幂等性、持续动作管理等概念，对新手代理不够友好
• 无本地模拟：无沙盒环境，所有交互均为真实 API 调用，调试成本较高
• 资源可见性约束：必须通过 observe 获取当前资源列表，不能直接使用历史快照

适合人群

• AI 代理开发者：研究自主代理决策循环、长期规划能力的工程师
• 强化学习研究者：需要持久化环境、状态反馈机制的游戏 AI 实验平台
• CLI 工具爱好者：偏好 curl/jq 命令行交互的技术用户
• 游戏 AI 产品经理：探索"代理即玩家"新范式的创新者

常规风险

| 风险类别 | 具体描述 | 缓解建议 |

|----------|----------|----------|

| **服务可用性** | 第三方 API 可能中断或变更 | 关注版本锁定(`2.6.2`)，监控公告 |

| **凭证泄露** | `~/.config/clawvival/credentials.json` 若权限配置错误可导致账号被盗 | 严格检查 0600 权限，禁止日志打印 |

| **策略死锁** | 自主循环可能因错误决策陷入资源枯竭循环 | 实施阶段目标模板的退出条件检查 |

| **过度自主** | 代理可能在未充分理解风险时执行危险行动 | 人类保留 `terminate` 和方向性指令覆盖权 |

| **API 限流** | 高频心跳可能触发服务端限流 | 遵守 `action_cooldowns` 反馈，实现退避逻辑 |

核心用法

Clawvival-survival 是一套面向 Agent 的游戏 API 接入协议，旨在让 AI Agent 成为《The Forgotten Expanse》游戏世界的自主参与者。该 Skill 并非传统意义上的工具或脚本，而是一份完整的运行时契约文档，定义了 Agent 如何通过标准 HTTP API 与游戏服务器交互。

使用流程分为三步：首先通过 agent/register 端点获取身份凭证并本地安全存储；随后进入核心循环——调用 observe 感知环境状态（包括位置、资源、威胁、时间相位），基于内置决策优先级自主生成行动意图，通过 action 端点执行（如 gather/craft/build/rest 等），最后用 status 验证执行结果。Skill 提供了完整的 curl 命令模板、字段说明和错误处理指南，Agent 可据此实现无人值守的持续运营。

特别强调的是其"Agent-first"设计理念：默认行为不是等待人类逐步指令，而是基于世界状态自主观察、推理、行动并汇报证据链。Skill 内置了新人里程碑（bed→box→farm_plot→farm_plant）和阶段目标模板，支持从纯生存到稳定运营再到主动探索的演进路径。

显著优点

1. 协议完整性：涵盖了注册、观测、行动、状态查询的全生命周期 API 契约，字段定义清晰，包含 idempotency_key、action_cooldowns 等生产级细节。

2. 安全实践到位：强制要求凭证文件 0600 权限，明确禁止 agent_key 泄露到人类可见输出，符合最小权限原则。

3. 决策框架成熟：提供了五级优先级体系（Survive→Recover→De-risk→Onboarding→Maintenance）和 YAML 阶段目标模板，降低 Agent 自主决策的混沌度。

4. 无外部依赖：纯文档型 Skill，无第三方库依赖，运行环境仅需 curl/jq，攻击面极小。

潜在缺点与局限性

1. 外部 API 依赖风险：所有功能依赖 api.clawvival.app 的可用性和安全性，该域名运营者身份不明，无 SLA 保障，服务中断将导致 Agent 完全失效。

2. T3 来源可信度：发布者为个人开发者 yrpang，非知名开源组织或企业背书，项目长期维护能力和安全响应速度存疑。

3. 动态代码下载：安装脚本从远程拉取文件，虽含版本校验但仍存在供应链攻击可能。

4. 功能边界限制：当前为 MVP v1 阶段，terminate 仅支持 rest 动作中断，复杂场景下的灵活应变能力有限。

5. 无本地模拟能力：Agent 无法离线推演策略，每次决策必须联网查询状态，网络延迟直接影响响应效率。

适合的目标群体

• 开发具备自主决策能力的游戏 AI Agent 的工程师
• 研究 Agent 长期自主运营（persistent autonomous operation）的学术团队
• 熟悉 curl/bash 环境、希望快速接入 Clawvival 游戏生态的技术用户
• 对"Agent-first"交互范式感兴趣的 AI 应用创新者

不适合：寻求开箱即用 GUI 工具的普通玩家、对第三方 API 有严格合规要求的企业场景、需要离线运行的边缘计算环境。

使用风险

1. 凭证泄露风险：agent_key 一旦泄露，攻击者可完全控制对应 Agent 的游戏身份，虽存储权限受限但内存中仍有暴露可能。

2. 网络监控盲区：Skill 要求监控 api.clawvival.app，但该域名无公开安全审计报告，TLS 中间人攻击虽技术上困难但无法完全排除运营方风险。

3. 版本漂移：远程安装脚本依赖 jq 版本校验，若官方服务器被攻破，可能推送恶意更新，建议 pin 住已知安全版本哈希。

4. 长期状态丢失：Agent 状态完全托管于 Clawvival 服务端，若服务终止或数据丢失，长期积累的生存进度可能无法恢复。