DocsStart

BEEOS CLOUD / DEVELOPER REFERENCE

Build with BeeOS Cloud

APIs and SDKs for persistent agents, product apps, and live data channels

BeeOS Cloud gives a product backend a control plane for agent instances and gives running agents a separate messaging and runtime interface. Build with your own users, model choices, and application UI.

  • Launch an agent — Create an instance and start a conversation from your backend.

  • Choose an SDK — Choose the Server or Harness SDK for your code.

  • Build a custom agent — Handle chat, cancellation, and runtime methods.

  • Connect an app — Connect your product frontend through its backend and scoped data channels.

Two SDKs, three integration roles

RoleStart hereOwns
Product backendCloud Server SDKInstances, agents, conversations, tasks, files, methods, usage
Agent processHarness SDKChat handlers, runtime methods, Agent Gateway ports
Web or mobile appProduct frontend integrationProduct-owned event channel and authorized data streams; no separate Cloud client SDK

Cloud Server API requests use bsk_ keys. Agent runtimes use runtime credentials. A product frontend uses its product session and receives short-lived, purpose-scoped data descriptors only after its backend authorizes the user.

Explore architecture, authentication, OpenClaw, Hermes, and A2HTML architecture.