核心用法
Clawic Hub 作为整个 Clawic 技能生态的基础设施层，采用中心化架构统一管理多技能协作所需的核心服务。其核心用法涵盖四大领域：
1. 配置管理：支持多源配置加载（YAML 文件 + 环境变量覆盖），内置 Schema 校验与热重载能力，开发者可通过 Config.load() 实现环境感知型配置获取。
2. 凭证安全存储：深度集成 macOS Keychain，提供 store-credential / get-credential CLI 工具，支持令牌自动轮换与依赖技能通知机制，避免敏感信息硬编码。
3. 跨技能通信：基于 EventBus 实现 Pub/Sub 消息总线（如 email.received → clawnotify），配合 SkillRegistry 的服务发现与健康检查，构建松耦合的微服务式 AI Agent 架构。
4. 可观测性：结构化日志输出、指标聚合、健康检查端点标准化，支持 300 秒周期自动巡检与 webhook 告警。
显著优点
- 安全架构设计：Keychain 原生集成 + 环境变量降级策略，凭证不落盘；支持加密密钥托管
- 开发体验优化：Python/Bash 双栈 SDK、热重载调试、标准化 Health Check 接口
- 生态扩展性：9+ 官方技能依赖此中枢（clawmail/clawgit/clawslack 等），形成完整工作流闭环
- 运维友好：集中式日志轮转、内存指标保留策略、自动故障恢复脚本
潜在局限与风险
| 维度 | 具体限制 |
|------|---------|
| 平台绑定 | Keychain 深度集成导致 macOS 强依赖，Linux/Windows 需回退至环境变量模式 |
| 单点故障 | 作为中心枢纽，Hub 服务中断将导致全生态技能失联 |
| 权限边界 | Keychain `access_group` 机制若配置不当，可能导致技能间凭证越权访问 |
| 网络暴露 | HTTP API 默认监听 localhost，生产环境需额外配置反向代理与 TLS |
适合人群
- 构建多技能协作 AI Agent 的开发者
- 需要统一凭证治理的小团队（避免各技能重复管理 API Token）
- macOS 生态重度用户，追求系统级安全集成体验
常规风险提示
- 凭证轮换期间可能存在 5-10 秒服务窗口期，建议配合重试逻辑使用
- 日志文件默认 100MB 轮转，高频场景需监控磁盘水位
- 开发模式热重载不适用于生产环境，需显式切换
environment: production