OCTO — the open workplace built for humans × AI agents.
_{Let Lobsters (OpenClaw-powered digital doubles) do the thinking and doing. You focus on taste.}

🏠 OCTO Home · 🚀 Quickstart · 📦 Ecosystem · 🤝 Contributing

---

🌐 Read in: English · 简体中文

OCTO Adapters

Third-party integrations for OCTO — bridge your chat stack, AI providers, and data sources into Lobster-addressable surfaces.

Every adapter in this repo is a self-contained module that can be enabled or disabled independently. Adapters connect OCTO to external systems — other IM platforms (Slack, Discord, 飞书, Telegram), AI providers (OpenAI, Anthropic, Claude Agent SDK, OpenClaw channels), productivity tools, and webhook sinks — so Lobster agents can reach a user wherever the user already is.

🌟 Why OCTO Adapters

• Plug, don't patch. Drop an adapter in, configure credentials, restart — no core-server fork, no schema surgery. Adapters are loaded at boot from octo-server's config.
• Polyglot on purpose. Adapters live side-by-side in TypeScript (Node) and Python. Pick the language that matches the upstream SDK — this repo is the meeting point.
• Lobster-native. Every adapter exposes the same OCTO-internal envelope (channel id + message + agent context), so Lobster agents can switch transports without learning each vendor's quirks.

🚀 Quickstart

git clone https://github.com/Mininglamp-OSS/octo-adapters.git
cd octo-adapters

# Node adapters — see ./packages for the current list
pnpm install
pnpm --filter <adapter-name> dev

# Python adapters
cd <adapter-dir> && pip install -e .
python -m <adapter_module>.cli

Each adapter has its own README.md under its package directory with credentials setup and a minimal run recipe. Start from that README, not this root.

📦 Modules / Architecture

This release bundles three reference adapter families (see individual package directories for the canonical package name and CLI entry point):

Each adapter implements the same high-level lifecycle:

1. Connect to the upstream transport (WebSocket, HTTP long-poll, gRPC).
2. Authenticate — DH + AES if using OCTO IM's secure framing, OAuth / bearer otherwise.
3. Route inbound messages into the OCTO-internal envelope.
4. Dispatch outbound messages from Lobster agents back to the upstream.
5. Recover — exponential back-off reconnect, idempotent message IDs, session resume.

🔗 OCTO Ecosystem

graph TD
  subgraph Clients[Clients]
    Web[octo-web<br/>Web / PC]
    Android[octo-android<br/>Android]
    iOS[octo-ios<br/>iOS]
  end

  subgraph Core[Core Services]
    Server[octo-server<br/>Backend API]
    Matter[octo-matter<br/>Task / Todo]
    Summary[octo-smart-summary<br/>AI Summary]
    Admin[octo-admin<br/>Admin Console]
  end

  subgraph Shared[Shared Libraries & Integrations]
    Lib[octo-lib<br/>Core Go Library]
    Adapters[octo-adapters<br/>Third-party Adapters]
  end

  Web --> Server
  Android --> Server
  iOS --> Server
  Admin --> Server
  Server --> Matter
  Server --> Summary
  Server --> Adapters
  Server -.uses.-> Lib
  Matter -.uses.-> Lib
  Adapters -.uses.-> Lib

🧭 Philosophy

OCTO ships under three shared principles that apply to every repository in this matrix:

1. Local-first. Anything that can run on the user's own box — chats, embeddings, agents — should. Your data stays yours; cloud is a choice, not a requirement.
2. Humans judge, AI thinks and acts. Humans focus on taste (what matters, what's right, what to ship). Lobster agents — OpenClaw-powered digital doubles — carry the thinking and execution load.
3. Release-as-product. Every open-source cut is shipped as a self-contained product, not a code dump: one squash per release, Apache 2.0, no internal baggage, reproducible from this repo alone.

🤝 Contributing

We love pull requests! Before you open one, please read:

• CONTRIBUTING.md — workflow, branch model, commit style
• CODE_OF_CONDUCT.md — community expectations

If you're writing a new adapter, please see docs/ADAPTER-AUTHORING.md (coming soon) for the integration contract and directory layout.

For security issues please follow SECURITY.md instead of the public tracker.

📄 License

Apache License 2.0 — see LICENSE for the full text and NOTICE for third-party attributions.

---

_{Made with 🐙 by OCTO Contributors · Mininglamp-OSS}