连接器（Connector）用于将 ArkClaw 与外部系统或平台连接，使 Agent 能调用外部工具、读取外部数据或执行外部服务中的操作。通过为 ArkClaw 添加不同的连接器，您可以灵活扩展其能力边界，让 ArkClaw 直接操作不同的外部工具、读取外部数据或调用外部服务。

本文主要介绍如何查看、配置已有 ArkClaw 连接器，以及如何创建自定义连接器来接入第三方或自建服务。

连接器来源

来源	说明
官方预置	由火山引擎提前配置的连接器，仅需进行简单授权、关联等操作即可使用。了解更多
企业配置	由您的企业管理员提前配置的连接器，供企业组织内的员工使用。了解更多
自定义	由您自行创建的连接器，可接入第三方服务或私有服务，仅可在当前 ArkClaw 中使用。了解更多

操作步骤

查看连接器详情

开启连接器前，您可以查看目标连接器功能、范围、计费与使用方式等信息，确保其满足您的业务要求。

打开浏览器，在浏览器地址栏中输入登录 ArkClaw 链接，按“回车”键。

切换到目标 ArkClaw 后，单击顶部详情图标。

选择“工具套件 > 连接器”页签。

单击目标连接器卡片，了解当前连接器的作用、计费规则、功能范围及提示词示例等信息。

配置 ArkClaw 连接器

打开浏览器，在浏览器地址栏中输入登录 ArkClaw 链接，按“回车”键。

切换到目标 ArkClaw 后，单击顶部详情图标。

选择“工具套件 > 连接器”页签。

单击目标连接器卡片的图标，根据指引完成授权。了解更多

后续，您可以在目标 ArkClaw 对话框的快捷入口中开启/关闭连接器，并在对话中指定连接器完成任务。了解更多

管理自定义连接器

创建自定义连接器

若预置连接器不满足您的需求，或您希望使用自建连接器，可以创建自定义连接器。

打开浏览器，在浏览器地址栏中输入登录 ArkClaw 链接，按“回车”键。

切换到目标 ArkClaw 后，单击顶部详情图标。

选择“工具套件 > 连接器”页签，单击“+ 自定义”按钮。

配置如下信息，单击“确定”按钮。

手动配置

通过 JSON 文件配置

基础信息

参数	说明
连接器名称	自定义连接器名称。
服务端点 URL	指定调用连接器的远程服务地址。
传输协议	指定访问远程服务地址的网络传输协议。支持： Streamable HTTP：基于 HTTP 协议的流式传输方式，支持在单次连接中动态传输数据，兼容性好、部署简单。适用于大多数远程 MCP 服务。
连接器描述	简要描述当前连接器的使用场景、功能等信息，最多不超过 50 字。

认证方式

无需认证

API Key

OAuth 用户委托

OAuth M2M

当前连接器无需任何身份认证，添加后即可直接使用。适用于提供公开服务、无访问限制的连接器。

当前连接器通过 OAuth 用户委托方式进行进行身份认证。添加连接器时，您需要配置授权账号来源（例如飞书、扣子等），后续连接器将代表该账号身份访问和调用服务。适用于所访问资源归属于特定用户的场景（如个人邮箱、日历等）。

参数	说明
OAuth 客户端来源	指定 OAuth 客户端的来源，用于选择系统预置的客户端配置或接入您自定义的 OAuth 客户端。支持：飞书：通过飞书账号完成授权登录的场景。扣子：通过扣子相关账号或能力完成授权登录的场景。 GitHub：通过 GitHub 账号完成授权登录的场景。自定义：使用您自行在 IdP（Identity Provider，身份提供商）中注册的 OAuth 客户端，适用于接入企业自有 IdP 或其他第三方 IdP 的场景。
OAuth 客户端 ID	指定您在 IdP 中注册 OAuth 客户端时，IdP 分配的客户端 ID。
OAuth 客户端密钥	指定您在 IdP 中注册 OAuth 客户端时，IdP 分配的客户端密钥。
配置类型	当您选择自定义客户端时，需指定 OAuth 身份认证服务参数的配置方式。支持：自动发现：填写 IdP 提供的自动发现 URL，系统会通过该 URL 自动获取身份认证服务配置信息。手动配置：若 IdP 不支持通过自发现 URL 同步认证服务参数，您需要手动配置各项参数。包含： Issuer URL：指定 IdP 的唯一标识 URL，用于验证身份令牌是否由可信的 IdP 颁发。授权端点：指定用户登录并同意授权时跳转到的页面地址。系统会将用户重定向到该地址，由 IdP 完成用户身份认证和授权确认。令牌端点 URL：指定系统使用授权结果换取访问令牌的接口地址，系统会向该地址请求 Access Token。响应类型：指定授权流程第一步希望 IdP 返回的结果类型，用于决定 OAuth/OIDC 授权流程的模式。支持： code：返回授权码，系统后续使用授权码向令牌端点换取令牌，适用于服务端安全换取令牌的场景。 token：直接返回 Access Token，适用于无需服务端换取令牌的隐式流程场景。 id_token：直接返回 ID Token，适用于需要获取用户身份信息的 OpenID Connect 场景。 code id_token：同时返回授权码和 ID Token，系统可先获得用户身份信息，并继续使用授权码换取令牌。 code token：同时返回授权码和 Access Token，系统可直接获得访问令牌，并保留使用授权码继续换取令牌的能力。 id_token token：同时返回 ID Token 和 Access Token，系统可同时获得用户身份信息和资源访问令牌。 code id_token token：同时返回授权码、ID Token 和 Access Token，适用于需要在授权第一步同时获得身份信息、访问令牌并保留后续换取令牌能力的混合流程场景。
权限范围	指定 OAuth 授权请求的权限范围。例如 open_id。
自定义参数	自定义 OAuth 授权请求中额外携带的参数，格式为 Key-Value 键值对，最多可添加 10 个自定义参数。
令牌最长过期时间（秒）	令牌的最长有效期，默认为 2592000，单位为秒。注意该值需小于 IdP 对令牌有效期的限制，且令牌过期后，系统需要重新获取令牌。

