嵌入式部署
通过独立菜单入口和可选的 Context 感知悬浮助手访问同一个 Agent。两者共享企业系统 Cookie 身份；只有悬浮界面需要严格的页面变化桥接。
选定部署形态，再接入 Provider。
AtlasClaw 支持嵌入式访问和独立式多用户 AI Agent 层。独立式部署既可以运行在单节点，也可以在满足明确的共享状态、路由与 Channel 约束时使用 v1.0.0 最小 HA 运行时。
模式
访问方式与运行模式。
独立式部署
适合企业需要在多个系统之上提供统一的 SSO 多用户 AI Agent 入口。单节点同时支持 long-connection 与 webhook Channel 模式。
高可用运行时
多个应用节点使用共享 MySQL 与已初始化的共享 Workspace，每个节点具有稳定 ID，并对每个已认证用户执行粘性路由。
配置基础
运行时围绕 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}"
}
}
}
} 高可用
显式配置共享状态与节点归属。
v1.0.0 提供最小 HA 运行时；部署前必须满足数据库、Workspace、节点身份和粘性路由条件。
alembic upgrade head
ATLASCLAW_ENABLE_HA=true
ATLASCLAW_HA_NODE_ID=<unique-node-id>
ATLASCLAW_RUN_AGENT_HEARTBEAT=false 运行边界
Channel ownership 不做隐式转移。
- 使用共享 MySQL；SQLite 不能作为 HA 数据库。应用节点启动前应初始化共享 Workspace，并且只执行一次 migration。
- 为每个实例分配稳定且唯一的 node ID，并配置上游代理，让同一个已认证用户的请求始终进入同一节点。
- 启用单例 Agent Heartbeat 任务时，最多只在一个节点设置 `ATLASCLAW_RUN_AGENT_HEARTBEAT=true`。
- 每个节点的 Token Health、Heartbeat 状态和工作 runtime 目录保持在该节点本地。
- HA 只接受已注册的 long-connection Channel 模式；Webhook 模式会被拒绝，节点永久故障后也不会自动转移 Channel ownership。
操作建议
保留治理边界。
- 使用 `providers_root` 从外部 providers 仓库加载 Provider 文件夹。
- 密钥放在环境变量里，不要提交到 JSON 配置。
- Embedded 访问使用企业系统 Cookie 身份。独立菜单访问只需企业系统路由；悬浮界面还需发送规范化 path、nonce 与 generation。
- Context 解析与对象操作保留在 AtlasClaw 和 Providers 内部；企业系统不发送业务 DTO，也不直接调用 Agent 或 Tool API。
- 单节点部署可以使用 Webhook 模式执行受限 Skills 的系统到系统 fire-and-forget 调用；HA 会拒绝 Webhook Channel 模式。
- 目标平台的鉴权与审计继续保留在 Provider 和下游平台内部。