Mininglamp-OSS/octo-server

🐙 The Go backend powering OCTO — an open workplace built for humans × AI agents. REST & WebSocket APIs, Lobster (AI agent) orchestration, and WuKongIM real-time messaging control plane.

What it solves

OCTO Server provides a centralized backend for a collaborative workplace platform designed for human-AI collaboration. It eliminates the need for fragmented backends by acting as a single anchor for clients, admin consoles, and AI agents, while managing the complex orchestration of real-time messaging and agent scheduling.

How it works

Built in Go, the server exposes REST and WebSocket APIs to handle communication between users and AI agents. It integrates with WuKongIM for real-time messaging and uses a dedicated agent module to manage "Lobster" agents (OpenClaw-powered digital doubles). The server handles authentication, RBAC authorization, and the execution of agent sessions and tool calls, then fans out messages to the appropriate channels or external adapters.

Who it’s for

Developers and organizations looking to build or deploy a local-first, AI-integrated workplace environment where AI agents can act as first-class participants in conversations.

Highlights

  • Agent-First Orchestration: Built-in routing, session management, and tool-call execution for AI agents.
  • Local-First Philosophy: Designed to keep data and agents running on the user's own hardware.
  • Pluggable Architecture: Supports MySQL-compatible storage and swappable IM cores via a thin control-plane boundary.
  • Unified Control Plane: Serves as the central hub for the entire OCTO ecosystem, including web, mobile, and admin clients.