BEEOS CLOUD / DEVELOPER REFERENCE
Runtimes and deployment
Choose a framework, template, provider, region, and lifecycle for an agent instance
Discover deployment choices at runtime through catalog.listProviders, listRegions, listModels, and listInstanceTemplates in the TypeScript candidate, or the canonical Go Providers, Regions, Models, and InstanceTemplates modules. A template variant describes its provider, region, resource and OS type. Pass a selected variant when the released client supports it; the canonical Go ServerInstanceCreate has name and optional variant_id.
| Runtime | Integration | Selection |
|---|---|---|
| OpenClaw | Framework adapter plus Harness SDK boundary | Check template availability |
| Hermes | Harness SDK adapter | Check template availability |
| Custom agent | Own host transport and handlers | Configure runtime identity |
| Local / bring your own runtime | Register and route through supported environment | Check provider and network policy |
The Go facade provides Instances.Create, List, Get, GetStatus, Update, Stop, and Delete. Lifecycle writes return an operation alongside instance data, so poll status rather than assuming synchronous readiness. Instance startup, logs, configuration, upgrades, and lifecycle policy have separate API surfaces; use methods exposed by your selected SDK binding.
The regions catalog is the source of deployable options for a given environment. Across cloud or local runtimes, keep the same organization, app, and runtime identity boundaries. See operations for usage and limits.