Providers

集成从 Provider 开始。

Provider 是 AtlasClaw 的集成边界。每个 Provider 都封装目标系统合同、一个或多个 Skills、鉴权上下文、实现脚本,以及让企业 AI 集成保持可理解的参考资料。

运行时架构

先看 Provider 如何承接运行时。

这张架构图展示了 Provider 如何承接鉴权、Skills、脚本与目标系统调用。

AtlasClaw provider runtime overview for Skills, scripts, auth, and enterprise system execution 点击放大

Provider 运行时架构

Provider 把鉴权、Skills、脚本与目标系统执行收拢到清晰边界之内。

文件结构

Provider 文件夹结构。

providers/<provider-name>/
├── PROVIDER.md
├── README.md
└── skills/
    ├── <skill-a>/
    │   ├── SKILL.md
    │   ├── scripts/
    │   └── references/
    └── <skill-b>/
关键原则

让边界明确、脚本收敛。

  • Provider 负责把 AtlasClaw 的身份上下文变成目标系统可接受的鉴权方式。
  • Skill 既保持人类可读,也能绑定到具体脚本入口。
  • Provider Qualified Naming 用于避免跨系统能力冲突。
  • 脚本应该保持窄而可预测,并正确处理密钥与错误映射。
命名约定

Provider Qualified Skills。

通过 provider 前缀避免不同系统技能的命名冲突。

{
  "providers_root": "../atlasclaw-providers/providers",
  "webhook": {
    "systems": [
      {
        "allowed_skills": ["jira:jira-issue"]
      }
    ]
  }
}
参考实现

先看参考,再自己扩展。