当前连接器通过 OAuth M2M 方式进行进行身份认证。添加连接器时，添加连接器时，您需要配置授权账号来源（例如飞书、扣子等），后续连接器将以应用/服务自身的身份访问资源，与终端用户无关。适用于多用户共享资源或不涉及具体用户身份的场景。

参数	说明
OAuth 客户端来源	指定 OAuth 客户端的来源，用于选择系统预置的客户端配置或接入您自定义的 OAuth 客户端。支持：飞书：通过飞书账号完成授权登录的场景。扣子：通过扣子相关账号或能力完成授权登录的场景。 GitHub：通过 GitHub 账号完成授权登录的场景。自定义：使用您自行在 IdP（Identity Provider，身份提供商）中注册的 OAuth 客户端，适用于接入企业自有 IdP 或其他第三方 IdP 的场景。
OAuth 客户端 ID	指定您在 IdP 中注册 OAuth 客户端时，IdP 分配的客户端 ID。
OAuth 客户端密钥	指定您在 IdP 中注册 OAuth 客户端时，IdP 分配的客户端密钥。
配置类型	当您选择自定义客户端时，需指定 OAuth 身份认证服务参数的配置方式。支持：自动发现：填写 IdP 提供的自动发现 URL，系统会通过该 URL 自动获取身份认证服务配置信息。手动配置：若 IdP 不支持通过自发现 URL 同步认证服务参数，您需要手动配置各项参数。包含： Issuer URL：指定 IdP 的唯一标识 URL，用于验证身份令牌是否由可信的 IdP 颁发。授权端点：指定用户登录并同意授权时跳转到的页面地址。系统会将用户重定向到该地址，由 IdP 完成用户身份认证和授权确认。令牌端点 URL：指定系统使用授权结果换取访问令牌的接口地址，系统会向该地址请求 Access Token。响应类型：指定授权流程第一步希望 IdP 返回的结果类型，用于决定 OAuth/OIDC 授权流程的模式。支持： code：返回授权码，系统后续使用授权码向令牌端点换取令牌，适用于服务端安全换取令牌的场景。 token：直接返回 Access Token，适用于无需服务端换取令牌的隐式流程场景。 id_token：直接返回 ID Token，适用于需要获取用户身份信息的 OpenID Connect 场景。 code id_token：同时返回授权码和 ID Token，系统可先获得用户身份信息，并继续使用授权码换取令牌。 code token：同时返回授权码和 Access Token，系统可直接获得访问令牌，并保留使用授权码继续换取令牌的能力。 id_token token：同时返回 ID Token 和 Access Token，系统可同时获得用户身份信息和资源访问令牌。 code id_token token：同时返回授权码、ID Token 和 Access Token，适用于需要在授权第一步同时获得身份信息、访问令牌并保留后续换取令牌能力的混合流程场景。
权限范围	指定 OAuth 授权请求的权限范围。例如 open_id。
自定义参数	自定义 OAuth 授权请求中额外携带的参数，格式为 Key-Value 键值对，最多可添加 10 个自定义参数。
令牌最长过期时间（秒）	令牌的最长有效期，默认为 2592000，单位为秒。注意该值需小于 IdP 对令牌有效期的限制，且令牌过期后，系统需要重新获取令牌。

