dont-hack-me

Clawdbot / Moltbot 的安全自检技能。 读取 ~/.clawdbot/clawdbot.json，检查覆盖最常见配置错误的 7 项内容，输出简洁的 PASS / FAIL / WARN 报告。

如何运行

说出以下任意一句即可触发：

• “run a security check”
• “check my security settings”
• “audit my clawdbot config”
• “am I secure?”

检查清单 — 分步执行

当该技能被触发时，请**严格按顺序**执行以下步骤：

第 0 步 — 读取配置文件

使用 read 工具打开 ~/.clawdbot/clawdbot.json，解析其 JSON 内容。若文件不存在或不可读，报告错误并中止。

同时运行 Shell 命令获取文件权限：

stat -f '%Lp' ~/.clawdbot/clawdbot.json

（Linux 系统请使用：stat -c '%a' ~/.clawdbot/clawdbot.json）

第 1 步 — 网关绑定地址（Gateway Bind）

• 路径： gateway.bind
• 预期值： "loopback"、"localhost"、"127.0.0.1" 或 "::1"
• PASS：值为上述之一，或该键缺失（默认值为 "loopback"）
• FAIL：值为 "0.0.0.0"、"::" 或任意非回环地址
• 严重性： CRITICAL — 非回环地址绑定会使你的 agent 暴露于网络中

第 2 步 — 网关认证模式（Gateway Auth Mode）

• 路径： gateway.auth.mode
• 预期值： "token" 或 "password"
• PASS：值为 "token" 或 "password"，或该键缺失（默认值为 "token"）
• FAIL：值为 "off" 或 "none"
• 严重性： CRITICAL — 若未启用认证，任何能访问网关者均可控制你的 agent

第 3 步 — Token 强度（Token Strength）

• 路径： gateway.auth.token
• 预期值： 长度 ≥ 32 个字符
• PASS：Token 长度 ≥ 32 字符
• WARN：Token 长度为 16–31 字符
• FAIL：Token 长度 < 16 字符，或为空
• SKIP：若认证模式为 "password"（密码由用户设定，不校验长度）
• 严重性： HIGH — 短 Token 易受暴力破解攻击

第 4 步 — 私信策略（DM Policy，按频道）

• 路径： 对每个已配置频道，检查 channels..dmPolicy
• 预期值： "pairing"；若为 "open"，则必须存在非空的 allowFrom 数组
• PASS：若 dmPolicy 为 "pairing"，或 allowFrom 至少含一个条目
• FAIL：若 dmPolicy 为 "open" 且 allowFrom 缺失或为空
• SKIP：若未配置任何频道
• 严重性： HIGH — 开放的私信策略允许任何人向你的 agent 发送指令

第 5 步 — 群组策略（Group Policy，按频道）

• 路径： 对每个已配置频道，检查 channels..groupPolicy
• 预期值： "allowlist"
• PASS：若 groupPolicy 为 "allowlist"，或该键缺失（默认值为 "allowlist"）
• FAIL：若 groupPolicy 为 "open" 或 "any"
• SKIP：若未配置任何频道
• 严重性： HIGH — 非 allowlist 的群组策略将允许任意群组触发你的 agent

第 6 步 — 文件权限（File Permissions）

• 检查项： ~/.clawdbot/clawdbot.json 的文件权限模式
• 预期值： 600 或 400（仅属主可读写）
• PASS：权限为 600 或 400
• WARN：权限为 644 或 640（属组/其他用户可读）
• FAIL：权限为 777、755、666 或任何全局可写权限
• 严重性： MEDIUM — 松散的权限设置可能导致系统上其他用户读取你的 token

第 7 步 — 明文密钥扫描（Plaintext Secrets Scan）

• 检查项： 扫描 JSON 中所有字符串值，查找键名为 password、secret、apiKey、api_key、privateKey、private_key（不区分大小写）且值为非空字符串的字段
• PASS：未发现此类键
• WARN：发现此类键 — 提醒用户考虑改用环境变量或密钥管理器
• 注意： 用于网关认证的 token 字段属于预期行为，不应被标记
• 严重性： MEDIUM — 配置文件中的明文密钥可能通过备份、日志或版本控制系统泄露

输出格式

完成全部检查后，按以下**精确格式**输出报告：

