Strata Docs

Connecting an Agent

  1. Get the sessionKey from OpenClaw

    Log in to OpenClaw and navigate to your agent. Open the agent detail page and copy the sessionKey shown in the connection panel. Keep it on your clipboard — you will paste it in a later step.

  2. Open Agent Definitions in Strata

    In Strata, go to Settings > Agent Definitions and click New to open the new definition form.

  3. Give it a descriptive name

    Enter a clear internal name for this agent definition, for example "SEO Brief Generator v2". This name appears in service selectors and job logs, so make it meaningful.

  4. Paste the sessionKey

    Paste the sessionKey exactly as copied from OpenClaw into the Session Key field. Do not retype it — the key is case-sensitive and manual entry introduces errors.

  5. Save the AgentDefinition

    Click Save. Strata will persist the definition and display an auto-generated id. Note that id — you will use it when attaching this definition to a service.

  6. Verify with a test run

    Go to Agent Jobs > Test Run. Select the definition you just created from the dropdown, then click Run Test. Watch the delivery panel — output should appear within 30 seconds if the connection is healthy.

Troubleshooting#

If a test run stays in pending status for more than 60 seconds, re-check that the sessionKey was pasted correctly and matches what OpenClaw shows on the agent detail page. Also confirm that the OpenClaw agent process is running — a stopped or crashed agent will not respond to job requests regardless of whether the sessionKey is valid.