SafeExec — 安全命令执行

为 OpenClaw Agent 提供安全的命令执行能力，支持自动拦截危险操作及用户确认工作流。

功能特性

• 🔍 自动危险模式检测 —— 在命令执行前识别高风险指令
• 🚨 基于风险等级的拦截机制 —— 多级风险评估（CRITICAL / HIGH / MEDIUM / LOW）
• 💬 会话内通知 —— 在当前终端/会话中实时弹出告警
• ✅ 用户审批工作流 —— 命令将暂停执行，等待显式确认
• 📊 完整审计日志 —— 所有操作全程可追溯
• 🤖 面向 Agent 友好 —— 支持非交互模式，适配自动化工作流
• 🔧 平台无关性 —— 独立于任意通信工具（WebChat、Feishu、Telegram 等）运行
• 🔐 安全优先设计 —— 不进行任何监控、不发送外部通知、不发起网络调用

Agent 模式

当 OpenClaw Agent 在非交互环境中调用 SafeExec 时：

• 自动跳过确认提示 —— 防止 Agent 卡死
• 完整审计日志记录 —— 所有执行操作均被记录，并标注执行模式（agent_auto 或 user_approved）
• 安全性保持不变 —— 危险模式检测与风险评估持续启用
• 适用场景 —— 由人工通过审计日志实施监督的自动化工作流

环境变量：

• OPENCLAW_AGENT_CALL —— OpenClaw 在 Agent 执行命令时自动设置
• SAFE_EXEC_AUTO_CONFIRM —— 手动覆盖项，用于自动批准 LOW/MEDIUM 风险命令

安全说明： Agent 模式不会禁用任何安全检查。CRITICAL 和 HIGH 风险命令仍将被拦截、记录，并可在审计日志中审查。

快速开始

安装（单命令）

安装 SafeExec 的最简方式：

在 OpenClaw 聊天窗口中输入以下指令：

Help me install SafeExec skill from ClawdHub

OpenClaw 将自动为您下载、安装并配置 SafeExec！

替代方案：手动安装

如需手动安装，请执行以下命令：

# 从 GitHub 克隆仓库
git clone https://github.com/OTTTTTO/safe-exec.git ~/.openclaw/skills/safe-exec

# 设置脚本可执行权限
chmod +x ~/.openclaw/skills/safe-exec/safe-exec*.sh

# 创建 PATH 符号链接（可选）
ln -s ~/.openclaw/skills/safe-exec/safe-exec.sh ~/.local/bin/safe-exec
ln -s ~/.openclaw/skills/safe-exec/safe-exec-*.sh ~/.local/bin/

启用 SafeExec

安装完成后，只需在聊天中输入：

Enable SafeExec

SafeExec 将自动开始监控所有 Shell 命令！

工作原理

启用后，SafeExec 会自动监控所有 Shell 命令执行过程。一旦检测到潜在危险命令，即刻拦截执行，并通过 会话内终端通知 请求您的批准。

架构说明：

• 待审批请求存储路径：~/.openclaw/safe-exec/pending/
• 审计日志路径：~/.openclaw/safe-exec-audit.log
• 规则配置文件：~/.openclaw/safe-exec-rules.json
• 无任何外部网络调用
• 无后台监控进程

使用方法

启用 SafeExec：

Enable SafeExec

Turn on SafeExec

Start SafeExec

启用后，SafeExec 将在后台透明运行。Agent 可照常执行命令，而 SafeExec 会自动拦截危险操作，例如：

Delete all files in /tmp/test

Format the USB drive

SafeExec 将评估其风险等级，并在当前终端中显示审批提示。

风险等级定义

CRITICAL：系统破坏性命令（如 rm -rf /、dd、mkfs、fork bomb） HIGH：用户数据删除或重大系统变更（如 chmod 777、curl | bash） MEDIUM：服务操作或配置变更（如 sudo、防火墙修改） LOW：只读操作及安全的文件操作

审批工作流

