文档中心

ArkClaw 企业版

最佳实践

应用中心资源注册与使用最佳实践

应用中心是ArkClaw企业版统一管理Agent与MCP资源的入口。管理员完成资源注册后，空间内的个人Claw可直接发现并调用这些资源，无需在每个Claw中重复安装或逐个配置。

本文为您介绍如何在应用中心中对企业内的AI应用资源（Agent、MCP等）进行统一注册、管理和发布。

资源类型

应用中心支持注册以下几种类型的AI应用资产。

说明

AgentKit是火山引擎为AI Agent构建、部署、运行提供支持的开发工具平台，帮助开发者和企业降低Agent开发门槛，为Agent提供模型之外的安全、内置工具、记忆、知识、监控、评测等基础设施，助力企业高效构建、部署、运维复杂智能的企业级Agent。了解更多

资产类型			资产来源
注册Agent	AgentKit Agent	注册在AgentKit中的A2A Agent服务。了解更多
		共享 Claw	火山引擎共享Claw，将一个Claw作为Agent资源，供其他个人Claw调用。了解更多
		自定义 Agent	用户自行开发、支持A2A通信协议且可公网访问的 Agent。
注册MCP	AgentKit MCP	AgentKit中的MCP服务。了解更多
注册MCP		自定义 MCP	用户自行部署、支持公网访问的MCP服务。

前提条件

请确认已完成ArkClaw开通、席位购买等操作，具体操作请参见空间开通快速入门。

注册资源

注册Agent

企业管理员可以将符合A2A协议的智能体（Agent）注册到ArkClaw企业版应用中心，使其能被ArkClaw企业版空间内员工的ArkClaw实例发现和调用。

说明

如需注册来源为AgentKit的应用，请确保您的火山引擎账号已经注册A2A智能体。

如需注册来源为自定义的应用，需提前准备可访问的服务地址、认证方式以及必要的描述信息。

AgentKit Agent

共享Claw

自定义Agent

适用于已经在AgentKit智能体运行时中完成构建的智能体。该方式的优势是接入成本低，通常无需额外填写复杂鉴权参数。

说明

如果需要通过自有镜像部署Agent，请参考已有部署指引再完成注册。

操作步骤

登录ArkClaw企业版控制台。

在左侧导航树中，选择“能力中心 > 应用中心”。

在“企业Agent”页签下，单击“注册Agent”按钮。

参考下表，配置Agent信息。

参数	说明
名称	Agent应用的名称，即ArkClaw调用应用时展示的名称。
唯一标识	Agent应用的唯一标识，用于区别其他应用。说明应用的唯一标识在空间下“唯一”，用于ArkClaw的上下文输入，应用创建成功后不可修改，会直接影响后续资源检索与选择体验，建议尽可能清晰具体。
应用描述	Agent应用的描述信息。会用于ArkClaw的上下文输入，描述内容直接影响ArkClaw调用应用的实现效果，建议尽可能清晰具体。需包含应用的主要能力介绍、适用/不适用场景说明，描述中可以给出典型调用示例以供员工调用时参考。描述示例：面向企业研究和情报分析场景的互联网搜索Agent，负责根据自然语言查询自动检索多源网页信息并整理要点。适用于需要快速了解行业趋势、竞品动态、技术方案等信息的场景。典型用法包括：“搜索最近三年 AIGC 在广告行业的应用案例并按场景分类”，“帮我整理几篇关于多智能体协同架构的权威文章”。
来源	选择应用来源为AgentKit。
访问权限	设置应用可访问范围。全量开放：应用对全部可见、可使用，允许所有员工使用此应用。受控访问：对指定的部门、用户组或用户开放此应用，仅有权限的员工可见、可使用。说明当生效范围为「全员、部门、用户组」时，后续新增成员会自动继承该权限规则。全量禁止：应用对所有员工均不可见，不允许任何员工使用此应用。
所属项目	选择应用所属项目，更多信息请参见项目管理。
智能体运行时	选择用于创建Agent应用的智能体运行时。注意仅可选择当前火山引擎账号权限范围内、状态为“可用”、入站认证为“API Key”或“OAuth”类型且支持A2A协议的智能体运行时。
应用地址	选择用于创建Agent应用的智能体运行时的可访问地址。如果应用的可访问地址仅支持“公网”访问，请确保当前ArkClaw下的“网络配置”中已开启公网出口。如果应用的可访问地址仅支持“私网”访问，请确保当前ArkClaw下的“网络配置”中已开启私网出口，并配置可访问的私网出口信息。具体操作可参见本文网络配置说明。如果应用的可访问地址同时支持“公网”访问和“私网”访问，请根据实际情况配置公网出口/私网出口，确保ArkClaw可访问即可。

