Skip to main content
Secrets on a node are names and values stored in the Ageneral secrets service and scoped to that node (and its project). On apply, the platform resolves them into environment on the machine. Anything on that node can consume them by name—OpenClaw is one example, not the definition of secrets.

​
How they fit

  1. Create or update — You register a name and value for the node. The API accepts a JSON body with value; node_id and name come from the path.
  2. List — You can list names the node knows about (not necessarily full values in every surface).
  3. Apply — When the node converges to desired state, secret names are applied so processes on the host see the resolved values the product wires in (for example provider keys or connector OAuth material—see Connectors).
  4. Delete — Removing a secret updates what the next apply sends; ensure nothing still references that name.

​
API

Use the API reference tab, Nodes group, for:
  • GET /v1/nodes/{node_id}/secrets — list secret names
  • PUT /v1/nodes/{node_id}/secrets/{name} — set or replace a secret value
  • DELETE /v1/nodes/{node_id}/secrets/{name} — remove a secret
Calls use https://ageneral.ai with your normal Ageneral session (not the Models host).