面向 OpenClaw Agent 的安全命令执行机制，具备自动危险模式检测、风险评估、用户审批工作流及审计日志功能。适用于 agent...
SafeExec - 安全命令执行
功能概述
SafeExec - 安全命令执行是一项面向实际任务的技能，主要用于为 OpenClaw 代理提供安全命令执行能力,自动拦截危险操作和批准工作流程。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
核心要点
- 使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
- 该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。
- 从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。
使用与执行
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。
结果检查与注意事项
执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。
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：只读操作及安全的文件操作
审批工作流
- Agent 执行命令
- SafeExec 分析风险等级
- 在终端中显示会话内通知
- 通过以下方式审批或拒绝：
- 终端命令：
safe-exec-approve - 查看待审批列表：
safe-exec-list - 拒绝请求：
safe-exec-reject
- 终端命令：
- 命令执行或被取消
示例通知：
🚨 **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'可全局禁用 SafeExecOPENCLAW_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 文件。
热门AI工具
相关专题
本专题聚焦Docker Desktop容器端口映射与访问配置，整理从创建容器、设置端口绑定到验证本地服务访问的操作流程。针对端口被占用、映射配置错误、容器服务无法访问等情况，也提供相应的检查方向，方便用户完成端口配置。
0
2026.11.03
想使用Docker Desktop将本地项目构建成Docker镜像？本专题围绕镜像构建的实际操作展开，介绍Dockerfile编写、构建命令使用、镜像标签设置和构建日志查看等内容，同时整理镜像无法生成、依赖安装失败及构建缓存异常等问题的排查思路。
0
2026.11.03
本专题聚焦Docker Desktop容器创建与运行配置，介绍通过本地镜像或远程镜像创建容器的方法，以及容器启动、终端访问、日志查看和基础管理等操作。针对端口冲突、参数配置不当、容器无法启动等情况，也整理了相应的排查方向。
0
2026.11.03
用 Tailwind CSS 制作导航栏和卡片，可先搭建语义化结构，再组合 Flex、Grid、间距、圆角与阴影类。这里整理横向导航、移动端菜单、卡片网格及悬停效果的相关文章，帮助你把常见页面组件做得清晰且适配不同屏幕。
0
2026.11.03
Tailwind CSS 响应式布局通常从移动端样式写起，再用 sm、md、lg 等前缀调整不同屏幕宽度下的网格、间距和导航。本专题整理断点配置、Grid 与 Flex 自适应布局及常见溢出问题，帮助你逐步完成多设备适配。
0
2026.11.03
Tailwind CSS 类名很多，先按布局、间距、文字、颜色和状态分组记忆，再通过官方文档检索具体写法。本专题结合类名排序、动态拼接失效、自定义实用类等问题，帮助你建立常用类名的速查方法。
0
2026.11.03
本专题汇总了码上飞（CodeFlying）的官方入口地址合集，涵盖官网主站及网页版在线使用入口，支持注册登录后直接在线体验零代码AI应用生成。同时整理了APP端下载渠道与小程序入口，助你快速访问平台，通过自然语言描述需求即可生成应用、小程序或网站。
0
2026.11.03
本专题汇总了Uvicorn服务器常见问题与报错解决的教程合集，涵盖启动失败、端口占用、模块导入错误、事件循环冲突及热重载失效等典型故障的排查思路。同时整理了多进程与Worker配置、SSL/HTTPS证书报错、跨域与代理配置等实战解决方案，助你快速定位并解决Uvicorn运行中的各类问题。
0
2026.11.02
本专题汇总了Uvicorn使用教程与启动运行指南，涵盖其作为Python ASGI服务器的定位与特点，以及命令行启动（uvicorn main:app --reload）、参数配置（host/port/workers）、程序内嵌运行与Gunicorn结合部署等核心用法。同时整理了热重载调试、日志配置与生产环境部署优化等技巧，助你快速掌握Uvicorn的运行与配置。
0
2026.11.02
热门下载
相关下载
精品课程
共6课时 | 12.1万人学习
共79课时 | 161.7万人学习
共6课时 | 54.7万人学习
最新文章
