📦 Pilot — 飞行员
v1.0.0API Gateway Manager Setup 部署一套带 4 个 Agent 的 API 网关管理系统。 在以下场景使用本技能: 1. 用户希望搭建具备服务发现、路由等功能的 API 网关管理。
2· 2·0 当前·0 累计
下载技能包
最后更新
2026/4/22
安全扫描
OpenClaw
安全
high confidence该技能的说明、所需二进制文件与运行时行为均符合其声明的“部署 4-agent API gateway manager”之目的,不会索取无关凭据或安装任意代码——但使用前请验证 pilotctl/clawhub 及下游技能(如 slack bridge)的来源。
评估建议
该技能与其声明的目的一致,但安装前请采取以下预防措施:
1) 确认 pilotctl 和 clawhub 是来自可信源的合法二进制文件(验证签名或厂商文档)——该技能依赖它们进行主机/信任操作。
2) 检查并审核 clawhub 将安装的所有子技能(例如 pilot-slack-bridge 可能需要 Slack token);安装大量第三方组件会扩大攻击面。
3) 理解握手/信任模型:SKILL.md 指出,当双方互发握手时即自动批准——确保仅与你控制或信任的主机交换握手,或隔离部署网络。
4) 检查 ~/.pilot 下创建的文件是否包含敏感数据,并设置严格的文件系统权限。
5) 不要在示例命令中粘贴真实的 API key 或 JWT;试用示例时使用脱敏/测试数据。
如需更高保障,请提供 pilotctl/clawhub 的位置/PKG 源以及子技能的上游仓库,以便使用前审查。...详细分析 ▾
✓ 用途与能力
名称/描述(API gateway manager with discovery, router, auth, monitor)与运行时指令及所需二进制文件一致:pilotctl 用于 host/handshake/trust 命令,clawhub 用于安装角色专属的 agent 'skills'。所有声明的依赖(pilotctl、clawhub)均在 SKILL.md 中被直接使用。
ℹ 指令范围
说明聚焦于安装角色专属技能、设置主机名、在 ~/.pilot/setups 下编写 manifest,以及在既定目的范围内发起节点间握手。操作细节提示:SKILL.md 指出,当双方同时发送握手时会自动批准;该行为可能因网络/信任模型带来安全隐患,启用跨主机通信前,请确认 pilotctl 如何实施握手与信任机制。
✓ 安装机制
此为纯指令型(无安装规范)。该 skill 依赖现有二进制文件,不会自行下载或解压代码。唯一安装操作是执行 `clawhub install`,用于安装其他 skill——这对编排类 skill 属预期行为,但风险转移至 clawhub 及其所装包。
✓ 凭证需求
该 skill 未声明必需的环境变量或凭据,说明中也不会读取机密或无关的 env var。示例载荷中的 API key/JWT 仅作演示;skill 本身不会请求或持久化机密。注意:部分子 skill(如 pilot-slack-bridge)可能需要外部 token——它们不属于本 skill,但使用前建议审计。
✓ 持久化与权限
always 为 false,模型调用正常。该 skill 会将 manifest 写入 ~/.pilot/setups(符合 setup 工具预期),但不会请求系统级配置变更,也不会修改其他 skill 的配置。
安全有层次,运行前请审查代码。
运行时依赖
无特殊依赖
版本
latestv1.0.02026/4/22
首次发布
● 无害
安装命令
点击复制官方npx clawhub@latest install pilot-api-gateway-manager-setup
镜像加速npx clawhub@latest install pilot-api-gateway-manager-setup --registry https://cn.longxiaskill.com
技能文档
部署 4 个 agent:discovery、router、auth、monitor。
角色
| 角色 | 主机名 | 技能 | 用途 | |------|--------|------|------| | discovery |-discovery | pilot-discover, pilot-health, pilot-heartbeat-monitor | 注册后端、维护服务注册表、健康检查 |
| router | -router | pilot-load-balancer, pilot-task-router, pilot-metrics | 按路径、头部及负载路由 API 请求 |
| auth | -auth | pilot-verify, pilot-audit-log, pilot-blocklist | 校验 API key/JWT,执行限流与配额 |
| monitor | -monitor | pilot-metrics, pilot-alert, pilot-slack-bridge | 跟踪延迟、错误率、吞吐量;异常告警 | 部署流程
步骤 1: 询问用户该 agent 的角色及前缀。 步骤 2: 为所选角色安装技能: ``bash
# discovery:
clawhub install pilot-discover pilot-health pilot-heartbeat-monitor
# router:
clawhub install pilot-load-balancer pilot-task-router pilot-metrics
# auth:
clawhub install pilot-verify pilot-audit-log pilot-blocklist
# monitor:
clawhub install pilot-metrics pilot-alert pilot-slack-bridge
`
步骤 3: 设置主机名:
`bash
pilotctl --json set-hostname -
`
步骤 4: 写入部署清单:
`bash
mkdir -p ~/.pilot/setups
cat > ~/.pilot/setups/api-gateway-manager.json << 'MANIFEST'
MANIFEST
`
步骤 5: 提示用户与直连对等方完成握手。 各角色清单模板
discovery
`json
{
"setup": "api-gateway-manager",
"setup_name": "API Gateway Manager",
"role": "discovery",
"role_name": "Service Discovery",
"hostname": "-discovery",
"description": "注册并发现后端微服务,维护服务注册表,执行健康检查。",
"skills": {
"pilot-discover": "注册并发现后端微服务实例。",
"pilot-health": "对已注册后端执行定期健康检查。",
"pilot-heartbeat-monitor": "通过心跳超时检测无响应后端。"
},
"peers": [
{ "role": "router", "hostname": "-router", "description": "接收服务注册表更新" },
{ "role": "monitor", "hostname": "-monitor", "description": "发送健康反馈" }
],
"data_flows": [
{ "direction": "send", "peer": "-router", "port": 1002, "topic": "service-registry", "description": "推送健康后端的服务注册表更新" },
{ "direction": "receive", "peer": "-monitor", "port": 1002, "topic": "health-feedback", "description": "接收健康反馈以注销故障后端" }
],
"handshakes_needed": ["-router", "-monitor"]
}
` router
`json
{
"setup": "api-gateway-manager",
"setup_name": "API Gateway Manager",
"role": "router",
"role_name": "Request Router",
"hostname": "-router",
"description": "根据路径、头部及负载将入站 API 请求路由至合适后端。",
"skills": {
"pilot-load-balancer": "在健康后端实例间分发请求。",
"pilot-task-router": "按请求路径与头部匹配后端服务。",
"pilot-metrics": "跟踪路由决策、请求数与后端利用率。"
},
"peers": [
{ "role": "discovery", "hostname": "-discovery", "description": "接收服务注册表更新" },
{ "role": "auth", "hostname": "-auth", "description": "接收认证请求" }
],
"data_flows": [
{ "direction": "receive", "peer": "-discovery", "port": 1002, "topic": "service-registry", "description": "接收健康后端的服务注册表更新" },
{ "direction": "send", "peer": "-auth", "port": 1002, "topic": "auth-request", "description": "对入站 API 调用发起认证请求" }
],
"handshakes_needed": ["-discovery", "-auth"]
}
` auth
``json
{
"setup": "api-gateway-manager",
"setup_name": "API Gateway Manager",
"role": "auth",
"ro