You need to enable JavaScript to run this app.
文档中心
ArkClaw 企业版

ArkClaw 企业版

复制全文
下载 pdf
应用中心
注册应用
复制全文
下载 pdf
注册应用
本文为您介绍如何使用应用中心对企业内的 AI 应用资产( Agent、MCP 等)进行统一注册、管理和发布。企业版 ArkClaw 应用中心提供了一个统一的平台,用于注册与管理企业存量的 AI 应用资产。管理员可以将企业已有的 AI 能力,如 Agent、MCP( Method, Capability, Plugin)等,进行纳管与公开发布,形成一个可被空间内员工的 ArkClaw 实例便捷发现、安全调用和有效管理的企业级AI资产库。​
前提条件​
在开始操作前,请确保满足以下条件:​
  • 用于注册的应用(Agent 或 MCP)网络可访问。应用中心不提供额外的网关代理,其网络可达性依赖 ArkClaw 企业版空间(Space)的网络配置。​
  • 如需注册来源为 AgentKit 的应用,请确保您的火山引擎账号拥有访问相应 AgentKit 资源的权限。​
访问认证说明​
  • 应用来源于 AgentKit:当前支持注册 API key 类型和 OAuth JWT 类型的 Runtime 和 MCP。​
  • 应用来源于自定义类型的 MCP:支持无需认证、API key 类型或 OAuth JWT 类型。​
  • 应用来源于自定义类型的 Agent:支持无需认证、API key 类型或 OAuth JWT 类型。​
说明​
如果是 API key 类型或 OAuth JWT 类型,所选凭据可提前在凭据管理中创建,系统调用应用时会自动使用所选凭据完成认证。​
注册应用​
注册 Agent​
企业管理员可以将符合 A2A 协议的智能体(Agent)注册到 ArkClaw 企业版应用中心,使其能被空间内员工的 Claw 实例发现和调用。​
  1. 在左侧导航树中,选择“能力中心 > 应用中心”。​
  1. 在“企业 Agent”页签下,单击“注册 Agent”按钮。​
  1. 参考下表,配置 Agent 信息。​
  • ​
    AgentKit
    共享Claw(旧版)即将下线
    自定义
    ​
    AgentKit来源的应用参数配置及说明如下表所示。​
    ​
    参数​
    说明​
    名称​
    Agent 应用的唯一应用标识名。​
    • 应用被其他 Claw 调用时,该名称会作为 Client Claw 的上下文输入。​
    • 名称长度为 2~64 个字符,且 UTF-8 编码后总长度不能超过 64 字节;支持中文、英文字母、数字、下划线(_)和中划线(-)。应用创建成功后不可修改。​
    • 应用的名称在 ArkClaw 企业版空间下“唯一”,不可重复,且 Agent 应用与 MCP 应用也不能重名。​
    应用描述​
    Agent 应用的描述信息。​
    • 会用于 Claw 实例上下文输入,描述内容直接影响 Claw 实例调用应用的实现效果,长度在 1~4000 字符。​
    • 需包含应用的主要能力介绍、适用/不适用场景说明,描述中可以给出典型调用示例以供员工调用时参考。​
    • 描述示例:​
    • 面向企业研究和情报分析场景的互联网搜索 Agent,负责根据自然语言查询自动检索多源网页信息并整理要点。适用于需要快速了解行业趋势、竞品动态、技术方案等信息的场景。典型用法包括:“搜索最近三年 AIGC 在广告行业的应用案例并按场景分类”,“帮我整理几篇关于多智能体协同架构的权威文章”。​
    来源​
    选择应用来源,此处选择 AgentKit ,表明应用来源于注册在 AgentKit 中的智能体运行时。​
    访问权限​
    设置应用可访问范围。​
    • 全量开放:应用对全部可见、可使用,允许所有人使用此应用。​
    • 受控访问:对指定的部门、用户组或用户开放此应用,仅有权限的员工可见、可使用。​
    说明​
    当生效范围为「全员、部门、用户组」时,后续新增成员会自动继承该权限规则。​
    • 全量禁止:应用对所有人均不可见,不允许任何人使用此应用。​
    可访问范围​
    仅访问权限为 “受控访问” 时需配置此参数。单击“添加”按钮,添加可访问此 Agent 应用的部门/用户组/指定用户。​
    所属项目​
    选择应用所属项目,更多信息请参见项目管理 。​
    智能体运行时​
    选择用于创建 Agent 应用的智能体运行时。​
    注意​
    仅可选择当前火山引擎账号权限范围内、状态为“可用”、入站认证为 “API Key” 或 “OAuth” 类型且支持 A2A 协议的智能体运行时。​
    应用地址​
    选择用于创建 Agent 应用的智能体运行时的可访问地址。​
    • 如果应用的可访问地址仅支持“公网”访问,请确保当前 ArkClaw 下的“网络配置”中已开启公网出口。​
    • 如果应用的可访问地址仅支持“私网”访问,请确保当前 ArkClaw 下的“网络配置”中已开启私网出口,并配置可访问的私网出口信息。具体操作可参见本文网络配置说明。​
    • 如果应用的可访问地址同时支持“公网”访问和“私网”访问,请根据实际情况配置公网出口/私网出口,确保 ArkClaw 可访问即可。​
    ​
    ​
    ​
  1. 单击“确定”按钮,完成配置。​
