用途：game-physics 用于游戏中的物理模拟，聚焦碰撞检测、刚体动力学与力的施加，可与 Unity、Godot 等游戏引擎集成，在 2D/3D 环境中模拟真实交互。适用于平台跳跃、模拟类游戏、多人在线世界等需要物体交互的场景，不适用于非游戏应用或简单动画。
主要能力：碰撞检测支持 AABB、OBB 和球体检测，使用 SAT 等算法求精确相交；刚体动力学模拟速度、加速度与扭矩，结合牛顿定律施力；力处理支持冲量、重力与摩擦力，通过向量输入配置；模拟控制可暂停、步进或重置，并支持时间缩放实现慢动作；优化方面使用四叉树等空间划分降低大场景计算量。
使用方式：通过 OpenClaw 的 CLI 或 API 调用。需在环境中设置 $OPENCLAW_API_KEY 认证。CLI 示例：openclaw game-physics simulate --file scene.json --steps 100 --gravity 9.8。API 端点：POST /api/game-physics/simulate，请求头带 Authorization: Bearer $OPENCLAW_API_KEY，载荷为 JSON 场景与步数。场景配置使用 JSON，对象需含 id、shape 及物理属性。集成时在游戏循环中调用 simulate，输出标准 [x,y,z] 数组供渲染使用，也可通过 --callback-url 设置回调。
限制与错误处理：常见错误包括配置无效（如缺少 mass 字段）、认证失败或模拟溢出。需先检查 $OPENCLAW_API_KEY，使用 jsonschema 等库校验 JSON，API 端捕获 401 等 HTTP 错误并指数退避重试，CLI 可用 --debug 记录详细错误。依赖核心 OpenClaw 服务进行认证。