嵌入式部署
通过独立菜单入口和可选的 Context 感知悬浮助手访问同一个 Agent。两者共享企业系统 Cookie 身份；只有悬浮界面需要严格的页面变化桥接。
选定部署形态，再接入 Provider。
AtlasClaw 支持两种实用形态：把同一个 AI 助手的访问入口内嵌到企业系统，或者作为统一的多用户 AI Agent 层运行在多个企业系统之上。
模式
嵌入式与独立式。
独立式部署
适合企业需要在多个系统之上提供统一的 SSO 多用户 AI Agent 入口。
配置基础
运行时围绕 providers_root 组织。
{
"providers_root": "../atlasclaw-providers/providers",
"service_providers": {
"jira": {
"cloud": {
"base_url": "https://company.atlassian.net",
"token": "${JIRA_API_TOKEN}"
}
},
"smartcmp": {
"prod": {
"base_url": "https://cmp.corp.com/platform-api",
"cookie": "${CMP_COOKIE}"
}
}
}
} 操作建议
保留治理边界。
- 使用 `providers_root` 从外部 providers 仓库加载 Provider 文件夹。
- 密钥放在环境变量里，不要提交到 JSON 配置。
- Embedded 访问使用企业系统 Cookie 身份。独立菜单访问只需企业系统路由；悬浮界面还需发送规范化 path、nonce 与 generation。
- Context 解析与对象操作保留在 AtlasClaw 和 Providers 内部；企业系统不发送业务 DTO，也不直接调用 Agent 或 Tool API。
- Webhook 模式适合系统到系统的 fire-and-forget 调用，并通过受限 Skills 控制执行边界。
- 目标平台的鉴权与审计继续保留在 Provider 和下游平台内部。