操作场景
凭据管理用于集中管理企业内模型与 MCP 工具调用所需的敏感密钥，避免真实密钥暴露给 Agent，降低凭据泄露风险。ClawPro 平台网关会生成临时凭据，真实凭据加密存储在 ClawPro 凭据管理数据库，平台网关在 Agent 调用模型或 MCP 时自动完成临时凭据替换与鉴权，真实密钥全程不暴露。
在凭据管理页面创建完成的凭据，可以在模型配置与创建 MCP 页面直接选择，无需再重复手动填写密钥。当需要更换密钥或回收访问权限时，管理员在凭据管理中一处修改即可同步生效至所有关联对象。
注意事项
本模块仅管理企业内统一托管的模型与 MCP 调用凭据，不支持管理用户端 Agent 自带的 API Key（用户端 Agent 的 Key 由各 Agent 自行配置）。
一个模型或 MCP 在同一时刻仅能绑定一个凭据，一个凭据可同时关联多个模型或 MCP。
凭据删除后无法恢复，不提供回收站或历史快照功能。
前提条件
已使用管理员账号登录 ClawPro 管控端。
若需创建凭据，请提前确认目标服务所属协议及对应的密钥格式。
操作步骤
创建凭据
1. 登录 ClawPro 管控端，在左侧导航栏选择安全审计 > 凭据管理，进入凭据管理页面后，
页面展示凭据列表，包含凭据名称、关联 MCP、关联模型信息。您可使用顶部搜索框按凭据名称或 ID 检索。如下图所示：
2. 单击页面右上角的创建凭据，打开创建凭据弹窗。如下图所示：
填写以下参数：
凭据名称：凭据在列表中的显示名称。
凭据信息：根据凭据注入位置不同，您可按需选择 Header 或 Query 。
添加密钥类型 | 协议 | Header Key | 密钥值格式 | 示例 |
添加为 Header 参数 | OpenAI 协议 | authorization | Bearer + 空格 + API Key，注意增加 Bearer 前缀。最长256个字符。 | Bearer sk-xxxxxx |
添加为 Query 参数 | Anthropic 协议 | x-api-key | 直接填写 API Key，最长256个字符。 | sk-xxxxxx |
注意：
Header 填写错误将导致调用失败，系统报错 CredentialInvalid。请检查 Header 的 key 与 value 是否与 MCP 服务要求一致。
如需添加多组密钥，请单击添加密钥。
3. 填写完成后单击创建，保存凭据。
说明：
填写错误将导致模型或 MCP 无法正常调用，请严格按照规范填写，例如 OpenAI 协议的模型密钥值必须带 Bearer 前缀。
关联模型或 MCP
1. 在目标凭据所在行单击更多，选择关联模型或关联 MCP。如下图所示：
2. 在弹窗中搜索并勾选目标，单击确认关联，页面提示已关联的模型或 MCP 数量。
说明：
如目标已关联其他凭据，按提示确认是否替换。替换前请确保新凭据符合目标服务的鉴权要求，以免影响后续调用。
在 Agent 配置 > 模型配置中也可以为模型选择已有凭据。如需为自定义模型选择凭据，应在模型配置中操作。
配置 MCP 凭据托管
ClawPro 支持为远程 MCP 服务开启凭据托管，管理员可根据实际需要选择以下配置方式：
填写真实凭据：可选择已有凭据或手动填写
保留占位符：管理员不填写真实凭据，由用户端在添加 MCP 时根据填写参数提示自行填写。
开启凭据托管后，用户端的查看源码入口不可用。
管理已有凭据
企业管理员可在凭据管理页面，对已创建的凭据进行以下操作：
编辑凭据：在目标凭据所在行单击编辑，修改凭据名称或密钥信息后单击保存。若凭据已关联模型或 MCP，修改密钥可能影响关联服务的后续调用，请确保新密钥有效。
启用或停用凭据：在启用状态列切换开关。已关联模型或 MCP 的凭据不支持停用。
删除凭据：仅支持删除未关联任何模型或 MCP 的凭据，且删除后不可恢复
注意：
凭据修改后立即生效，当前已关联该凭据的服务在下一次调用时会重新鉴权，如果密钥非真实有效，将导致线上业务调用不成功，请谨慎操作。
仅当凭据未被任何模型或 MCP 关联时，更多菜单中的删除项才可单击。
删除凭据会将其从平台移除，请确认该凭据不再被任何 MCP 服务或模型使用后再执行删除操作。