单击“确定”按钮，完成配置。

适用于将一个已有 Claw 以 A2A Agent 形式共享给其他个人 Claw 使用的场景。

操作步骤

登录ArkClaw企业版控制台。

在左侧导航树中，选择“能力中心 > 应用中心”。

在“企业Agent”页签下，单击“注册Agent”按钮。

参考下表，配置Agent信息。

参数	说明
名称	Agent应用的名称，即ArkClaw调用应用时展示的名称。
唯一标识	Agent应用的唯一标识，用于区别其他应用。说明应用的唯一标识在空间下“唯一”，用于ArkClaw的上下文输入，应用创建成功后不可修改，会直接影响后续资源检索与选择体验，建议尽可能清晰具体。
应用描述	Agent应用的描述信息。会用于ArkClaw的上下文输入，描述内容直接影响ArkClaw调用应用的实现效果，建议尽可能清晰具体。需包含应用的主要能力介绍、适用/不适用场景说明，描述中可以给出典型调用示例以供员工调用时参考。描述示例：面向企业研究和情报分析场景的互联网搜索Agent，负责根据自然语言查询自动检索多源网页信息并整理要点。适用于需要快速了解行业趋势、竞品动态、技术方案等信息的场景。典型用法包括：“搜索最近三年 AIGC 在广告行业的应用案例并按场景分类”，“帮我整理几篇关于多智能体协同架构的权威文章”。
来源	选择应用来源为共享 Claw。
访问权限	设置应用可访问范围。全量开放：应用对全部可见、可使用，允许所有员工使用此应用。受控访问：对指定的部门、用户组或用户开放此应用，仅有权限的员工可见、可使用。说明当生效范围为「全员、部门、用户组」时，后续新增成员会自动继承该权限规则。全量禁止：应用对所有员工均不可见，不允许任何员工使用此应用。说明对于“共享Claw”来源的Agent，共享Claw的管理员默认有权限使用此应用，即使设置为全量禁止，共享Claw管理员仍可在员工端查看、管理与访问此Agent。
模版	选择用于创建共享Claw的模版，当前仅支持“ArkClaw答疑助手”和“通用知识问答助手”两种模版。共享Claw与员工Claw的差异？规格配置：选择用于创建共享Claw的席位规格。说明共享Claw为空间维度的ArkClaw实例，使用共享Claw的方式注册Agent应用，会基于所选的模版创建一个共享Claw实例，该实例会占用当前空间下1个对应规格的席位配额。可在ArkClaw控制台“Claw列表”的“实例列表 > 共享Claw”下查看当前ArkClaw空间下已创建的共享Claw。其他配置：可分别单击“职业人设”、“平台规范”、“内置插件”、“内置技能”页签，分别查看模版的对应信息。您可以参考共享Claw模版定义最佳实践修改模版信息以匹配自身业务需求。 ArkClaw答疑助手：火山引擎售后专家，预置一个能调用公共 VikingDB 知识库（持续由火山技术服务支持团队更新维护）的Skill，深度集成Arkclaw产品相关专业知识，负责处理客户Arkclaw使用过程中的问题答疑。通用知识问答助手：面向多行业答疑场景通用的知识问答专家，知识来源统一为OpenViking知识库。用户可自行修改Agent配置文件、维护特定行业与领域的知识数据。
管理员	添加可管理共享Claw的企业员工，作为共享Claw的管理员。共享Claw的管理员的企业员工：可管理共享Claw实例及内部Agent，管理知识导入、使用共享Claw。非共享Claw的管理员的企业员工：经授权后可使用共享Claw。说明无法搜索到目标员工，可能是因为该员工信息缺失，请前往“用户管理”检查该员工信息并补充，具体操作请参见更新用户信息。

单击“确定”按钮，完成配置。

适用于接入外部自研Agent服务。该方式灵活度最高，但对协议兼容性和网络可达性有明确要求。

接入要求

Agent服务需支持 A2A 通信协议。

Agent服务需可通过公网访问。

操作步骤

登录ArkClaw企业版控制台。

在左侧导航树中，选择“能力中心 > 应用中心”。

在“企业Agent”页签下，单击“注册Agent”按钮。

参考下表，配置Agent信息。