注册 MCP​
企业管理员可以将企业内部的 MCP(Model Context Protocol)服务或工具集注册到应用中心,使其能被 ArkClaw 企业版空间内员工的 ArkClaw 实例发现和调用。​
  1. 在左侧导航树中,选择“能力中心 > 应用中心”。​
  1. 在“企业 MCP”页签下,单击“注册 MCP”按钮。​
  1. 参考下表,配置 MCP 信息。​
  • ​
    AgentKit
    自定义
    ​
    AgentKit来源的应用参数配置及说明如下表所示。​
    ​
    参数​
    说明​
    名称​
    MCP 应用的唯一应用标识名。​
    • 应用被其他 Claw 调用时,该名称会作为 Client Claw 的上下文输入。​
    • 名称长度为 2~64 个字符,且 UTF-8 编码后总长度不能超过 64 字节;支持中文、英文字母、数字、下划线(_)和中划线(-)。应用创建成功后不可修改。​
    • 应用的名称在 ArkClaw 企业版空间下“唯一”,不可重复,且 Agent 应用与 MCP 应用也不能重名。​
    应用描述​
    MCP 应用的描述信息。​
    • 会用于 Claw 实例上下文输入,描述内容直接影响 Claw 实例调用应用的实现效果,长度在 1~4000 字符。​
    • 需包含应用的主要能力介绍、适用/不适用场景说明,描述中可以给出典型调用示例以供员工调用时参考。​
    • 描述示例:​
    • 一个提供网页内容抓取功能的模型上下文协议服务器。支持大型语言模型能够从网页中检索和处理内容,并将 HTML 转换为 Markdown 以便更容易地使用。​
    来源​
    选择应用来源,此处选择 AgentKit ,表明应用来源于 AgentKit 中的 MCP 服务。​
    访问权限​
    设置应用可访问范围。​
    • 全量开放:应用对全部可见、可使用,允许所有人使用此应用。​
    • 受控访问:对指定的部门、用户组或用户开放此应用,仅有权限的员工可见、可使用。​
    说明​
    当生效范围为「全员、部门、用户组」时,后续新增成员会自动继承该权限规则。​
    • 全量禁止:应用对所有人均不可见,不允许任何人使用此应用。​
    可访问范围​
    仅访问权限为 “受控访问” 时需配置此参数。单击“添加”按钮,添加可访问此 MCP 应用的部门/用户组/指定用户。​
    所属项目​
    选择应用所属项目,更多信息请参见项目管理 。​
    MCP​
    选择注册使用的 MCP 服务或 MCP。​
    应用地址​
    MCP 应用的地址。​
    • 地址类型:​
    • 应用来源为“AgentKit”时,下拉选择 MCP 应用的来源地址。​
    • 应用来源为“自定义”时,手动输入 MCP 应用的来源地址。​
    • 网络要求:​
    • 如果应用的可访问地址仅支持“公网”访问,请确保当前 ArkClaw 空间下的“网络配置”中已开启公网出口。​
    • 如果应用的可访问地址仅支持“私网”访问,请确保当前 ArkClaw 空间下的“网络配置”中已开启私网出口,并配置可访问的私网出口信息。具体操作可参见本文网络配置说明。​
    • 如果应用的可访问地址同时支持“公网”访问和“私网”访问,请根据实际情况配置公网出口/私网出口,确保 ArkClaw 空间可成功访问该地址。​
    ​
    ​
    ​
  1. 单击“确定”按钮,完成配置。​
