核心用法
Fieldy 是一个 Moltbot Gateway 的 webhook 集成技能，用于将 Fieldy 应用的语音转录数据接入 Moltbot 智能体。核心架构包含三层：
1. Webhook 入口：接收 POST /hooks/fieldy 请求，需携带认证 token
2. 转换模块 (fieldy-webhook.js)：解析 transcript 内容，识别唤醒词（默认 "Hey, Fieldy" 或 "Fieldy"）
3. 智能体触发：匹配唤醒词后，提取后续文本作为消息内容触发指定 agent
配置流程
- 部署转换脚本到指定目录
- 在
moltbot.json中配置 hooks 映射，启用 transform 模块 - 在 Fieldy 应用后台设置 webhook URL 及 token
- 重启 Gateway 服务使配置生效
唤醒机制
- 触发模式：transcript 包含唤醒词 → 提取 wake word 之后的内容 → 注入
{{message}}模板 → 触发 agent - 静默模式：无唤醒词的 transcript 仅记录/保存，不触发智能体
- 可定制性：唤醒词、解析逻辑、日志行为均可通过修改
fieldy-webhook.js调整
显著优点
| 维度 | 优势 |
|------|------|
| 灵活性 | 模块化解耦，transform 脚本可独立迭代 |
| 安全性 | 支持 token 认证（query param 或 Authorization header） |
| 成本可控 | 无唤醒词请求不触发 agent，避免无效计算消耗 |
| 生态兼容 | 原生适配 Fieldy 应用，Moltbot 生态标准 webhook 接口 |
潜在局限
1. 部署复杂度：需手动管理文件路径、JSON 配置、服务重启等多环节
2. 调试门槛：transform 逻辑黑盒化，错误排查依赖日志审查
3. 单点依赖：Gateway 重启为必需步骤，生产环境需考虑可用性影响
4. 扩展性边界：当前仅支持单一路径映射 (/hooks/fieldy)，多实例部署需重复配置
适合人群
- 已部署 Moltbot Gateway 并需要集成 Fieldy 语音数据的开发者
- 追求低延迟语音交互触发，且能接受自托管运维的团队
- 需要将语音唤醒词与 LLM agent 联动的自动化场景构建者
常规风险
- 认证泄露：token 通过 URL query param 传输时可能暴露在日志/历史记录中
- 脚本注入：
fieldy-webhook.js作为执行模块，若来源不可信存在代码执行风险 - 服务可用性：Gateway 单点故障将中断整个 webhook 链路
- 消息注入：未充分 sanitize 的 transcript 内容可能通过
{{message}}模板引发 prompt 注入