Skip to main content

​
gensparx approvals

Manage exec approvals for the local host, gateway host, or a node host. By default, commands target the local approvals file on disk. Use --gateway to target the gateway, or --node to target a specific node. Related:

​
Common commands

gensparx approvals get
gensparx approvals get --node <id|name|ip>
gensparx approvals get --gateway

​
Replace approvals from a file

gensparx approvals set --file ./exec-approvals.json
gensparx approvals set --node <id|name|ip> --file ./exec-approvals.json
gensparx approvals set --gateway --file ./exec-approvals.json

​
Allowlist helpers

gensparx approvals allowlist add "~/Projects/**/bin/rg"
gensparx approvals allowlist add --agent main --node <id|name|ip> "/usr/bin/uptime"
gensparx approvals allowlist add --agent "*" "/usr/bin/uname"

gensparx approvals allowlist remove "~/Projects/**/bin/rg"

​
Notes

  • --node uses the same resolver as gensparx nodes (id, name, ip, or id prefix).
  • --agent defaults to "*", which applies to all agents.
  • The node host must advertise system.execApprovals.get/set (macOS app or headless node host).
  • Approvals files are stored per host at ~/.openclaw/exec-approvals.json.