适用于 Openclaw 的 安全 Shell 执行

一个多层安全框架,旨在保护系统在 AI 驱动的 shell 命令执行过程中免受恶意或意外损坏。

lizlzzzz
v1.0.0
2026年4月1日
0
658
0

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install safe-shell-execution-claude-code

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式
~/.openclaw/skills/
工作区
<project>/skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 safe-shell-execution-claude-code。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

更倾向于下载?

获取包含原生技能文件的ZIP压缩包。

什么是 安全 Shell 执行?

安全 Shell 执行 (Safe Shell Execution) 技能是任何能够与终端交互的 AI Agent 的关键安全层。该技能基于 Claude Code 的生产安全工程模式,针对常见的 shell 漏洞和人为错误提供了强大的防御机制。它通过对命令注入、破坏性 git 操作以及对敏感系统或配置文件进行未经授权的修改实施严格检查,确保 Openclaw Skills 保持安全使用。

通过分层安全检查,该技能可防止诸如删除文件、泄露凭据或破坏 git 历史记录等不可逆转的损害。它旨在便携且高效地应用于 AI Agent 必须执行复杂系统操作同时保持高安全性的环境。

安全 Shell 执行 应用场景

  • 防止 AI 生成的 shell 脚本或命令字符串中的命令注入攻击。
  • 在自动化工作流中防止意外的破坏性操作(如 rm -rf 或强制 git 重置)。
  • 保护敏感配置文件(如 .bashrc、.ssh/config 或 AWS 凭据)免受未经授权的写入。
  • 在需要命令行访问的 Openclaw Skills 套件中标准化安全协议。

安全 Shell 执行 工作原理

  1. Agent 接收命令字符串并扫描注入模式,如命令替换 ($()) 或 Zsh 特定的扩展。
  2. 如果检测到破坏性模式(例如 git reset --hard),Agent 会暂停并请求明确的用户确认。
  3. 系统检查操作是否针对敏感路径,如凭据文件、shell 配置或系统文件。
  4. 命令根据其潜在影响被分类为安全层级(安全、谨慎、警告、拒绝)。
  5. 执行最终审查后的命令,或向用户提供详细的拒绝说明,解释具体的违规行为。

安全 Shell 执行 配置指南

要将此安全层集成到您的环境中,请确保您的 Agent 配置包含安全 Shell 执行定义。

# Agent 环境安装示例
openclaw install safe-shell-execution

配置您的 Agent 以在任何系统调用或 shell 执行之前触发这些检查。如果您正在开发自定义 Openclaw Skills,您可以将此逻辑导入到您的 shell 处理钩子中,以确保所有工具获得一致的保护。

安全 Shell 执行 数据架构与分类体系

该技能利用分类矩阵来确定执行路径和元数据记录:

安全级别 说明 操作
安全 只读操作,如 ls 或 git status 直接执行
谨慎 标准文件写入或非关键包安装 记录并执行
警告 破坏性操作(git 重置、强制删除) 提示用户确认
拒绝 恶意注入模式或敏感路径写入 拒绝并提供详细说明

安全 Shell 执行 高级特性

  • 注入模式检测:识别高级 shell 攻击,包括 Zsh 进程替换和命令替换中的 heredoc 注入。
  • 敏感路径保护:自动标记对关键凭据、SSH 密钥和系统配置文件的写入尝试。
  • 精细化 Git 安全:识别特定的破坏性 git 标志(如 --force 或 --hard),以防止意外的历史记录丢失。
  • 技术性拒绝逻辑:为命令被拦截的原因生成上下文相关的解释,提高开发人员对 Openclaw Skills 的信任。
  • 跨 Shell 兼容性:针对 Bash 和 Zsh 环境进行了优化,识别 Zsh 相等扩展等 shell 特有的攻击面。

SKILL.md


加载中

Openclaw 相关技能

METADATA

Github Stars: 0
forks: 0

精选*