SuperAPI AI 工具集

clay-debug-bundle

测试与质量

查看项目

更新于 10-15 22:42

技能介绍

用途:在遇到持续性问题、准备提交 Clay 支持工单或需要收集诊断材料时,打包生成一份可用于排查的 Clay 诊断归档。Clay 是 Web 平台,因此调试聚焦于 webhook 送达、富化列错误、HTTP API 响应和额度消耗,而非 pod 或集群。

主要能力:通过 shell 脚本自动化收集 webhook 连通性(HTTP 状态码)、环境与配置(Node、Python、OS、密钥是否设置、.env 脱敏)、Enterprise API 连通性、应用日志中的 Clay/webhook/enrich 错误,并附一份需从 Clay UI 手动填写的表格诊断清单(表名、行数、富化列、自动运行、错误单元格、额度余额、套餐层级、错误详情与最近变更)。最终打包为 tar.gz 归档。

使用方式:脚本需设置 CLAY_WEBHOOK_URL 和 CLAY_API_KEY 环境变量,使用 curl 测试连通性,依赖 node、python3 与本地日志文件。仓库提供 clay-debug-bundle.sh 示例,包含创建目录、测试 webhook、采集环境、测试 Enterprise API、抓取日志、手动填表、打包等步骤。归档可在 https://community.clay.com 或 support@clay.com 提交。

限制:表格诊断必须从 Clay UI 手动填写;脚本为示例性质,日志路径等需按实际环境调整;提交前必须人工复核是否含敏感数据。始终脱敏 API 密钥与令牌、邮箱与姓名、第三方提供商密钥(Apollo、Clearbit 等)及 CRM 凭据;可安全包含错误消息、HTTP 状态码、列名与表结构、额度用量、软件版本。若发现敏感数据,应隔离归档、修正采集过滤条件并重新生成,而非手工编辑归档。具体官方价格、套餐与效果暂未提供。