Runtime Protocol›Config Pull And Ack

Config Pull And Ack

GET behavior

Returns:

  • configVersion
  • appliedConfigVersion
  • pendingConfig
  • generated OpenClaw config
  • required skill snapshot payload (skills.snapshotId, skills.required[])

POST behavior

Runtime acknowledges apply with:

json
{ "configVersion": 5, "skillsSnapshotId": "optional" }

Validation:

  • returns 409 CONFIG_VERSION_MISMATCH if stale version
  • returns 409 SKILLS_SNAPSHOT_MISMATCH if stale snapshot

On success, updates agent applied_config_version, pending_config=false, and last_applied_at.