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.

OCTO Server – 개요

OCTO Server는 OCTO 플랫폼을 구동하는 Go 기반 백엔드입니다. OCTO 플랫폼은 인간-AI 협업을 위한 도구 모음입니다. 클라이언트 앱(웹, Android, iOS, 관리 콘솔)이 통신하는 통합 REST 및 WebSocket API를 제공하며, OpenClaw 기반의 "Lobster" AI 에이전트와 WuKongIM 엔진을 통한 실시간 메시징을 조정합니다.

핵심 기능 (README에 설명됨)

기능	설명
통합 API 레이어	대화, 사용자, 그룹, 파일, 조직 및 웹훅을 위한 REST + WebSocket 엔드포인트를 노출합니다.
Lobster 에이전트 오케스트레이션	OpenClaw 기반 디지털 트윈 에이전트의 세션을 스케줄링, 라우팅 및 관리합니다. 도구 호출 실행을 처리합니다.
실시간 메시징 제어 플레인	WuKongIM(IM 코어)을 구동하여 메시지 팬아웃, 프레즌스 업데이트 및 채널 이벤트를 처리합니다.
인증 및 RBAC	토큰 / 쿠키 / DH 봉인 WebSocket 인증, 조직 인식 역할 기반 액세스 제어, 채널별 ACL.
플러그형 스토리지	관계형 데이터에는 MySQL 호환 마이그레이션을 사용하고 캐싱에는 Redis를 사용합니다. 객체 스토리지 어댑터가 포함되어 있습니다.
어댑터 프레임워크	타사 어댑터(예: 외부 IM 브리지, AI 채널)를 등록하고 디스패치할 수 있습니다.
모듈식 아키텍처	명확한 패키지 레이아웃(`api`, `service`, `repository`, `im`, `agent`, `adapter`)으로 코드베이스를 확장 가능하게 만듭니다.

OCTO 생태계에 어떻게 통합되나요?

Clients (web, Android, iOS) → octo-server ←→ octo-matter (tasks)
                                 │            └─ octo-smart-summary (LLM summarisation)
                                 └─ octo-admin (admin UI)
                                 └─ octo-adapters (third-party integrations)
                                 └─ octo-lib (shared Go library)

서버는 중앙 허브입니다. 모든 클라이언트 요청은 서버를 통과하며, Lobster 에이전트를 트리거하거나 데이터를 저장하거나 WuKongIM을 통해 메시지를 푸시할 수 있습니다. 다른 마이크로서비스(Matter, Smart-Summary)는 클라이언트가 직접 호출하는 것이 아니라 서버가 호출합니다.

빠른 시작

# Clone and build
git clone https://github.com/Mininglamp-OSS/octo-server.git
cd octo-server
go build -o octo-server .

# Run with the example config (requires local WuKongIM + MySQL)
./octo-server --config ./configs/tsdd.yaml

전체 스택의 경우 프로젝트는 octo-deployment Docker-Compose 리포지토리를 권장합니다. 이 리포지토리는 서버와 웹 UI, 관리 콘솔, WuKongIM, MySQL, Redis, MinIO 및 Nginx를 단일 명령으로 함께 시작합니다.

누가 사용할 수 있나요?

AI 강화 협업 도구를 구축하는 제품 팀. 에이전트 오케스트레이션이 내장된 자체 호스팅 백엔드가 필요한 경우.
플러그형 실시간 메시징 레이어(WuKongIM)와 AI 에이전트 스케줄링을 결합하려는 개발자.
"로컬 우선" 아키텍처를 중시하는 기업. 채팅 데이터와 임베딩을 온프레미스에 유지하면서 AI 에이전트를 활용하려는 경우.

라이선스 및 커뮤니티

코드는 Apache 2.0 라이선스로 릴리스됩니다. 풀 리퀘스트를 통한 기여를 환영하며, 리포지토리는 표준 CONTRIBUTING 가이드 및 행동 강령을 따릅니다. 보안 보고서는 제공된 SECURITY.md 프로세스를 따라야 합니다.

위의 모든 정보는 리포지토리의 README에서 직접 가져온 것이며 외부 가정은 추가되지 않았습니다.