How agentscope-ai/hiclaw works
AgentTeams is a Kubernetes-native multi-agent control plane: people and automation declare Teams and Workers, the controller reconciles their infrastructure and runtime configuration, and agents collaborate through Matrix, shared storage, and task/project workflows. The graph includes the documented QwenPaw, CoPaw, and Hermes worker runtimes plus TeamHarness integrations. Evidence is limited to the README, source index references, and the supplied excerpts; unsampled subsystem links are omitted or marked unverified.
Main entry points: backend Container backends · matrix Matrix services · qwenpaw_worker/worker.py QwenPaw worker · copaw_worker/worker.py CoPaw worker
Components 20
Control plane
- agt CLI
agentteams-controller/cmd/agt/main.go - Team and Worker APIs
agentteams-controller/api/v1beta1/types.go - Controller application
agentteams-controller/internal/app/app.go - Team reconciliation
agentteams-controller/internal/controller/team_controller.go - Worker reconciliation
agentteams-controller/internal/controller/worker_controller.go - Container backends
agentteams-controller/internal/backend - Controller HTTP API
agentteams-controller/internal/server/http.go - Project workflows
agentteams-controller/internal/server/project_handler.go
Runtime services
- Shared object storage
agentteams-controller/internal/oss - AI gateway
agentteams-controller/internal/gateway - Matrix services
agentteams-controller/internal/matrix - AgentLoop observability
Worker runtimes
- QwenPaw worker
qwenpaw/src/qwenpaw_worker/worker.py - CoPaw worker
copaw/src/copaw_worker/worker.py - Hermes worker
hermes/src/hermes_worker/worker.py
Collaboration extensions
- TeamHarness MCP
plugins/teamharness/mcp/server.py - WorkerFlow MCP
plugins/workerflow/mcp/server.py - Plugin manager CLI
plugins/cli/src/agentteams_cli/main.py - Plugin installation
plugins/cli/src/agentteams_cli/plugin_manager.py
Other components
- Users and operators
Connections 28
- Users and operators → agt CLI: manage resources
README.md - agt CLI → Team and Worker APIs: declare resources
- Users and operators → Controller HTTP API: call APIs
README.md - Controller HTTP API → Project workflows: routes workflow requests
- Controller application → Team reconciliation: registers reconciliation
agentteams-controller/internal/app/app.go - Controller application → Worker reconciliation: registers reconciliation
agentteams-controller/internal/app/app.go - Team reconciliation → Container backends: uses runtime backend
agentteams-controller/internal/controller/team_controller.go - Worker reconciliation → Container backends: reconciles deployment
agentteams-controller/internal/controller/worker_controller.go - Team reconciliation → Team and Worker APIs: reads Team resources
agentteams-controller/internal/controller/team_controller.go - Worker reconciliation → Team and Worker APIs: reads Worker resources
agentteams-controller/internal/controller/worker_controller.go - Container backends → QwenPaw worker: runs worker runtime
- Container backends → CoPaw worker: runs worker runtime
- Container backends → Hermes worker: runs worker runtime
- QwenPaw worker → Shared object storage: syncs shared files
README.md - CoPaw worker → Shared object storage: syncs shared files
README.md - Hermes worker → Shared object storage: syncs shared files
README.md - QwenPaw worker → Matrix services: collaborates through Matrix
README.md - CoPaw worker → Matrix services: collaborates through Matrix
README.md - Hermes worker → Matrix services: collaborates through Matrix
README.md - AI gateway → QwenPaw worker: routes model traffic
- AI gateway → CoPaw worker: routes model traffic
- AI gateway → Hermes worker: routes model traffic
- TeamHarness MCP → Matrix services: uses room workflows
- WorkerFlow MCP → Matrix services: supports worker workflows
- Users and operators → Plugin manager CLI: manage plugins
README.md - Plugin manager CLI → Plugin installation: dispatches plugin actions
plugins/cli/src/agentteams_cli/main.py - Controller application → AgentLoop observability: integrates observability
README.md - Controller HTTP API → Shared object storage: serves storage-backed APIs