Yuan-lab-LLM/ClawManager

A Kubernetes-native control plane for AI agent instance management, with governed AI access, runtime orchestration, and reusable resources across multiple agent runtimes.

ClawManager – 面向 AI 代理的 Kubernetes 原生控制平面

是什么 – ClawManager 是一个开源平台,可在 Kubernetes 集群内运行、治理并协作管理 AI 代理工作区(如聊天机器人、代码助手)。它提供一个单一的 Web 控制台,整合了运行时编排、模型访问治理、可重用资源注入、基于团队的协作以及安全监控功能。

为何重要 – 大规模部署 AI 代理通常需要大量手动的 Kubernetes 配置:创建 Pod、处理存储、保护模型 API 密钥、跟踪使用情况。ClawManager 将所有这些抽象为一个“控制平面”,使操作员只需点击一下即可部署代理、强制执行策略,并审计 AI 流量,而无需向最终用户暴露底层集群。


核心功能(如 README 所述)

领域 提供的功能
运行时与实例管理 以 Lite(共享网关池)或 Pro(专用桌面)模式创建和管理 OpenClaw、Hermes、OpenCode 或 DeepSeek Harness 工作区。控制 CPU/内存/存储,查看文件,获取 shell/桌面访问权限,并生成密码保护的共享链接。
北向 API 与企业认证 独立的 API 网关,支持 JWE 认证、作用域令牌、mTLS、LDAP/LDAPS 以及速率限制。外部系统可程序化地创建、查询、重启或重置实例。
AI 网关 集中化、受治理的模型调用入口(OpenAI、Anthropic 等)。提供模型目录、健康状态、定价、审计日志、实例级令牌计费和基于风险规则的路由。
代理控制平面 运行时代理安全注册,发送心跳,接收命令,并与控制台中定义的期望状态保持同步。
资源管理 可重用的“资源”、“资源包”和“注入记录”,用于频道、技能 ZIP、定时任务和环境变量。Skill Hub 支持版本控制、所有权和发布。
团队协作 由领导者主导的工作区:一个 OpenClaw Lite “领导者”将用户请求分解,分配任务给工作者(OpenClaw/Hermes Lite),通过执行看板跟踪进度,并发布最终合成结果。
安全防护平台 管理员专用控制台,展示四层防御机制(运行时、主机/容器、组件信任、出站治理)、实时警报、紧急关闭开关、全链路审计和策略配置。

架构快照

  • 前端 – React(v19)UI,作为用户和管理员的 Web 门户提供。
  • 后端 – Go 1.21+ 服务,处理控制平面逻辑、API 网关和安全模块。
  • 状态存储 – MySQL 用于持久化平台数据。
  • Kubernetes – 可部署在任意 K8s 发行版(k3s 或完整集群)上。使用标准 CSI 存储类(如 Longhorn),支持单节点或多节点部署。
  • 运行时 Pod – 管理的工作区以侧车容器(Lite)或专用 Deployment(Pro)形式在集群内运行。
  • 支持服务 – 技能扫描器、对象存储、Redis Team Bus(团队消息)、可选 LDAP 集成。

典型工作流

  1. 管理员 定义治理策略(模型访问、成本限制、安全规则),并创建可重用资源(技能、频道模板)。
  2. 用户 打开门户,选择运行时(如 OpenClaw Lite),启动工作区。
  3. 工作区 Pod 注册到代理控制平面,并接收其期望配置。
  4. 所有来自工作区的 AI 调用均通过 AI 网关,进行日志记录、成本追踪,并根据风险规则选择性重定向。
  5. 对于协作任务,用户创建 团队;领导者分解请求,分配工作者,聚合结果。
  6. 管理员监控安全警报,并可触发电路断路器以停止可疑活动。

快速开始(来自 README)

  1. 选择 Kubernetes 发行版 – k3s(单节点或集群)或标准 k8s 集群。
  2. 从 deployments/ 文件夹应用适当的 clawmanager.yaml 清单(示例包括单节点的 HostPath 或集群存储的 CSI/RWX)。
  3. 按照 用户指南(docs/use_guide_en.md)完成首次登录流程。
  4. 如需外部程序化控制,可选择性部署 北向 API 插件(deployments/k8s/northbound/)。
  5. 如需,可通过管理员控制台配置 LDAP 或其他认证方式。

哪些团队应考虑使用

  • 平台/DevOps 团队:需要为内部用户或客户部署大量 AI 代理实例,但不想为每个实例手动编写 Kubernetes 对象。
  • 产品团队:构建需要受控模型使用、成本可见性和审计追踪的 AI 增强型应用。
  • 安全导向组织:希望内置运行时加固、策略强制和 AI 工作负载的事件响应工具。
  • 研究实验室:希望拥有共享“团队”工作区,让多个代理协同解决单一问题。

社区与支持

  • Discord 和 WeChat 群组(README 中的二维码)用于实时讨论。
  • GitHub 上的开放问题追踪器用于报告 Bug 和功能请求。
  • MIT 许可证 – 可自由使用、修改和商业化。

总结 – ClawManager 是一个全栈式、Kubernetes 原生平台,将 AI 代理转变为可治理的一流工作负载,通过单一 Web 控制台处理从部署到安全和成本核算的全部流程。

相关

  • 项目
  • 项目
  • 项目
  • 项目