说明​
MCP 应用注册成功后,系统会定期同步 Tool 列表,您可在 MCP 详情页中查看;来源为 AgentKit,或来源为自定义且认证方式为 OAuth JWT 用户委托类型的 MCP ,暂不支持自动获取 Tool 。​
​​​
网络配置说明​
注意​
当前网络配置部分存在新、旧版本差异,此处仅介绍新版界面操。新、旧版本的介绍和操作详见公网出口、私网出口。​
配置公网出口​
开通 ArkClaw 空间时,网络配置未配置指定网段场景下,空间开通后默认开启公网出口。请您再次检查确认,如果未开启公网出口,您可按照如下操作开启公网出口。​
  1. 在左侧导航树中,选择“资源配置 > 网络配置”。 ​
  1. 单击“空间访问出口”页签,选择“公网出口”页签,单击配置信息后的“编辑”图标。​
  • ​​​
  1. 打开公网出口开关,单击“确定”按钮完成操作。​
  • ​​​
配置私网出口​
私网出口配置完成后如需修改 VPC 和子网,请先关闭私网出口再重新开启。开通 ArkClaw 空间时,网络配置使用指定网段场景下,企业服务所属 VPC 已通过中转路由器(TR)或云企业网(CEN)与 ArkClaw 所属 VPC 连通,不支持启用私网出口。​
步骤一:开启私网出口开关​
  1. 在左侧导航树中,选择“资源配置 > 网络配置”。 ​
  1. 单击“空间访问出口”页签,选择“私网出口”页签,单击配置信息后的“编辑”按钮。​
  • ​​​
  1. 在私网出口页面,参考下表配置私网信息,确保 ArkClaw 可通过私网访问注册应用的地址,配置完成后单击“确定”按钮,完成操作。 ​
  • ​
    配置项 ​
    说明 ​
    私网出口开关​
    打开私网出口开关。开启私网出口后,ArkClaw 空间与企业应用之间通过私有网络互通。​
    基本信息​
    ​
    所属项目​
    当前空间所属项目,不支持修改。​
    VPC ​
    选择应用的可访问地址所在私有网络。​
    可用区及子网 ​
    选择私网出口所属的 2 个可用区及子网。​
    • 子网用于为私网出口分配私网IP地址。​
    • 私网出口将占用每个子网中的 6 个私网IP地址,以保障访问性能。​
    安全组 ​
    选择私网出口关联的安全组,最多可同时配置 4 个安全组。​
    • 仅安全组中的出向规则对私网出口生效。​
    • 私网出口分别部署在两个可用区时,两个可用区共用指定的安全组配置。​
    指定访问目标​
    ​
    指定访问目标 IP 段范围 ​
    输入应用的可访问地址所在地址或地址段。​
    • 输入的地址或地址段不能属于以下范围:100.64.0.0/10、224.0.0.0/4、127.0.0.0/8、0.0.0.0/0、240.0.0.0/4、192.18.0.0/15、33.0.0.0/8、66.0.0.0/8、9.0.0.0/8、169.254.0.0/16。​
    • 单次最多可输入 50 个,多个地址/地址段之间使用英文逗号(,)分隔。​
    应用私网访问​
    ​
    应用私网访问开关​
    用于控制 ArkClaw 空间是否通过私网,访问在应用中心注册的 Agent 应用/MCP 应用的私网地址。​
    • 开启:ArkClaw 空间可以通过私网访问应用中心中填写的私网地址(例如私有域名或私网 IP)。​
    • 关闭:ArkClaw 空间不会通过私网访问应用中心中填写的私网地址,如果应用仅提供私网地址,可能导致访问失败。​
    说明​
    • 此功能上线后,新创建的空间可立即使用此开关,已创建的空间需后台升级后生效(预计 2026 年 7 月底完成)。​
    • 升级完成前,应用中心来源为“自定义”的企业 Agent/企业 MCP的私网地址暂不可访问;来源为“AgentKit”和“共享 Claw”的企业 Agent/企业 MCP不受影响。​
    ​
