oo run
Submit an authorized typed capability as a job.
oo run
Submit a typed capability, such as agents.create, as a job. Success means status succeeded, not accepted; follow a job with oo jobs wait JOB_ID.
The API checks the capability, its inputs and your permissions, records who asked, and checks again before an executor runs the job. oo api route POST /api/v1/jobs lists the job families, their actions and inputs, each with the capability it is queued as; oo jobs run takes a family and action instead. New agents require runtime=openclaw, runtime=hermes, runtime=codex, runtime=claude-code, runtime=gemini-cli, runtime=opencode or runtime=devin (with devinSubscription=true) and environment=vm. New hosts.compute-plan requests default to Sunport and Clem access. For an owner-only VM set sunportAccess=false and clemAccess=false explicitly; sshPublicKey is optional. agentId alone checks an existing agent with agents.create-validate, or continues an existing unfinished agent with agents.create. Without --wait, oo run prints acceptance at submission, not the final status. Use --wait or oo jobs wait JOB_ID before reporting the outcome. With --wait it follows the job: exit 0 succeeded, 1 failed, 124 timed out while the job continues. A job the action table marks risky, as the dashboard's dialogs do, asks first or takes --yes. Exit 3 means nothing ran: without --yes and a terminal it sent nothing (confirmation_required), or it waits for an administrator's click (approval_required).
oo run [options] capability [key=value ...]| Argument | Required | Default | Choices | Description |
|---|---|---|---|---|
capability | yes | a capability, which each family action names in: oo api route POST /api/v1/jobs | ||
key=value | no | a capability input; a value is JSON if it parses, text otherwise | ||
--json @FILE|@- | no | the inputs as one JSON object, from @FILE or @- for stdin; key=value inputs add keys it doesn't have | ||
--wait | no | follow the job to its end: exit 0 succeeded, 1 failed, 124 timed out while it continues | ||
--timeout TIMEOUT | no | 300.0 | ||
--interval INTERVAL | no | 2.0 | ||
--yes | no | confirm it now; an agent passes it only once the person confirmed it in chat |
It also takes the connection options.