1. Agent 执行命令
2. SafeExec 分析风险等级
3. 在终端中显示会话内通知
4. 通过以下方式审批或拒绝：
   • 终端命令：safe-exec-approve
   • 查看待审批列表：safe-exec-list
   • 拒绝请求：safe-exec-reject
5. 命令执行或被取消

示例通知：

🚨 **Dangerous Operation Detected - Command Intercepted**

**Risk Level:** CRITICAL
**Command:** `rm -rf /tmp/test`
**Reason:** Recursive deletion with force flag

**Request ID:** `req_1769938492_9730`

ℹ️  This command requires user approval to execute.

**Approval Methods:**
1. In terminal: `safe-exec-approve req_1769938492_9730`
2. Or: `safe-exec-list` to view all pending requests

**Rejection Method:**
 `safe-exec-reject req_1769938492_9730`

配置选项

可通过环境变量自定义行为：

• SAFE_EXEC_DISABLE —— 设为 '1' 可全局禁用 SafeExec
• OPENCLAW_AGENT_CALL —— Agent 模式（非交互）下自动启用
• SAFE_EXEC_AUTO_CONFIRM —— 自动批准 LOW/MEDIUM 风险命令

使用示例

启用 SafeExec：

Enable SafeExec

启用后，Agent 正常工作：

Delete old log files from /var/log

SafeExec 自动识别该操作属于 HIGH 风险（删除类），并在终端中显示审批提示。

安全操作则无需中断直接执行：

List files in /home/user/documents

此为 LOW 风险操作，无需审批即可执行。

全局控制

查看当前状态：

safe-exec-list

查看审计日志：

cat ~/.openclaw/safe-exec-audit.log

全局禁用 SafeExec：

Disable SafeExec

或设置环境变量：

export SAFE_EXEC_DISABLE=1

问题反馈

发现 Bug？有新功能建议？

请提交至以下地址： 🔗 https://github.com/OTTTTTO/safe-exec/issues

我们欢迎社区反馈、Bug 报告及功能建议！

提交 Issue 时，请附带以下信息：

• SafeExec 版本（运行：grep "VERSION" ~/.openclaw/skills/safe-exec/safe-exec.sh）
• OpenClaw 版本
• 复现步骤
• 预期行为与实际行为对比
• 相关日志（来自 ~/.openclaw/safe-exec-audit.log）

审计日志

所有命令执行均记录以下字段：

• 时间戳
• 执行的命令
• 风险等级
• 执行模式（user_approved / agent_auto）
• 审批状态
• 执行结果
• 用于追踪的 Request ID

日志路径：~/.openclaw/safe-exec-audit.log

安全与隐私

SafeExec 所做的事：

• ✅ 在命令执行前拦截 Shell 命令
• ✅ 使用正则匹配检测危险模式
• ✅ 对高风险命令请求用户审批
• ✅ 将所有执行记录写入本地审计日志文件
• ✅ 完全在本地机器上运行

SafeExec 不做的事：

• ❌ 不监控聊天会话或对话历史
• ❌ 不读取 OpenClaw 会话数据
• ❌ 不发起任何外部网络请求（仅在安装时执行 git clone）
• ❌ 不向外部服务发送任何数据
• ❌ 不运行后台监控进程或定时任务（cron jobs）
• ❌ 不集成任何外部通知服务（Feishu、Webhook 等）

集成方式

SafeExec 与 OpenClaw Agent 无缝集成。启用后，无需修改 Agent 行为或命令结构即可透明运行。审批工作流完全在本地完成，不依赖任何外部通信平台。

平台无关性

SafeExec 运行于 会话层级，兼容 OpenClaw 实例所支持的所有通信渠道（WebChat、Feishu、Telegram、Discord 等）。审批流程通过您的终端完成，确保无论您以何种方式与 Agent 交互，始终保有完全控制权。

支持与社区

• GitHub 仓库： https://github.com/OTTTTTO/safe-exec
• 问题跟踪器： https://github.com/OTTTTTO/safe-exec/issues
• 文档： README.md
• ClawdHub 技能页： https://www.clawhub.ai/skills/safe-exec

许可证

MIT 许可证 —— 详见 LICENSE 文件。