[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-82197":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":23,"hasPages":23,"topics":25,"createdAt":10,"pushedAt":10,"updatedAt":41,"readmeContent":42,"aiSummary":43,"trendingCount":16,"starSnapshotCount":16,"syncStatus":44,"lastSyncTime":45,"discoverSource":46},82197,"octo-server","Mininglamp-OSS\u002Focto-server","Mininglamp-OSS","🐙 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.","https:\u002F\u002Fgithub.com\u002FMininglamp-OSS",null,"Go",30,13,21,19,0,4,7,9,12,3.44,"Apache License 2.0",false,"main",[26,27,28,29,30,31,32,33,34,35,36,37,38,39,40],"ai-agents","apache2","chat","collaboration","digital-workplace","go","golang","im","instant-messaging","lobster","openclaw","rest-api","self-hosted","websocket","wukongim","2026-06-12 02:04:24","\u003Cp align=\"center\">\n  \u003Cimg src=\".\u002Fdocs\u002Fassets\u002Flogo-light.png#gh-light-mode-only\" width=\"200\" alt=\"OCTO\">\n  \u003Cimg src=\".\u002Fdocs\u002Fassets\u002Flogo-dark.png#gh-dark-mode-only\" width=\"200\" alt=\"OCTO\">\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Cb>OCTO — the open workplace built for humans × AI agents.\u003C\u002Fb>\u003Cbr\u002F>\n  \u003Csub>Let \u003Cb>Lobsters\u003C\u002Fb> (OpenClaw-powered digital doubles) do the \u003Ci>thinking\u003C\u002Fi> and \u003Ci>doing\u003C\u002Fi>. You focus on \u003Ci>taste\u003C\u002Fi>.\u003C\u002Fsub>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FMininglamp-OSS\">\u003Cb>🏠 OCTO Home\u003C\u002Fb>\u003C\u002Fa> ·\n  \u003Ca href=\"#-quickstart\">\u003Cb>🚀 Quickstart\u003C\u002Fb>\u003C\u002Fa> ·\n  \u003Ca href=\"#-octo-ecosystem\">\u003Cb>📦 Ecosystem\u003C\u002Fb>\u003C\u002Fa> ·\n  \u003Ca href=\".\u002FCONTRIBUTING.md\">\u003Cb>🤝 Contributing\u003C\u002Fb>\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\".\u002FLICENSE\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-Apache_2.0-blue.svg\" alt=\"License\">\u003C\u002Fa>\n  \u003Ca href=\".\u002FREADME.zh.md\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flang-简体中文-red.svg\" alt=\"简体中文\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n---\n\n> 🌐 **Read in**: **English** · [简体中文](README.zh.md)\n\n# OCTO Server\n\n> **The Go backend** at the centre of OCTO — REST + WebSocket APIs, Lobster agent orchestration, and the control plane for WuKongIM.\n\n`octo-server` is the heart of the OCTO platform. It exposes REST +\nWebSocket APIs consumed by\n[`octo-web`](https:\u002F\u002Fgithub.com\u002FMininglamp-OSS\u002Focto-web) and\n[`octo-admin`](https:\u002F\u002Fgithub.com\u002FMininglamp-OSS\u002Focto-admin), orchestrates\nbusiness logic and Lobster (AI agent) scheduling, and drives the\n[`WuKongIM`](https:\u002F\u002Fgithub.com\u002FWuKongIM\u002FWuKongIM) IM core for real-time\nmessaging.\n\n## 🌟 Why OCTO Server\n\n- **One anchor for the whole platform.** Clients, adapters, matter, summary, and admin all meet at `octo-server`. Deploy and scale one backend; everything else speaks to it.\n- **Lobster-orchestration first class.** Routing, session, and tool-call execution for OpenClaw-powered digital doubles are built into the server, not bolted on. Agents are treated as first-class conversation participants.\n- **Pluggable storage & IM.** MySQL-compatible SQL migrations and object-storage adapters ship in the box; WuKongIM is driven over a thin control-plane boundary so the IM core remains swappable.\n\n## 🚀 Quickstart\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FMininglamp-OSS\u002Focto-server.git\ncd octo-server\ngo build -o octo-server .\n.\u002Focto-server --config .\u002Fconfigs\u002Ftsdd.yaml\n```\n\nThe default dev config expects a local WuKongIM instance and a\nMySQL-compatible database. See the bundled `configs\u002Ftsdd.yaml`\ntemplate for the standalone-binary path, [`QUICKSTART.md`](.\u002FQUICKSTART.md) for an\nend-to-end walkthrough, and [`BUILDING.md`](.\u002FBUILDING.md) for\ncross-repo build notes.\n\nFor a one-command Docker Compose stack (server + admin + web + matter\n+ smart-summary + WuKongIM + MySQL + Redis + MinIO + nginx), use the\n**official OOTB deployment** at\n[`Mininglamp-OSS\u002Focto-deployment`](https:\u002F\u002Fgithub.com\u002FMininglamp-OSS\u002Focto-deployment).\nThe older `docker\u002Focto\u002F` and `docker\u002Ftsdd\u002F` compose stacks that used\nto live in this repo have been retired in favour of that single\nsource of truth.\n\n## 📦 Modules \u002F Architecture\n\nHigh-level layout:\n\n| Path | Purpose |\n|---|---|\n| `cmd\u002F` | Service entry points (`octo-server`, subcommands) |\n| `internal\u002Fapi\u002F` | REST + WebSocket handlers — conversation, user, group, file, org, webhook |\n| `internal\u002Fservice\u002F` | Business logic — access control, Lobster orchestration, IM fan-out |\n| `internal\u002Frepository\u002F` | SQL + cache repositories (MySQL, Redis) |\n| `internal\u002Fim\u002F` | Control-plane client for WuKongIM (channel \u002F message \u002F presence) |\n| `internal\u002Fagent\u002F` | Lobster routing, session store, tool-call execution |\n| `internal\u002Fadapter\u002F` | Adapter registration + dispatch surfaces |\n| `configs\u002F` | YAML config schema + dev \u002F prod examples |\n| `migrations\u002F` | SQL schema migrations |\n| `docs\u002F` | Architecture notes, API reference, diagrams |\n\nWhat the server does each request:\n\n1. **Authenticate** — token \u002F cookie \u002F DH-sealed WebSocket frame.\n2. **Authorise** — org-aware RBAC, per-channel ACL, agent-identity gating.\n3. **Execute** — run business logic, possibly spawning \u002F resuming a Lobster agent session.\n4. **Fan out** — enqueue IM message via WuKongIM, trigger adapters if the channel requires an external bridge.\n5. **Respond** — unified JSON envelope (or WebSocket frame) with tracing + metrics tags.\n\n## 🔗 OCTO Ecosystem\n\n\u003C!-- shared snippet: OCTO repo matrix. Keep identical across all 9 repos. -->\n\n```mermaid\ngraph TD\n  subgraph Clients[Clients]\n    Web[octo-web\u003Cbr\u002F>Web \u002F PC]\n    Android[octo-android\u003Cbr\u002F>Android]\n    iOS[octo-ios\u003Cbr\u002F>iOS]\n  end\n\n  subgraph Core[Core Services]\n    Server[octo-server\u003Cbr\u002F>Backend API]\n    Matter[octo-matter\u003Cbr\u002F>Task \u002F Todo]\n    Summary[octo-smart-summary\u003Cbr\u002F>AI Summary]\n    Admin[octo-admin\u003Cbr\u002F>Admin Console]\n  end\n\n  subgraph Shared[Shared Libraries & Integrations]\n    Lib[octo-lib\u003Cbr\u002F>Core Go Library]\n    Adapters[octo-adapters\u003Cbr\u002F>Third-party Adapters]\n  end\n\n  Web --> Server\n  Android --> Server\n  iOS --> Server\n  Admin --> Server\n  Server --> Matter\n  Server --> Summary\n  Server --> Adapters\n  Server -.uses.-> Lib\n  Matter -.uses.-> Lib\n  Adapters -.uses.-> Lib\n```\n\n| Repository | Language | Role |\n|---|---|---|\n| [`octo-server`](https:\u002F\u002Fgithub.com\u002FMininglamp-OSS\u002Focto-server) | Go | Backend API · business orchestration · Lobster agent scheduling |\n| [`octo-matter`](https:\u002F\u002Fgithub.com\u002FMininglamp-OSS\u002Focto-matter) | Go | Task \u002F Todo \u002F Matter micro-service |\n| [`octo-smart-summary`](https:\u002F\u002Fgithub.com\u002FMininglamp-OSS\u002Focto-smart-summary) | Go | LLM-powered conversation summarisation |\n| [`octo-web`](https:\u002F\u002Fgithub.com\u002FMininglamp-OSS\u002Focto-web) | TypeScript \u002F React | Web & PC (Electron) client |\n| [`octo-android`](https:\u002F\u002Fgithub.com\u002FMininglamp-OSS\u002Focto-android) | Kotlin \u002F Java | Native Android client |\n| [`octo-ios`](https:\u002F\u002Fgithub.com\u002FMininglamp-OSS\u002Focto-ios) | Swift \u002F Objective-C | Native iOS client |\n| [`octo-admin`](https:\u002F\u002Fgithub.com\u002FMininglamp-OSS\u002Focto-admin) | TypeScript \u002F React | Admin console (tenant \u002F org \u002F user \u002F channel management) |\n| [`octo-lib`](https:\u002F\u002Fgithub.com\u002FMininglamp-OSS\u002Focto-lib) | Go | Shared core library (protocol, crypto, storage, HTTP) |\n| [`octo-adapters`](https:\u002F\u002Fgithub.com\u002FMininglamp-OSS\u002Focto-adapters) | TypeScript \u002F Python | Third-party integrations (IM bridges, AI channels) |\n\n## 🧭 Philosophy\n\nOCTO ships under three shared principles that apply to every repository in this matrix:\n\n1. **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.\n2. **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.\n3. **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.\n\n## 🤝 Contributing\n\nWe love pull requests! Before you open one, please read:\n\n- [CONTRIBUTING.md](CONTRIBUTING.md) — workflow, branch model, commit style\n- [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) — community expectations\n\nFor security issues please follow [SECURITY.md](SECURITY.md) instead of the public tracker.\n\n## 📄 License\n\nApache License 2.0 — see [LICENSE](LICENSE) for the full text and [NOTICE](NOTICE) for third-party attributions.\n\n## 🙏 Acknowledgments\n\n`octo-server` is a derivative work of:\n\n- **[TangSengDaoDaoServer](https:\u002F\u002Fgithub.com\u002FTangSengDaoDao\u002FTangSengDaoDaoServer)** — our upstream, by the TangSengDaoDao team.\n- **[WuKongIM](https:\u002F\u002Fgithub.com\u002FWuKongIM\u002FWuKongIM)** — the real-time messaging core we drive.\n\nSee [NOTICE](NOTICE) for the exhaustive Go module license inventory and third-party attribution block.\n\n---\n\n\u003Cp align=\"center\">\n  \u003Csub>Made with 🐙 by \u003Cb>OCTO Contributors\u003C\u002Fb> · \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FMininglamp-OSS\">Mininglamp-OSS\u003C\u002Fa>\u003C\u002Fsub>\n\u003C\u002Fp>\n","OCTO Server 是一个用 Go 语言编写的后端服务，为人类与 AI 代理构建的开放工作场所 OCTO 提供支持。它通过 REST 和 WebSocket API 实现了 Lobster（一种基于 OpenClaw 的数字代理）的编排，并集成了 WuKongIM 实时消息系统作为控制平面。该项目的核心功能包括统一管理平台上的所有客户端和服务、内置对 AI 代理的一流支持以及可插拔的数据存储和即时通讯解决方案。适合需要高效协作且集成人工智能助手的企业或团队使用，在保证灵活性的同时提供了强大的扩展能力。",2,"2026-06-11 04:08:02","CREATED_QUERY"]