Start with How OpenBot works: what a Bot has, and where you set each part for one Bot, every Bot or everyone. Then the root README, and these references:
- Architecture: services, ports, browser governance, computers, components, plugins, knowledge, and security boundaries.
- Configuration: environment variables and tenant package YAML.
- Personal edition: OpenBot for one person, with no sign-in.
- Development: local setup, migrations, ports, and quality checks.
- The API spec: the REST API in OpenAPI and the live channels in AsyncAPI, the client generated from them, and how to change them.
- API versions and compatibility: what counts as breaking, deprecation, the 12-month support window, minimum app versions, the launcher contract, the security floor, and what CI stops.
- Bots: durable Bot profiles, conversations, visibility, deletion, and external AG-UI registration.
- Approvals: which actions a Bot asks before, the order that decides it, and what an admin can close.
- Routines: the one list of routines, goals and check-ins, how the server fires them, and who they run as.
- Automatic Learning: which Bots contribute conversations to a Learning container, and receive its published skills.
- Public-web research: search and page reading through Parallel, Exa or Firecrawl.
- Plugins, one connector per page — what an administrator registers, what each person consents to, and what the failures mean:
- Composio: a broker, and so a catalogue of apps rather than a single connector.
- Arcade: the other broker, and the setup an Arcade project needs that Composio does not.
- Google Drive
- Notion
- MCP servers added by URL
- Deployment: the container, what is in the image, minimum sizes, and the platform notes.
- Kubernetes: the two Helm charts published with each release,
openbot-bundle(OpenBot and Intelligence together, on one PostgreSQL server) andopenbot(OpenBot alone, pointed at an Intelligence that already runs). Each chart's guide (helm show readme) covers what a cluster needs before it and the values that differ per cloud. From the release after v1.1.2, both connect a team install to CopilotKit's management service by default; see CopilotKit management on Kubernetes. - Releasing: how a release is proposed, reviewed and published.
- Releases and upstream integration: integrating upstream into customer source, kept separate from deploying an accepted release.
- Explicit local updates:
bun scripts/update.ts local, which updates a known source checkout at a maintenance boundary. - Kubernetes release promotion:
bun scripts/update.ts kubernetes, which promotes a release through theopenbotHelm chart. - CopilotKit management on Kubernetes: the management agent both charts install by default, exactly what it sends to CopilotKit, how to turn it off, the Admin → Managed updates screen, and how to let CopilotKit run your upgrades.
- Installer runbook: build an installer, release it, install it on a clean machine, and check that it is the build you meant.
- Windows desktop signing: protected Azure Key Vault signing and verification of the app and NSIS installer.
- Desktop install: the desktop app's setup flow, who owns each step, and the decisions behind it.
- Desktop updates: how OpenBot Desktop updates itself, and how the installation follows it.
- Desktop provider OAuth: the Google, xAI and Unbiased AI model sign-ins, and what a distributor configures for them in a desktop build.
- Desktop telemetry: every event the desktop app sends, and what it carries.
- Product telemetry: the server's usage events, what they carry, and how to turn them off, with example PostHog queries in telemetry-queries.sql. It also notes the management connection a Kubernetes team install makes by default.
- First-use starter tasks: the starter tour offered before a first conversation, and how it was tested.
Do not include credential values, customer data, transcripts, or local-only notes in public docs.