mininglamp-oss/octo-adapters

octo-adapters is a collection of plug-in connectors for OCTO, a workplace platform that pairs human users with AI agents called Lobsters. Rather than a single application, this repository holds a set of independent modules, each of which connects OCTO to one external system, such as a chat platform, an AI provider, or a webhook destination, so that Lobster agents can reach users through the tools they already use. Each adapter is meant to be dropped in and configured with credentials, then loaded automatically when the main OCTO server starts, without needing to modify or fork the core server code. Adapters are written in either TypeScript or Python, chosen based on whichever language matches the external service's own SDK, and all of them speak the same internal message format so Lobster agents do not need to learn the quirks of each individual platform. The repository currently bundles three example adapter families: a gateway connecting the Claude Agent SDK to OCTO's messaging protocol over WebSocket, with encrypted framing and automatic reconnect, a channel plugin for OpenClaw, an AI agent framework, that adds real time message delivery, typing indicators, and read receipts, and a Python based adapter for something called Hermes Agent. Every adapter follows the same basic pattern: connect to the external service, authenticate, translate incoming messages into OCTO's internal format, send outgoing messages back out, and automatically recover the connection if it drops. octo-adapters is one piece of a larger family of repositories that together make up OCTO, including separate backend, mobile, and admin console projects, mostly written in Go, TypeScript, Kotlin, and Swift. The project follows three stated principles: keep things running locally where possible, let humans decide what matters while AI agents handle execution, and ship every open source release as a clean, self-contained product. The code is released under the Apache 2.0 license.