JWT 身份令牌

当您的连接器认证方式为无需认证、 API Key 或 OAuth M2M 时，可选择开启/关闭 JWT 身份令牌功能。开启后，您的服务只需用签名密钥对令牌进行验签，即可确认请求来源合法，并从令牌中直接获取可信的用户身份，无需额外认证交互。

说明

JWT（JSON Web Token）身份令牌是一种用于承载身份与权限声明的标准化令牌格式（RFC 7519），用于在通信双方之间以紧凑、可传输的方式承载身份与权限声明信息。它支持无状态认证，适用于跨服务调用、API 授权、OAuth 2.0 / OIDC 体系等场景，帮助分布式系统构建标准化、可信赖的身份传递链路。

开启本功能后，您可以参考如下流程进行验签操作。

获取验签地址（JWKS URL）。

说明

验签地址（JWKS URL）仅需在首次使用该连接器时获取一次，后续请求直接使用即可。

开启 JWT 身份令牌后，通过 ArkClaw 使用一次该连接器。

从平台向您发送的请求 Header 中取出 x-arkclaw-jwt 的值，用 jwt.io 打开，找到其中的 iss 字段（即 issuer，签发方地址）。

复制 iss 的值，在末尾加上 /.well-known/openid-configuration，用浏览器打开这个地址。

页面会返回一段 JSON，找到其中的jwks_uri字段，该参数值即为验签地址（JWKS URL）。

进行验签。

将上一步获取的 JWKS URL 填入您的验签代码中。

后续每次收到该连接器的请求时，均需对 x-arkclaw-jwt 中的 JWT 进行验签。

修改自定义连接器

您可以按需修改已创建连接器的配置，确保其随时满足您的业务需求。

打开浏览器，在浏览器地址栏中输入登录 ArkClaw 链接，按“回车”键。

切换到目标 ArkClaw 后，单击顶部详情图标。

选择“工具套件 > 连接器”页签。

单击目标连接器卡片。

单击“编辑”按钮，按需修改连接器配置信息，参数详情可参考创建自定义连接器。

单击“确定”按钮，完成修改操作。

删除自定义连接器

若您不再使用自定义连接器，可将其删除。

打开浏览器，在浏览器地址栏中输入登录 ArkClaw 链接，按“回车”键。

切换到目标 ArkClaw 后，单击顶部详情图标。

选择“工具套件 > 连接器”页签。

单击目标连接器卡片。

单击“删除”按钮。

在弹窗中确认注意信息，单击“删除”按钮完成操作。

附录

连接器配置示例

无需认证

​
{​
  "mcpServers": {​
    "my_mcp": {​
      "url": "https://example.com/mcp",​
      "transport": "streamable-http"​
    }​
  }​
}​

参数说明：

参数	说明
my_mcp	请替换为自定义连接器名称。
url	指定调用连接器的远程服务地址。
transport	指定访问远程服务地址的网络传输协议。支持： streamable-http：基于 HTTP 协议的流式传输方式，支持在单次连接中动态传输数据，兼容性好、部署简单。适用于大多数远程 MCP 服务。

API Key

{​
  "mcpServers": {​
    "my_mcp": {​
      "url": "https://example.com/mcp",​
      "transport": "streamable-http",​
      "auth": {​
        "type": "api_key",​
        "in": "header",​
        "name": "api_key",​
        "value": "<API_KEY>"​
      }​
    }​
  }​
}​

参数说明

参数	说明
my_mcp	请替换为自定义连接器名称。
url	指定调用连接器的远程服务地址。
transport	指定访问远程服务地址的网络传输协议。支持： streamable-http：基于 HTTP 协议的流式传输方式，支持在单次连接中动态传输数据，兼容性好、部署简单。适用于大多数远程 MCP 服务。
auth	指定连接器认证信息。 type：指定认证方式。支持： api_key：通过 API Key 进行认证。 in：指定 API Key 的传递方式。支持： header：表示在请求头中传递 API Key。 query：表示在请求 URL Query 中传递 API Key。 name：指定 API Key 在请求中的字段名。 value：指定调用连接器使用的 API Key 值。

参数	说明
传递位置	指定 API Key 的传递方式。支持： Header：表示在请求头中传递 API Key。需配置： Header 名称：指定 API Key 在请求 Header 中的字段名，例如 Authorization。 Key 前缀：指定 API Key 值前附加的前缀，最终格式为 {前缀} {API Key}，例如：Bearer tiku8*****。 Query：表示在请求 URL Query 中传递 API Key。需配置： Query 参数名：指定 API Key 在请求 URL Query 中的参数名，例如 api_key。
API Key	指定调用连接器使用的 API Key 值。

ArkClaw 企业版