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 のコラボレーションのためのツール群です。クライアントアプリ（Web、Android、iOS、管理コンソール）が通信する統合 REST および WebSocket API を提供し、OpenClaw ベースの「Lobster」AI エージェントと、WuKongIM エンジンを介したリアルタイムメッセージングを調整します。

コア機能（README に記載）

機能	説明
統合 API レイヤー	会話、ユーザー、グループ、ファイル、組織、Webhook 用の REST + WebSocket エンドポイントを公開します。
Lobster エージェントオーケストレーション	OpenClaw ベースのデジタルツインエージェントのセッションをスケジュール、ルーティング、管理します。ツール呼び出しの実行を処理します。
リアルタイムメッセージングコントロールプレーン	WuKongIM（IM コア）を駆動して、メッセージのファンアウト、プレゼンス更新、チャネルイベントを実行します。
認証と RBAC	トークン / Cookie / 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 リポジトリを推奨しています。これにより、サーバーと Web UI、管理コンソール、WuKongIM、MySQL、Redis、MinIO、Nginx を 1 つのコマンドで起動できます。

誰が使うべきか？

AI 拡張コラボレーションツールを構築するプロダクトチーム。エージェントオーケストレーションが組み込まれたセルフホストバックエンドが必要な場合。
プラグ可能なリアルタイムメッセージングレイヤー（WuKongIM）と AI エージェントスケジューリングを組み合わせたい開発者。
「ローカルファースト」アーキテクチャを重視する企業。チャットデータと埋め込みをオンプレミスに保持しながら、AI エージェントを活用したい場合。

ライセンスとコミュニティ

コードは Apache 2.0 ライセンスでリリースされています。プルリクエストによる貢献を歓迎します。リポジトリは標準の CONTRIBUTING ガイドと行動規範に従っています。セキュリティレポートは、提供されている SECURITY.md プロセスに従ってください。

上記の情報はすべてリポジトリの README から直接取得したものであり、外部の仮定は追加されていません。