SuperAPI AI 工具集

openclaw-tool-executor

通用与其它

查看项目

更新于 10-16 09:55

技能介绍

用途:为 OpenClaw 智能体提供通用第三方工具执行能力。当用户要求从第三方工具或服务获取信息、或执行操作时,用 Scalekit Connect 发现并运行对应工具。

环境变量(.env):TOOL_CLIENT_ID、TOOL_CLIENT_SECRET、TOOL_ENV_URL 为必需;TOOL_IDENTIFIER 可选但建议设置,作为所有操作的默认 --identifier,未设置时脚本会在运行时询问并警告。

执行流程:

  1. 发现连接:uv run tool_exec.py --list-connections --provider <PROVIDER>,只选 status 为 COMPLETED 的连接,取首个的 key_id 作为 <CONNECTION_NAME>;无连接、或均未完成则告知用户并停止。
  2. 检查与授权:uv run tool_exec.py --generate-link --connection-name <CONNECTION_NAME>。OAuth 已 ACTIVE 则继续,否则生成魔法链接让用户完成;非 OAuth 需账户存在且激活,否则停止。执行流程中不要使用 --get-authorization。
  3. 发现工具:uv run tool_exec.py --get-tool --provider <PROVIDER>;找到匹配工具后必须先获取其 schema:uv run tool_exec.py --get-tool --tool-name <TOOL_NAME>,据 input_schema.properties 与 required 构造输入,不得猜测参数名。
  4. 执行:uv run tool_exec.py --execute-tool --tool-name <TOOL_NAME> --connection-name <CONNECTION_NAME> --tool-input '<JSON_INPUT>'。
  5. 代理回退(无匹配工具时):uv run tool_exec.py --proxy-request --connection-name <CONNECTION_NAME> --path <API_PATH> --method <GET|POST|PUT|DELETE>,可选 --query-params、--body。若返回 TOOL_PROXY_DISABLED,告知用户当前目录不支持该操作。

文件操作:部分提供商无工具,需用代理;注意代理直接透传 OAuth 令牌,不自动刷新,过期会返回 401。Notion 上传文件分三步:创建 file_uploads 对象、发送文件(multipart/form-data)、将 file 块附加到页面;不能识别扩展名时先复制为 .txt。下载为先取页面块中的新签名 URL,再直接从 S3 下载(--output-file 保存的是原始 JSON,不是文件本身)。Google Drive、OneDrive/SharePoint 标注为 coming soon。

支持范围:任何在 Scalekit 中配置的提供商(Notion、Slack、Gmail、Google Sheets、GitHub、Salesforce、HubSpot、Linear 等 50+),--provider 用大写名称。

限制:代理可能被禁;代理令牌不自动刷新;参数必须来自 schema;未提供具体价格、性能或平台细节。