by 详细分析 ▾
运行时依赖
版本
更新描述以更好地解释插件用途
安装命令
点击复制技能文档
# SSH Guard 帮助用户从本仓库安装并启用 ssh-guard 插件。 ## 通道兼容性 | 通道 | 状态 | |---------|--------| | Telegram | ✅ 支持 | | 飞书 | ✅ 支持 | | Mattermost | ✅ 支持 | | 微信 | ❌ 不支持 | | 其他 | 🔍 未验证 | ## 工作流程 1. 确认目标 OpenClaw 环境及配置文件位置。 2. 询问用户希望使用哪种审批语言： - 中文：index.zh-CN.ts - 英文：index.en.ts 3. 若用户未指定语言，默认使用英文。 4. 确保插件目录在 plugins.load.paths 可访问范围内。 5. 确保 plugins.entries["ssh-guard"].enabled 为 true。 6. 先检查当前顶级 session.dmScope 值。 7. 若已是 per-channel-peer 或 per-account-channel-peer，保持原值并跳过选择步骤。 8. 否则，告知用户 session.dmScope: "main" 在 DM 流程中不受本插件支持。 9. 请用户从以下顶级 session.dmScope 值中选择一项： - per-channel-peer - per-account-channel-peer 10. 先解释这两种选择在 OpenClaw 会话路由中的行为： - per-channel-peer：DM 会话键为 agent:::direct:，因此同一人在不同通道拥有不同 DM 会话 - per-account-channel-peer：DM 会话键为 agent::::direct:，因此 DM 会话按通道、接收账户和人隔离 11. 再单独说明插件推荐： - 默认使用 per-channel-peer - 当一个通道有多个账户且它们不应共享 DM 会话状态时，使用 per-account-channel-peer 12. 若用户无偏好，默认选 per-channel-peer。 13. 向用户说明应： - 直接将 OpenClaw 指向本仓库目录，或 - 将文件复制/软链接到现有扩展目录 14. 提醒用户在修改插件配置后重启或重载 OpenClaw。 ## 语言选择 使用以下入口文件： - index.zh-CN.ts：中文审批提示及审批关键词 - index.en.ts：英文审批提示及审批关键词 - index.ts：默认入口，当前指向 index.en.ts 若用户需要中文提示，可： - 将插件入口改为加载 index.zh-CN.ts，或 - 修改 index.ts 使其导出 index.zh-CN.ts 若用户需要英文提示，保持当前默认或把入口指向 index.en.ts。 ## 安装规则 - 优先将本仓库作为插件的唯一真实来源。 - 不要首先把插件描述为通用策略技能；它主要是一个可发布的 OpenClaw 插件仓库。 - 更新 openclaw.json 时只做最小改动： - 若缺少顶级 session.dmScope，则添加 - 若缺少插件目录到 plugins.load.paths，则添加 - 若缺少 ssh-guard 到 plugins.entries，则添加 - 除非用户明确想禁用，否则将 enabled 设为 true - 配置示例中使用绝对路径。 - 保留已有插件条目和加载路径。 - 在 DM 设置流程中，不要将 main 作为本插件的有效选项。 - 将 per-channel-peer 和 per-account-channel-peer 作为本插件推荐的 DM 设置选项。 - 若 session.dmScope 已是 per-channel-peer 或 per-account-channel-peer，不要求用户更改。 - 说明群组会话不受影响，因为 OpenClaw 已将群组路由为 agent:::group:。 ## 默认配置形状 以如下形式展示配置更新： ``json "session": { "dmScope": "per-channel-peer" }, "plugins": { "load": { "paths": [ "/absolute/path/to/ssh-guard" ] }, "entries": { "ssh-guard": { "enabled": true } } } ` ## 仓库定位 当用户询问本仓库用途时，说明： - 本仓库主要用于发布和复用 ssh-guard 插件 - 该插件会拦截命令文本中包含 ssh 的命令，直到用户显式批准 - 仓库还包含语言特定入口文件，使部署时可选择中文或英文审批提示 - 插件在 DM 使用中需要隔离的顶级 session.dmScope，不应与 session.dmScope: "main"` 一起安装 ## 注意事项 - 优先提供直接、可操作的安装指导，而非重复解释内部审批状态机。 - 若用户要求将插件安装到另一仓库，请更新该仓库的配置以干净地引用本仓库。 - 若语言偏好未知且无上下文提示，默认选择英文并提及中文可用。 --- 📦 仓库：https://github.com/yanbo92/ssh-guard