参数	说明
名称	Agent应用的名称，即ArkClaw调用应用时展示的名称。
唯一标识	Agent应用的唯一标识，用于区别其他应用。说明应用的唯一标识在空间下“唯一”，用于ArkClaw的上下文输入，应用创建成功后不可修改，会直接影响后续资源检索与选择体验，建议尽可能清晰具体。
应用描述	Agent应用的描述信息。会用于ArkClaw的上下文输入，描述内容直接影响ArkClaw调用应用的实现效果，建议尽可能清晰具体。需包含应用的主要能力介绍、适用/不适用场景说明，描述中可以给出典型调用示例以供员工调用时参考。描述示例：面向企业研究和情报分析场景的互联网搜索Agent，负责根据自然语言查询自动检索多源网页信息并整理要点。适用于需要快速了解行业趋势、竞品动态、技术方案等信息的场景。典型用法包括：“搜索最近三年 AIGC 在广告行业的应用案例并按场景分类”，“帮我整理几篇关于多智能体协同架构的权威文章”。
来源	选择应用来源为自定义。
访问权限	设置应用可访问范围。全量开放：应用对全部可见、可使用，允许所有员工使用此应用。受控访问：对指定的部门、用户组或用户开放此应用，仅有权限的员工可见、可使用。说明当生效范围为「全员、部门、用户组」时，后续新增成员会自动继承该权限规则。全量禁止：应用对所有员工均不可见，不允许任何员工使用此应用。
访问认证	选择Agent应用的访问方式。无需认证：默认使用此方式，不需要进行访问认证。 API Key：请在下拉框中选择目标API Key。 OAuth JWT：请在下拉框中选择目标凭证。说明 Agent的访问认证方式以访问认证配置为准，AgentCard内JSON文件中的security字段不会被系统读取，即使已配置也不会生效。单击下拉框中的“添加凭证”按钮可添加新的凭证，具体操作请参见凭据管理。
导入方式	选择Agent应用的导入方式，支持JSON和AgentCard地址两种导入形式，认证类型支持API Key和OAuth JWT类型。导入方式： JSON：直接粘贴JSON文件，可在线修改文件内容。 AgentCard：AgentCard是A2A智能体在所属空间的标准化信息载体，包含ID、名称、协议版本、通信模式等核心属性，关联所属A2A智能体空间。此方式需输入AgentCard地址，单击“解析”按钮手动解析内容，可在线修改文件内容。导入要求：格式要求：JSON文件各字段的具体定义、取值范围及校验规则等规范要求，参见A2A协议官网文档；JSON文件示例参见A2A智能体JSON文件示例。网络要求：直接粘贴的JSON文件或根据AgentCard地址解析出的JSON文件中的“url”，即为应用的可访问地址，请根据可访问地址的访问方式，配置对应的网络出口。如果可访问地址仅支持“公网”访问，请确保当前ArkClaw下的“网络配置”中已开启公网出口。如果可访问地址仅支持“私网”访问，请确保当前ArkClaw下的“网络配置”中已开启私网出口，并配置可访问的私网出口信息。具体操作可参见本文网络配置说明。如果可访问地址同时支持“公网”访问和“私网”访问，请根据实际情况配置公网出口/私网出口，确保ArkClaw可访问即可。

单击“确定”按钮，完成配置。

注册MCP

企业管理员可以将企业内部的MCP（Model Context Protocol）服务或工具集注册到应用中心，使其能被ArkClaw企业版空间内员工的ArkClaw实例发现和调用。

说明

如需注册来源为AgentKit的应用，请确保您的火山引擎账号已经创建MCP服务。

如需注册来源为自定义的应用，需提前准备可访问的服务地址、认证方式以及必要的描述信息。

AgentKit MCP

自定义MCP

适用于已在AgentKit网关中创建的 MCP 服务。

操作步骤

登录ArkClaw企业版控制台。

在左侧导航树中，选择“能力中心 > 应用中心”。

在“企业Agent”页签下，单击“注册MCP”按钮。

参考下表，配置MCP信息。

