Skip to main content

​
Overview

Secrets map names to values for an agent inside a project. Ageneral encrypts stored values and supplies them to the agent runtime when configuration updates run.

​
REST workflow

  1. Put — PUT /v1/agents/{agent_id}/secrets/{name} with body { "value": "…" }.
  2. List — GET /v1/agents/{agent_id}/secrets returns configured names.
  3. Delete — DELETE /v1/agents/{agent_id}/secrets/{name} removes a secret.
After writes, allow a short interval before relying on new values inside OpenClaw.

​
Reference

See API reference → Agents for schemas and response shapes.

​
Next steps