Scalekit Agent Auth

核心功能

OpenClaw Tool Executor 是一个通用第三方工具执行引擎，旨在让 AI Agent 能够安全、标准化地调用外部 SaaS 服务。其核心能力包括：

连接发现与授权管理：自动列出并选择已配置的连接，智能识别 OAuth 与 API Key/Basic/Bearer 等非 OAuth 认证类型，处理授权链接生成与状态检查。

动态工具发现与执行：通过 --get-tool 接口动态获取工具列表及 JSON Schema，确保参数构造严格符合 API 定义，避免猜测字段名称。

代理回退机制：当原生工具缺失时，可尝试直接代理 HTTP 请求至服务商 API，但受环境策略限制可能被禁用。

显著优点

• 统一抽象层：屏蔽不同服务商的认证差异（OAuth 2.0、API Key、Basic Auth），开发者无需关心底层实现。
• 实时 Schema 驱动：执行前强制获取工具 Schema，显著降低因参数错误导致的调用失败。
• 高扩展性：支持 Notion、Slack、Gmail、GitHub、Salesforce、HubSpot、Linear 等 50+ 主流 SaaS 平台。
• 企业级安全：通过 Scalekit 托管凭证，避免明文存储密钥；支持连接级别权限隔离。

潜在局限

• 强依赖 Scalekit 生态：必须拥有 Scalekit 账号及环境，无法独立运行。
• 代理回退不稳定：--proxy-request 可能在部分环境被禁用，导致未覆盖功能无法使用。
• 多连接自动选择风险：当存在多个同类型连接时，自动选择第一个可能不符合用户预期。
• 运行时依赖：需要 uv 和 python3 环境，且需配置 3-4 个环境变量。

适用人群

• 企业自动化工程师：需要集成多 SaaS 工作流
• AI Agent 开发者：构建需要外部工具调用的智能体
• 运维/DevOps：管理跨平台连接与授权

常规风险

• 凭证泄露风险：TOOL_CLIENT_SECRET 等敏感变量需妥善保管
• 数据权限边界：Scalekit 连接权限配置不当可能导致越权访问
• 代理请求审计盲区：直接代理 API 调用可能绕过部分审计日志
• OAuth Token 有效期：长会话可能因 Token 过期中断，需关注刷新机制

核心用法

OpenClaw Tool Executor 是一款通用型第三方工具执行技能，专为 Agent 与外部 SaaS 服务（如 Notion、Slack、GitHub、Salesforce 等）的安全集成而设计。其核心工作流程遵循"发现-授权-执行"三阶段模型：

第一阶段：连接发现。通过 --list-connections 动态枚举指定 Provider 的所有已配置连接，自动处理分页并返回首个可用连接的 key_id 作为后续操作的 connection_name。

第二阶段：授权检查。运行 --generate-link 自动检测连接类型（OAuth 或 API Key/Bearer/Basic），对 OAuth 连接生成魔法链接引导用户完成授权流程，对非 OAuth 连接则验证账户激活状态。

第三阶段：工具执行。通过 --get-tool 获取目标 Provider 的可用工具列表及详细 Schema，严格依据 Schema 构造参数后使用 --execute-tool 完成调用。若目标动作暂无对应工具，则通过 --proxy-request 尝试直接代理请求至 Provider API。

该技能支持 50+ 主流服务，包括 Notion、Slack、Gmail、GitHub、Google Sheets、Salesforce、HubSpot、Linear、Exa、LinkedIn（通过 HarvestAPI）等，覆盖搜索、读写、消息发送、数据库查询、任务管理等典型场景。

显著优点

统一抽象层。无论底层是 OAuth 2.0 还是 API Key，开发者使用一致的命令接口，大幅降低多服务集成的认知负担。

Schema 驱动安全。强制执行"先获取 Schema 再构造输入"的流程，杜绝参数猜测导致的调用失败或意外行为，输入数据经结构化验证后传输。

智能降级机制。当特定功能未纳入 Scalekit 工具目录时，自动切换至 HTTP 代理模式，保障业务连续性；同时明确提示用户可发起新工具需求。

企业级安全底座。由身份即服务厂商 Scalekit Inc. 官方维护，所有通信经 TLS 1.2+ 加密，凭证严格通过环境变量注入，符合 GDPR 数据最小化原则。

潜在缺点与局限性

网络依赖性强。所有功能依赖 Scalekit Cloud 服务可用性，若官方 API 出现延迟或故障，技能将完全不可用。

代理能力受限。--proxy-request 可能在部分企业环境中被显式禁用（TOOL_PROXY_DISABLED），此时未覆盖的 API 端点无法访问。

多连接选择模糊。当同一 Provider 存在多个连接时，自动选择首个连接的机制可能不符合用户预期，需人工介入确认。

Schema 变更敏感。第三方服务的 API Schema 更新可能导致工具执行失败，需等待 Scalekit 侧同步更新工具定义。

适合的目标群体

• 企业自动化团队：需快速打通 CRM、ERP、协作平台数据孤岛的系统集成工程师
• AI Agent 开发者：构建需要实时调用外部工具完成复杂任务的智能体应用
• 低代码/无代码平台用户：希望通过自然语言指令直接操作 SaaS 工具的业务人员
• 安全合规敏感型组织：寻求标准化 OAuth 流程与凭证托管方案，避免自研认证系统的企业

常规使用风险

性能风险。涉及多次网络往返（发现连接→检查授权→获取 Schema→执行工具），高延迟场景下响应时间可能达数秒；代理模式增加额外跳转。

凭证泄露风险。虽然代码层面无硬编码密钥，但用户需自行保障 .env 文件不被提交至版本控制，且 TOOL_CLIENT_SECRET 具备较高权限，泄露可能导致全量连接被滥用。

数据出境风险。Scalekit 为云服务，工具执行过程中的请求数据、响应内容均流经 Scalekit 基础设施，涉及敏感数据时需评估合规要求。

依赖版本风险。pyproject.toml 使用宽松版本约束（>=2.6.1），可能意外引入 SDK 破坏性变更，建议生产环境锁定精确版本。