参数	说明
名称	MCP应用的名称，即ArkClaw调用应用时展示的名称。
唯一标识	MCP应用的唯一标识，用于区别其他应用。说明应用的唯一标识在空间下“唯一”，用于ArkClaw的上下文输入，应用创建成功后不可修改，会直接影响后续资源检索与选择体验，建议尽可能清晰具体。
应用描述	MCP应用的描述信息。会用于ArkClaw的上下文输入，描述内容直接影响ArkClaw调用应用的实现效果，建议尽可能清晰具体。需包含应用的主要能力介绍、适用/不适用场景说明，描述中可以给出典型调用示例以供员工调用时参考。描述示例：一个提供网页内容抓取功能的模型上下文协议服务器。支持大型语言模型能够从网页中检索和处理内容，并将HTML转换为Markdown以便更容易地使用。
来源	选择应用来源为“AgentKit”。
访问权限	设置应用可访问范围。全量开放：应用对全部可见、可使用，允许所有员工使用此应用。受控访问：对指定的部门、用户组或用户开放此应用，仅有权限的员工可见、可使用。说明当生效范围为「全员、部门、用户组」时，后续新增成员会自动继承该权限规则。全量禁止：应用对所有员工均不可见，不允许任何员工使用此应用。
所属项目	选择应用所属项目，更多信息请参见项目管理。
MCP	选择注册使用的MCP服务或MCP。
应用地址	MCP应用的地址。地址类型：应用来源为“AgentKit”时，下拉选择MCP应用的来源地址。应用来源为“自定义”时，手动输入MCP应用的来源地址。网络要求：如果应用的可访问地址仅支持“公网”访问，请确保当前ArkClaw下的“网络配置”中已开启公网出口。如果应用的可访问地址仅支持“私网”访问，请确保当前ArkClaw下的“网络配置”中已开启私网出口，并配置可访问的私网出口信息。具体操作可参见本文网络配置说明。如果应用的可访问地址同时支持“公网”访问和“私网”访问，请根据实际情况配置公网出口/私网出口，确保ArkClaw可成功访问该地址即可。

单击“确定”按钮，完成配置。

适用于接入企业自建或第三方托管的 MCP 服务。

操作步骤

登录ArkClaw企业版控制台。

在左侧导航树中，选择“能力中心 > 应用中心”。

在“企业Agent”页签下，单击“注册MCP”按钮。

参考下表，配置MCP信息。

参数	说明
名称	MCP应用的名称，即ArkClaw调用应用时展示的名称。
唯一标识	MCP应用的唯一标识，用于区别其他应用。说明应用的唯一标识在空间下“唯一”，用于ArkClaw的上下文输入，应用创建成功后不可修改，会直接影响后续资源检索与选择体验，建议尽可能清晰具体。
应用描述	MCP应用的描述信息。会用于ArkClaw的上下文输入，描述内容直接影响ArkClaw调用应用的实现效果，建议尽可能清晰具体。需包含应用的主要能力介绍、适用/不适用场景说明，描述中可以给出典型调用示例以供员工调用时参考。描述示例：一个提供网页内容抓取功能的模型上下文协议服务器。支持大型语言模型能够从网页中检索和处理内容，并将HTML转换为Markdown以便更容易地使用。
来源	选择应用来源为“自定义”。
访问权限	设置应用可访问范围。全量开放：应用对全部可见、可使用，允许所有员工使用此应用。受控访问：对指定的部门、用户组或用户开放此应用，仅有权限的员工可见、可使用。说明当生效范围为「全员、部门、用户组」时，后续新增成员会自动继承该权限规则。全量禁止：应用对所有员工均不可见，不允许任何员工使用此应用。
协议支持	当前仅支持Streamable HTTP协议。
应用地址	MCP应用的地址。地址类型：应用来源为“AgentKit”时，下拉选择MCP应用的来源地址。应用来源为“自定义”时，手动输入MCP应用的来源地址。网络要求：如果应用的可访问地址仅支持“公网”访问，请确保当前ArkClaw下的“网络配置”中已开启公网出口。如果应用的可访问地址仅支持“私网”访问，请确保当前ArkClaw下的“网络配置”中已开启私网出口，并配置可访问的私网出口信息。具体操作可参见本文网络配置说明。如果应用的可访问地址同时支持“公网”访问和“私网”访问，请根据实际情况配置公网出口/私网出口，确保ArkClaw可成功访问该地址即可。
访问认证	选择应用的访问方式。无需认证：默认使用此方式，不需要进行访问认证。 API Key：请在下拉框中选择目标API Key。 OAuth JWT：请在下拉框中选择目标凭证。说明单击下拉框中的“添加凭证”按钮可添加新的凭证，具体操作请参见凭据管理。

单击“确定”按钮，完成配置。

资源使用说明

完成注册后，资源将进入企业版统一资源池，可在ArkClaw用户端通过自然语言或快捷命令进行调用。

说明

企业用户使用资源前，需已在用户端申请ArkClaw实例并发起任务。

企业员工可见的企业应用由企业管理员定制化配置，即企业管理员在注册Agent和注册MCP时配置的“访问权限”。

