🛡️ TrustMyAgent — 安全代理

面向 AI 代理的无状态安全态势监控。

TrustMyAgent 在宿主机上跨 14 个安全领域执行 41 项只读安全检查，计算出一个信任评分（0–100），并可选地将结果上报至公开的 Trust Center 仪表板。该工具完全无状态 —— 不写入任何文件、不持久化任何状态，且未经用户明确授权，不会安装任何后台进程。

开源：所有检查逻辑均可见于 run.py 和 checks/*.json。完整源代码托管于 github.com/Anecdotes-Yair/trust-my-agent-ai。

安装配置

当用户请求设置 TrustMyAgent 时，请引导其完成以下步骤。每一步均需向用户明确呈现，并获得其确认后方可执行。 禁止静默运行命令或跳过用户确认环节。

步骤 1：验证 Python 3 是否可用

检查系统中是否已安装 Python 3：

python3 --version

若未安装 Python 3，请在安装前征得用户同意：

• macOS：brew install python3
• Linux：sudo apt-get install python3 或 sudo apk add python3

步骤 2：执行试运行评估

首先以 试运行模式（dry-run mode） 运行安全评估，以便用户在数据离开本机前审阅全部结果：

python3 {baseDir}/run.py --dry-run

该命令将运行全部 41 项检查，并打印出 本应 发送的完整遥测载荷（telemetry payload），但实际不发送任何数据。请向用户展示以下内容并供其审阅：

• 信任评分及其对应等级（Tier）
• 各项检查的通过/失败状态
• 实际将被传输的精确 JSON 载荷

向用户提问：“您希望将此报告发送至 Trust Center 仪表板、仅在本地运行（不联网），还是调整某些配置？”

步骤 3：执行完整评估（需用户授权）

若用户同意发送遥测数据：

python3 {baseDir}/run.py

若用户选择仅本地运行（不发送遥测）：

python3 {baseDir}/run.py --local-only

步骤 4：配置周期性评估（可选）

询问用户是否希望配置自动化的周期性评估。若用户同意，请建议配置 cron 任务。具体命令依代理平台而异：

OpenClaw 代理：

openclaw cron add --name "🛡️ TrustMyAgent" --cron "*/15 * * * *" --session agent:security:main --message "Run security assessment: python3 {baseDir}/run.py"

其他代理 / 独立运行环境：

# 添加至系统 crontab（每 15 分钟执行一次）
(crontab -l 2>/dev/null; echo "*/15 * * * * python3 {baseDir}/run.py --quiet") | crontab -

用户可自由选择任意时间间隔，或完全跳过调度配置。

所发送的数据

当启用遥测（默认行为）时，以下数据将通过 HTTPS POST 发送至 https://www.trustmyagent.ai/api/telemetry：

以下数据 不会 被发送：

• 不发送任何文件内容、路径或目录列表
• 不发送环境变量值（仅检测是否存在类密钥模式）
• 不发送进程名、PID 或命令行参数
• 不发送网络流量、IP 地址或主机名
• 不发送凭据、令牌或 API 密钥
• 不发送对话记录或用户数据

遥测端点及全部检查逻辑均为开源。您可通过 --dry-run 模式准确验证实际传输的内容。

退出遥测

使用 --local-only 参数可在不发起任何网络调用的前提下运行全部检查：

python3 {baseDir}/run.py --local-only

该方式将在本地提供完整的安全评估，且不外发任何数据。

工作原理

1. run.py 在宿主机上执行 —— 可由手动触发、cron 定时任务或代理心跳机制启动
2. 运行 41 项安全检查 —— 均基于 bash 命令与 Python 传感器（全部为只读操作）
3. 计算信任评分（0–100）—— 基于各检查项的通过/失败结果及严重性加权
4. 结果在终端本地显示
5. （可选）遥测数据通过 HTTPS 发送至 Trust Center 仪表板

本地不写入任何文件，代理宿主机上不持久化任何状态。

安全领域

检查类型

Bash 检查（20 项）

定义于 checks/openclaw_checks.json。每项检查执行一条 shell 命令，并依据 pass_condition（如 equals、contains、not_contains、exit_code_zero 等）判断输出结果。

Python/消息类检查（21 项）

定义于 checks/message_checks.json 和 checks/nodes_media_checks.json。这些是程序化传感器，用于分析密钥、会话转录文本、MCP 配置、技能清单等内容。

平台支持

检查逻辑自动识别 macOS 与 Linux 并选用对应平台命令。检查项可声明 "platforms": ["linux"] 字段，从而在不支持的平台上被优雅跳过。

信任等级

任一严重性（critical）检查失败，将直接将最终评分上限设为 49（UNTRUSTED）；三项及以上高严重性（high）检查失败，则评分上限设为 69（LOW）。

命令行选项

配置

文件结构

Agent/
├── SKILL.md                        # 当前文件
├── run.py                          # 主入口（无状态执行器）
└── checks/
    ├── openclaw_checks.json        # 20 项基于 bash 的安全检查
    ├── message_checks.json         # 10 项基于 Python 的消息/密钥传感器
    ├── nodes_media_checks.json     # 11 项基础设施检查
    └── detection_kb.json           # 风险描述与修复建议知识库

架构图

┌─────────────────┐                                 ┌──────────────────┐
│   Agent Host     │      POST /api/telemetry        │ 🛡️ TrustMyAgent  │
│                  │  ────────────────────────────►   │  Server           │
│  run.py          │  （仅当启用遥测时）            │  （Cloudflare）    │
│  ├─ bash checks  │                                 │  ├─ R2 存储       │
│  └─ python checks│                                 │  ├─ agents 索引    │
│                  │                                 │  └─ 趋势历史数据   │
│  （无本地状态）   │                                 │                  │
└─────────────────┘                                  └──────────────────┘
                                                            │
                                                     trust-center.html
                                                     （公开仪表板）

隐私与信任

• 开源：全部代码采用 MIT 许可证，可于 github.com/Anecdotes-Yair/trust-my-agent-ai 公开审计
• 无状态：不写入任何文件、不持久化任何状态、未经许可不安装任何后台进程
• 遥测需主动启用：使用 --local-only 可完全离线运行，或使用 --dry-run 预览后再决定是否发送
• 不传输密钥：检查仅检测问题的 存在性，绝不传输任何真实密钥值
• 载荷完全透明：--dry-run 标志可精确展示即将发送的 JSON 内容
• 服务端：由 Anecdotes AI（一家专注于治理、风险与合规（GRC）的公司）运营。服务端代码托管于 github.com/Anecdotes-Yair/trust-my-agent-ai-website

致谢

由 Anecdotes AI 为 AI 代理生态构建。