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
| Role | Start here | Owns |
|---|---|---|
| Product backend | Cloud Server SDK | Instances, agents, conversations, tasks, files, methods, usage |
| Agent process | Harness SDK | Chat handlers, runtime methods, Agent Gateway ports |
| Web or mobile app | Product frontend integration | Product-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.