Agent使用方式

Agent注册成功后，企业用户可通过以下两种方式调用，详情请参见使用企业应用。

自然语言调用

@ 命令调用

在对话中直接描述任务，由ArkClaw自动选择或调用相关Agent。

MCP 使用方式

MCP 资源注册成功后，用户可通过以下两种方式调用，详情请参见使用企业应用。

自然语言调用

/ 命令调用

在对话中直接描述任务，由ArkClaw自动选择或调用相关Agent。

插件安装与更新

ArkClaw企业版中，Agent与MCP的通信能力，以及对新注册资源的发现能力，通常依赖符合OpenClaw标准的插件，建议您安装最新插件以使用完整的功能。

自动安装

手动安装

默认情况下，插件会随 ArkClaw 一并安装。

若首次使用@或/时出现弹窗提示，请按界面指引完成插件开启、安装或更新。

插件安装完成后，关闭终端窗口，再回到对话界面继续使用资源。

附录

自有镜像如何部署Agent？

推送镜像。

在本地环境中安装docker命令。

进入火山镜像仓库。

单击目标实例卡片的“进入实例”按钮。如果没有实例，请创建标准实例。

在概览中，记录访问域名。

在左侧导航树中选择“命名空间”，记录已创建的命名空间名称。如果没有命名空间，请创建命名空间。

在左侧导航树中选择“概览”，单击“获取临时访问指令”按钮，在弹出的窗口中单击“复制”图标，复制生成的登录命令。

打开终端，输入已复制的登录命令。

输入推送镜像的命令（本例中推送的镜像名称为openclaw-a2a和fin-a-share-mcp），请替换命令中标黄内容。

IMG_DM=xxxx-cn-beijing.cr.volces.com #请替换为镜像实例的访问域名
IMG_NS=superagent #请替换为镜像实例的命名空间
for i in openclaw-a2a:0428-2 fin-a-share-mcp:f8a0d40; do # 本例中推送的镜像名称为openclaw-a2a和fin-a-share-mcp
docker pull agentkit-platform-2107625663-cn-beijing.cr.volces.com/agentkit/$i
docker tag agentkit-platform-2107625663-cn-beijing.cr.volces.com/agentkit/$i $IMG_DM/$IMG_NS/$i
docker push $IMG_DM/$IMG_NS/$i
done

部署MCP服务和Claw服务。

登录AgentKit智能体运行时控制台。

单击“创建智能体”按钮。下表仅介绍和本例相关的参数，其他的参数介绍请参见创建运行时（控制台）。

参数
说明
镜像
需选择“自定义镜像 > 从镜像仓库选择”，选择刚才适用的镜像仓库实例、命名空间、及已推送的镜像fin-a-share-mcp。

单击“创建”按钮，等待发布完成，即mcp server部署完成。

单击该智能体名称，记录顶部的”快速调用“信息中的公网域名和API Key。

再次单击“创建智能体”按钮。下表仅介绍和本例相关的参数，其他的参数介绍请参见创建运行时（控制台）。

参数	说明
镜像	需选择“自定义镜像 > 从镜像仓库选择”，选择刚才适用的镜像仓库实例、命名空间、及已推送的镜像openclaw-a2a。
环境变量	选择“使用JSON格式编辑”，请替换命令中标黄内容。 { "MCP_URL": "https://xxxxx.com/mcp/", # 请替换为已创建的智能体的公网域名/mcp/，注意需要在公网域名后补充/mcp/) "MCP_APIKEY": "xxxx", # 请替换为已创建的智能体的API Key "MODEL_API_KEY": "xxxx", # 请替换为大模型的API KEY，请参见如何获取大模型API Key "MODEL_BASE_URL": "https://ark.cn-beijing.volces.com/api/v3/", "MODEL_NAME": "doubao-seed-1-8-251228" }

单击“创建”按钮，等待发布完成，即支持A2A协议的Claw实例部署完成。

（可选）您可以执行以下命令进行调试，请替换命令中标黄内容。

curl https://请替换为已创建的智能体的公网域名/a2a/jsonrpc -Hauthorization:Bearer\ 请替换为已创建的智能体的API Key -Hcontent-type:application/json -d '{
"jsonrpc": "2.0",
"id": "unique-request-id",
"method": "message/send",
"params": {
"message": {
"parts": [{"kind": "text", "text": "你是谁"}],
"messageId": "unique-message-id", "role": "user"
}
}
}
'

最近更新时间：2026.10.14 17:03:41

这个页面对您有帮助吗？

有用

无用