Agent (Run + Jobs + Memory)

Agent is veriova’s execution service. You can run tasks synchronously, queue async jobs, automate browser work, and optionally integrate memory writeback.

Base URL

Agent is exposed at:

base-url

https://api.veriova.com/openclaw

Core Endpoints

endpoints

GET  /openclaw/health
GET  /openclaw/api/v1/info
POST /openclaw/api/v1/agent/run
POST /openclaw/api/v1/agent/jobs
GET  /openclaw/api/v1/agent/jobs
GET  /openclaw/api/v1/agent/jobs/:id
GET  /openclaw/api/v1/agent/memory/status
POST /openclaw/api/v1/browser/run

Browser Automation

Agent now includes a Playwright-based browser tool inside the container. Use it for login flows, dashboards, forms, and approval-gated admin work.

browser-run

curl -sS -X POST https://api.veriova.com/openclaw/api/v1/browser/run \
  -H "content-type: application/json" \
  -d '{
    "actions": [
      { "type": "goto", "url": "https://veriova.com/login" },
      { "type": "wait_for_selector", "selector": "input[type=email]" },
      { "type": "screenshot", "path": "browser/login.png", "full_page": true }
    ]
  }'

Run a Task Now

curl

curl -sS -X POST https://api.veriova.com/openclaw/api/v1/agent/run \
  -H "content-type: application/json" \
  -d '{
    "goal":"Fetch API health and summarize it",
    "mode":"execute",
    "use_memory":true
  }'

Queue Async Jobs

For longer work, submit a job and poll the status:

curl

# Queue
curl -sS -X POST https://api.veriova.com/openclaw/api/v1/agent/jobs \
  -H "content-type: application/json" \
  -d '{"goal":"index weekly logs","mode":"execute"}'

# List jobs
curl -sS https://api.veriova.com/openclaw/api/v1/agent/jobs

# Get one job
curl -sS https://api.veriova.com/openclaw/api/v1/agent/jobs/<job_id>

Security Defaults

In production, set OPENCLAW_API_KEY and include it as Bearer auth (or x-api-key) in every request.

auth-request

curl -sS https://api.veriova.com/openclaw/api/v1/info \
  -H "Authorization: Bearer oc_your_key_here"

Memory Integration

If memory env vars are configured in Agent, it will fetch context before planning and store run summaries after execution.

memory-status

curl -sS https://api.veriova.com/openclaw/api/v1/agent/memory/status

You can also use the built-in dashboard page at /dashboard/agent to run tasks and inspect jobs without leaving veriova.