Skip to Content
Referenceoo CLI

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 ...]
ArgumentRequiredDefaultChoicesDescription
capabilityyesa capability, which each family action names in: oo api route POST /api/v1/jobs
key=valuenoa capability input; a value is JSON if it parses, text otherwise
--json @FILE|@-nothe inputs as one JSON object, from @FILE or @- for stdin; key=value inputs add keys it doesn't have
--waitnofollow the job to its end: exit 0 succeeded, 1 failed, 124 timed out while it continues
--timeout TIMEOUTno300.0
--interval INTERVALno2.0
--yesnoconfirm it now; an agent passes it only once the person confirmed it in chat

It also takes the connection options.

On this page