功能概述
Fieldy 是一个 webhook 集成配置工具，用于将 Fieldy 语音应用的转录数据接入 Moltbot Gateway 系统。核心功能是通过 fieldy-webhook.js 转换模块实现唤醒词检测——当转录文本包含"Hey, Fieldy"或"Fieldy"时，提取唤醒词后的内容触发智能体运行；无唤醒词的转录仅被记录日志。
核心用法
1. 部署转换脚本：将 src/fieldy-webhook.js 复制到 hooks.transformsDir 指定目录
2. 配置网关映射：在 ~/.clawdbot/moltbot.json 中添加 webhook 映射，设置路径匹配、token 验证、消息模板等参数
3. 重启网关服务：使配置生效
4. 设置 Fieldy 端点：在 Fieldy 应用的 Developer Settings 中配置 webhook URL 及 token
5. 测试验证：使用 curl 发送含唤醒词的 JSON 载荷测试连通性
显著优点
- 零代码侵入：纯配置型 Skill，无需修改 Moltbot 核心代码
- 唤醒词可控：支持自定义唤醒词和解析逻辑，适应不同语音交互场景
- 安全传输：支持 header Bearer token 和 query param 两种鉴权方式
- 消息模板灵活：使用 Handlebars 风格模板（
{{message}}）定制传入智能体的消息格式
潜在局限
- T3 来源可信度：由个人开发者（mrzilvis）维护，GitHub 活跃度需自行评估
- 无官方托管：转换脚本需手动部署，版本同步依赖用户自觉
- 网络配置敏感：生产环境需自行配置 HTTPS、域名和 IP 限制
- 依赖 Moltbot 生态：仅适用于已部署 Moltbot Gateway 的环境
适合人群
- 已使用 Fieldy 语音应用且希望接入 AI 智能体的用户
- 具备 Linux 服务器运维能力、熟悉 JSON 配置的技术人员
- 需要语音唤醒触发自动化工作流的开发者
常规风险与建议
| 风险点 | 缓解措施 |
|--------|----------|
| Token 泄露 | 使用 32+ 字节随机字符串，存储于环境变量，定期轮换 |
| Transform 脚本被篡改 | 审查 `fieldy-webhook.js` 来源，验证 SHA256 哈希，隔离测试后部署 |
| HTTP 明文传输 | 生产环境强制 HTTPS，配置 TLS 1.2+ |
| Webhook 未授权访问 | 限制网关 IP 白名单，启用请求签名验证 |
| 本地测试配置误用于生产 | 移除 127.0.0.1 示例配置，使用域名部署 |
认证结论
BSS Security Lab 认证：S 级（85 分），纯文档型 Skill，无可执行代码，无第三方依赖，符合 GDPR 合规要求。建议用户审查 transform 脚本内容后使用。