---

name: manifest description: "为你的代理安装和配置 Manifest 可观测性插件。在设置遥测、配置 API 密钥或排查插件问题时使用。" risk: unknown source: community date_added: "2026-02-27"

Manifest 设置

按照以下步骤依次执行。不要跳过任何步骤。

何时使用此技能

• 用户想要为其代理设置可观测性或遥测
• 用户想要将其代理连接到 Manifest 进行监控
• 用户需要配置 Manifest API 密钥或自定义端点
• 用户正在排查 Manifest 插件连接问题
• 用户想要验证 Manifest 插件是否正在运行

不要使用此技能的情况

• 用户需要通用的可观测性设计（请改用 observability-engineer）
• 用户想要构建自定义仪表板或告警规则
• 用户未使用 Manifest 平台

操作说明

步骤 1 — 停止网关

首先停止网关，以避免配置期间的热重载问题。

claude gateway stop

步骤 2 — 安装插件

claude plugins install manifest

如果安装失败，请检查 CLI 是否已安装并在 PATH 中可用。

步骤 3 — 获取 API 密钥

询问用户：

要连接你的代理，你需要一个 Manifest API 密钥。获取方法如下：

1. 前往 https://app.manifest.build 创建账户（或登录）
2. 登录后，点击 "Connect Agent" 创建新代理
3. 复制以 mnfst_ 开头的 API 密钥
4. 将其粘贴到此处

等待以 mnfst_ 开头的密钥。如果密钥格式不匹配，告知用户格式不正确并请其重试。

步骤 4 — 配置插件

claude config set plugins.entries.manifest.config.apiKey "USER_API_KEY"

将 USER_API_KEY 替换为用户提供的实际密钥。

询问用户是否有自定义端点。如果没有，将自动使用默认端点（https://app.manifest.build/api/v1/otlp）。如果有：

claude config set plugins.entries.manifest.config.endpoint "USER_ENDPOINT"

步骤 5 — 启动网关

claude gateway install

步骤 6 — 验证

等待 3 秒让网关完全启动，然后检查日志：

grep "manifest" ~/.claude/logs/gateway.log | tail -5

查找以下内容：

[manifest] Observability pipeline active

如果出现该信息，告知用户设置已完成。如果没有，检查错误信息并进行排查。

安全性

• 配置后切勿以明文形式记录或输出 API 密钥
• 写入配置前验证密钥格式（mnfst_ 前缀）

故障排查

| 错误 | 修复方法 | |-------|-----| | 缺少 apiKey | 重新执行步骤 4 | | apiKey 格式无效 | 密钥必须以 mnfst_ 开头 | | 连接被拒绝 | 端点不可达。检查 URL 或询问用户是否自托管 | | 重复的 OTel 注册 | 禁用冲突的内置插件：claude plugins disable diagnostics-otel |

示例

示例 1：基本设置

Use @manifest to set up observability for my agent.

示例 2：自定义端点

Use @manifest to connect my agent to my self-hosted Manifest instance at https://manifest.internal.company.com/api/v1/otlp

最佳实践

• 在进行配置更改之前始终停止网关
• 默认端点适用于大多数用户 — 仅在自托管时更改
• API 密钥始终以 mnfst_ 开头 — 任何其他格式均无效
• 调试任何插件问题时首先检查网关日志

限制

• 仅在任务明确匹配上述范围时使用此技能。
• 不要将输出视为特定环境验证、测试或专家审查的替代品。
• 如果缺少必需的输入、权限、安全边界或成功标准，请停下来并要求澄清。