OCTO Server is a Go backend exposing REST and WebSocket APIs, Lobster agent orchestration, and a control plane for WuKongIM, with OpenClaw integration and pluggable storage. It serves as the core backend for OCTO's AI-assisted workplace components.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (2 so far).
What it is
OCTO Server is the Go backend at the centre of OCTO — REST + WebSocket APIs, Lobster agent orchestration, and the control plane for WuKongIM. It exposes REST + WebSocket handlers, business logic, and IM fan-out, enabling orchestration of OpenClaw-powered digital doubles and real-time messaging.
How it works
The repository contains a modular structure:
- cmd/ for service entry points (octo-server, subcommands)
- internal/api/ for REST + WebSocket handlers (conversation, user, group, file, org, webhook)
- internal/service/ for business logic (access control, Lobster orchestration, IM fan-out)
- internal/repository/ for SQL + cache repositories (MySQL, Redis)
- internal/im/ for WuKongIM control-plane client (channel / message / presence)
- internal/agent/ for Lobster routing, session store, tool-call execution
- internal/adapter/ for adapter registration + dispatch surfaces
- configs/ for YAML config schema and examples
- migrations/ for SQL schema migrations
- docs/ for architecture notes, API reference, diagrams
Getting started
Quickstart commands:
git clone https://github.com/Mininglamp-OSS/octo-server.git
cd octo-server
go build -o octo-server .
./octo-server --config ./configs/tsdd.yaml
The default dev config expects a local WuKongIM instance and a MySQL-compatible database. See the bundled configs/tsdd.yaml template and QUICKSTART.md for an end-to-end walkthrough, and BUILDING.md for cross-repo notes. For a one-command Docker Compose stack, use the official OOTB deployment at Mininglamp-OSS/octo-deployment.
Getting started (config and ecosystem)
The server orchestrates Lobster (OpenClaw-powered digital doubles) and can route, session, and tool-call execution for agents. It provides pluggable storage and an IM core (WuKongIM) via a thin control-plane boundary, allowing the IM core to remain swappable.
Releases
Latest releases include v1.11.0 (2026-07-20), v1.10.0 (2026-07-15), v1.9.0 (2026-07-13), v1.8.1 (2026-07-06), and v1.8.0 (2026-07-04).
Traction
382 stars total; 1 star gained in the last 24h.
License
Apache-2.0. See LICENSE for full text.