用途
setup-agentkit 用于把 AgentKit 接入一个项目,完成三件事:建立仪表盘连接、写入环境凭据、记录第一条连接器路径,然后停止。它不负责后续的应用代码集成,那属于下一个技能。
主要能力
该技能会引导用户打开 app.scalekit.com,进入 Developers → Settings → API Credentials,收集以下内容:
SCALEKIT_ENVIRONMENT_URL=https://your-env.scalekit.com SCALEKIT_CLIENT_ID=<from dashboard> SCALEKIT_CLIENT_SECRET=<from dashboard>
注意:SDK 凭据从上述三个变量读取;部分示例使用 SCALEKIT_ENV_URL 表示同一 URL,但此处使用 SCALEKIT_ENVIRONMENT_URL。
该技能支持在项目 env 文件(.env 或已有的 env 文件)中写入这三个变量,并强调不要将密钥硬编码进源码。
它会引导创建第一条连接:若用户未指定连接器,默认选择 GitHub,无需额外设置,并记录 Connection Name 为 github-connect。若仪表盘已存在目标连接器的记录,则按仪表盘显示的原样记录该 Connection Name。若不存在,则引导用户在 Scalekit Dashboard → AgentKit → Connections → Add connection 中,选择连接器、设置 Connection Name 并保存。对于需要提供方应用的 OAuth 连接器,需打开实时指南 https://docs.scalekit.com/agentkit/connections/ 。
最后记录三项信息供下一个技能使用:连接器(例如 GitHub、Gmail 或 Slack)、Connection Name、目录(https://docs.scalekit.com/agentkit/connectors.md)。
使用方式
按五个步骤执行:
- 获取 API 凭据:从仪表盘收集三个变量;在等待用户提供前,若用户未指定连接器则记录 Connection Name github-connect,并指明下一个技能为 integrate-agentkit,然后等待用户提供三个值。
- 写入项目 env:把三个变量放入项目的 env 文件,确保源码不硬编码密钥。
- 创建首个连接:仅当用户未指定连接器时才询问从哪个连接器开始,默认 GitHub;等待用户确认仪表盘中存在的行,不得编造名称。
- 记录第一条连接器路径:保留连接器、Connection Name、目录三项。
- 指定下一个技能并停止:若用户要求 OpenClaw、Hermes 或常驻主机,则指定 integrate-agentkit-host;否则指定 integrate-agentkit(该技能会创建已连接账号、授权链接和一次 execute_tool 调用)。不要在本技能中编写这些应用代码调用。
适用场景
适用于用户希望在当前项目中完成 AgentKit 的初始接入配置,需要建立仪表盘连接、准备环境凭据并确定首个连接器路径的情况。
限制与注意事项
必须等待用户提供仪表盘凭据值,不得自行编造。必须按仪表盘显示原样记录 Connection Name(用户未指定连接器时为 github-connect)。不得编写应用代码中的工具调用,且必须在等待凭据前先指明 integrate-agentkit。
该技能在完成连接后即停止;已连接账号的创建属于 integrate-agentkit。新环境仅附带一个连接:GitHub,Connection Name 为 github-connect;其他所有连接器(包括 Gmail)都需要先在仪表盘中建立各自的连接,才能进入下一个技能。后续 SDK 调用使用确切的 Connection Name 字符串,而非连接器 slug。
位于 https://mcp.scalekit.com 的 Scalekit MCP 服务器无需额外环境变量,它不能替代 SDK 凭据。连接器可查阅 https://docs.scalekit.com/agentkit/connectors.md 。
相关技能:插件缺失时使用 setup-scalekit;实时工具目录使用 discover-connectors;OpenClaw 或 Hermes 使用 integrate-agentkit-host;用户需要应用登录时使用 setup-saaskit。实时查询入口:文档索引 https://docs.scalekit.com/llms.txt ,连接器目录 https://docs.scalekit.com/agentkit/connectors.md ,MCP https://mcp.scalekit.com 。