步骤二:配置私网出口域名解析​
  1. 在私网出口页签下“配置信息”区域,单击“域名解析配置”后的编辑图标。​
  • ​​​
  1. 参考下表配置私网信息,配置完成后单击“确定”按钮,完成操作。 ​
  • ​
    配置项 ​
    说明 ​
    域名解析配置开关​
    是否开启域名解析配置。​
    注意​
    AgentKit Runtime 和 MCP 使用私网域名时,如果可确保它们与 ArkClaw 空间部署在同一地域(如均位于华东 2(上海))。在该场景下,无需额外配置域名解析,火山引擎公共 DNS 服务器默认支持解析。​
    • 关闭配置:​
    • ArkClaw 会将空间内的 DNS 查询请求默认转发至火山引擎的公共 DNS 服务器(100.96.0.2 和 100.96.0.3)。​
    • 适用场景:​
    • 无需解析:您的应用地址直接填写的是 IP 地址(例如http://192.168.1.100),无需进行域名解析。​
    • 公网/常规域名:您的应用地址使用的是公网可解析的常规域名,火山引擎默认DNS服务器即可直接解析其对应的真实IP。​
    • 开启配置:​
    • 开启后,您需要手动指定用于解析当前私网应用地址的内部 DNS 服务器 IP。ArkClaw 将仅向您指定的服务器发送 DNS 查询请求。​
    • 适用场景:​
    • 使用企业服务 VPC 内部私有域名:您的应用地址使用的是仅在当前 VPC 网络内部生效的私有域名(例如http://my-agent.internal.local)。由于火山引擎默认的 DNS 服务器无法解析该内部域名,您必须开启此配置,并填入您在 VPC 中自建的、能够解析该私有域名的内部 DNS 服务器 IP 地址,否则将导致应用访问失败。ArkClaw 将空间内的 DNS 查询请求转发至火山引擎 DNS 服务器(100.96.0.2和100.96.0.3)。​
    外部 DNS 系统的 IP 地址和端口 ​
    指定外部 DNS 服务器地址、端口。​
    • 目前仅支持 IPv4 地址,最多支持配置 10 个 DNS 外部服务器地址。​
    • DNS 服务器地址不允许配置为系统预留地址100.96.0.2和100.96.0.3。​
    • 端口为非必填,不填时默认为 53。​
    转发域名 ​
    开启域名解析配置开关后需配置此参数,指定需要通过外部 DNS 服务器解析的域名,此处输入应用的可访问地址或包含可访问地址的泛域名,按回车键确认。​
    • 支持批量粘贴多个转发域名,各域名之间使用英文逗号(,)分隔。​
    • 最多支持添加 500 个转发域名。​
    注意​
    如已开启公网访问跨境加速,建议转发域名与公网加速域名不相同。如存在转发域名与公网加速域名相同时,该域名的请求将优先走公网加速通道。​
    ​
  • ​
​
最近更新时间:2026.09.08 17:39:44
这个页面对您有帮助吗?
有用
有用
无用
无用