feelgoodbot

🛡️ macOS 文件监控与 TOTP 双因素认证

开源 macOS 安全工具,集成文件监控与 TOTP 认证,为 AI Agent 敏感操作提供防护,防止篡改与未授权执行。

收藏
10.6k
安装
2.5k
版本
v1.1.0
CLS 安全性认证2026-05-19
点击查看完整报告 >

使用说明

feelgoodbot 是一款专为 macOS 设计的开源安全工具,集成了文件完整性监控(FIM)和 TOTP 双因素认证两大核心功能。该工具通过建立系统文件基线快照,持续监控 /usr/bin、SSH 配置、启动代理、浏览器扩展及 AI Agent 配置文件等关键路径的变更,一旦检测到篡改立即通过本地通知或 clawdbot webhook 发送警报。同时,其创新的 TOTP 阶梯认证机制允许用户为敏感操作(如发送邮件、执行支付、SSH 连接、删除文件等)设置 OTP 验证,确保 AI Agent 在执行高风险操作前必须获得用户实时授权。

该工具的显著优势在于其针对 AI Agent 场景的深度优化。不同于传统安全软件,feelgoodbot 提供了细粒度的动作保护模式(如 payment:*delete:*),支持通配符匹配,并内置 15 分钟会话缓存机制,在安全性与用户体验间取得平衡。作为纯本地运行的工具,所有配置文件和密钥均存储于用户目录(~/.config/feelgoodbot/),无外部数据上传,且完全开源可审计,代码透明度高。

然而,该工具也存在一定局限性。首先,它仅支持 macOS 系统,且依赖 Go 1.21+ 环境,跨平台兼容性差。其次,虽然功能强大,但配置过程涉及多个步骤(安装 Go、初始化基线、配置守护进程、设置 TOTP、映射保护动作),对非技术用户门槛较高。此外,作为个人开发者(T3 来源)维护的项目,长期维护稳定性和社区支持规模不及企业级安全产品。

该工具最适合以下群体:频繁使用 Claude、Cursor 等 AI Agent 的 macOS 开发者,需要防止 AI 误操作或提示词注入攻击导致的数据泄露;对系统安全有较高要求的高级用户,希望监控系统文件是否被恶意软件篡改;以及已通过 clawdbot 构建自动化工作流的技术用户,希望为其添加安全层。

使用风险方面,安装过程涉及 go install 动态下载最新代码,虽来源明确但仍存在供应链风险。工具会修改系统 launchd 守护进程配置,若配置错误可能影响系统稳定性。TOTP 密钥仅本地存储,若未妥善备份恢复码且丢失密钥,可能导致无法执行受保护操作。此外,该工具与 clawdbot 生态深度绑定,独立使用时通知功能受限。

安全解读

核心用法

feelgoodbot 是一个面向 macOS 的安全防护工具套件,提供两大核心功能:

1. 文件完整性监控(FIM)

  • 建立系统关键文件基线快照,定期扫描检测篡改
  • 监控范围涵盖系统二进制文件、LaunchDaemon/Agent 持久化机制、SSH 授权密钥、sudoers/PAM 配置、Shell 配置文件、浏览器扩展及 AI 代理配置
  • 通过 launchd 守护进程后台运行,支持本地通知与 webhook 告警集成

2. TOTP 阶梯式认证(Step-Up Auth)

  • 为敏感 AI 代理操作(发邮件、支付、SSH、删除文件、发布代码等)强制要求 Google Authenticator 一次性密码验证
  • 15 分钟会话缓存减少重复验证摩擦
  • 支持备份恢复码应对 Authenticator 丢失场景

显著优点

  • 零信任安全设计:敏感操作强制人机验证,防止 AI 代理被劫持后自动执行危险指令
  • 纵深防御:文件监控 + 认证拦截双重保护,覆盖持久化攻击与实时操作滥用
  • 隐私优先:TOTP 密钥、webhook token 完全本地存储,无云端依赖
  • 开发者友好:通过 go install 快速部署,YAML/JSON 配置简洁,提供完整 Agent 集成伪代码示例

潜在局限

  • macOS 独占:Linux/Windows 用户无法直接使用
  • 需配合外部二进制:Skill 本身为文档型指导,实际功能依赖独立 Go 程序安装
  • 本地 webhook 依赖:告警集成需要额外部署 clawdbot 或其他本地 webhook 接收端
  • 无自动恢复机制:文件篡改检测后需人工介入处理,无自动隔离/回滚功能

适合人群

  • 使用 Claude/Cursor 等 AI 代理且担心「代理劫持」风险的 macOS 高级用户
  • 对系统安全有基本认知、能阅读配置文档的开发者与安全爱好者
  • 需要为自动化工作流添加「人机确认」环节的技术团队

常规风险

  • 供应链风险:需确保从官方 GitHub 仓库(kris-hansen/feelgoodbot)安装,避免第三方篡改版本
  • 权限配置疏忽:敏感配置文件(totp.json 等)若权限设置不当(非 600)可能被本地其他进程读取
  • 恢复码丢失:未备份 TOTP 恢复码且 Authenticator 应用丢失将导致认证锁定,需手动删除配置文件重置
  • 会话窗口滥用:15 分钟认证缓存期内若设备被物理访问,攻击者可利用有效会话执行受保护操作

feelgoodbot 内容

scripts文件夹
手动下载zip · 4.3 kB
setup.shtext/x-shellscript
请选择文件