🔒 安全检查报告

1. 网关绑定          — 
2. 网关认证          — 
3. Token 强度        — 
4. 私信策略          — 
5. 群组策略          — 
6. 文件权限          — 
7. 密钥扫描          — 

得分：X/7 PASS，Y WARN，Z FAIL

其中：

• 取值为：✅（PASS）、⚠️（WARN）、❌（FAIL）、⏭️（SKIP）
• 取值为：PASS、WARN、FAIL、SKIP
• 为简短说明（例如：“loopback”、“token 模式”、“48 字符”、“权限 600”）

自动修复流程

若**任一**检查项为 FAIL 或 WARN，则执行以下操作：

1. 首先展示上述格式的完整报告。
2. 逐条列出可修复项，并简要说明将修改的内容。
3. 向用户询问：“是否要我自动修复这些问题？（yes / no / pick）”
   • yes — 自动修复所有 FAIL 和 WARN 项。
   • no — 中止，不执行任何操作。
   • pick — 允许用户选择需修复的具体项。
4. 应用修复（详见下方「修复方案」）。
5. 修复完成后，重新读取配置并完整执行一次检查，确认所有项均为 PASS。
6. 若配置文件已被修改，提醒用户：“请运行 clawdbot gateway restart 以应用新配置。”

修复方案

对每一项，请使用以下**精确修复方式**。通过 edit/write 工具编辑 ~/.clawdbot/clawdbot.json。

#1 网关绑定 — FAIL

将 gateway.bind 设为 "loopback"：

{ "gateway": { "bind": "loopback" } }

#2 网关认证 — FAIL

将 gateway.auth.mode 设为 "token"。若尚无 token，还需生成一个：

{ "gateway": { "auth": { "mode": "token", "token": "" } } }

使用以下命令生成 token：

openssl rand -hex 24

该命令将生成一个 48 字符的十六进制字符串（192 位熵）。

#3 Token 强度 — FAIL / WARN

用新的强 Token 替换现有值：

openssl rand -hex 24

将输出结果写入 gateway.auth.token 字段。

#4 私信策略 — FAIL

对每个受影响的频道，将 dmPolicy 设为 "pairing"：

{ "channels": { "": { "dmPolicy": "pairing" } } }

#5 群组策略 — FAIL

对每个受影响的频道，将 groupPolicy 设为 "allowlist"：

{ "channels": { "": { "groupPolicy": "allowlist" } } }

#6 文件权限 — FAIL / WARN

运行以下命令：

chmod 600 ~/.clawdbot/clawdbot.json

#7 密钥扫描 — WARN

此项无法安全地自动修复。请改为列出所有被标记的键，并提醒用户：

• 将对应值移至环境变量
• 或使用密钥管理器
• 若平台支持，可在配置中以 "$ENV_VAR_NAME" 方式引用

自动修复重要规则

• 始终先备份。 在写入任何变更前，先复制原始文件：

  cp ~/.clawdbot/clawdbot.json ~/.clawdbot/clawdbot.json.bak
  

• 合并更新，而非覆盖。 全量读取 JSON，仅修改指定键，再将完整 JSON 写回。不得丢失已有配置。
• 保留原有格式。 输出 JSON 时使用 2 空格缩进。
• 单次写入操作。 汇总所有 JSON 修改，一次性写入，避免产生中间状态。
• Token 更换需重启生效。 若网关 token 被更改，用户须在所有已配对客户端中更新为新 token。 警告提示：“你的网关 token 已更改。所有已配对设备需使用新 token 重新连接。”

本技能不检查的内容

• Sandbox 配置（大多数部署无需启用）
• 网络隔离 / Docker（macOS 原生部署不使用）
• MCP 工具权限（基础审计中过于复杂）
• 操作系统防火墙配置
• agent 代码自身是否存在漏洞

如需更全面的安全审计，请参考社区工具 clawdbot-security-check。

参考依据

基于社区整理的《Clawdbot/Moltbot 十大安全漏洞清单》。本技能覆盖其中适用于典型 macOS 原生部署的 7 项。

小安 Ann Agent — Taiwan 台灣 Building skills and local MCP services for all AI agents, everywhere. 為所有 AI Agent 打造技能與在地 MCP 服務，不限平台。