返回顶部
e

exec-guard执行守卫

Safe command execution for AI agents with timeout control, 8KB ring buffer memory protection, background process management, and multi-agent sharing via HTTP service. Use when executing system commands, running long tasks, starting services, or managing background processes. Supports CLI and HTTP server modes.

作者: admin | 来源: ClawHub
源自
ClawHub
版本
V 1.0.6
安全检测
已通过
385
下载量
免费
免费
0
收藏
概述
安装方式
版本历史

exec-guard

exec-guard - AI智能体命令执行模块

为AI智能体提供安全可靠的系统命令执行功能。

快速开始

命令行模式

bash
echo {command: ls -la} | node scripts/dist/index.js

HTTP服务模式

bash
node scripts/dist/index.js --server --port 8080
curl -X POST http://localhost:8080/exec -H Content-Type: application/json -d {command: ls -la}

核心能力

能力描述
同步执行带超时执行命令,等待结果返回
后台执行
启动长时间任务,获取进程ID,后续查询 | | 等待窗口 | 返回前确认服务已启动 | | 8KB环形缓冲区 | 头尾双缓冲区防止内存溢出 | | 进程管理 | 查询状态、获取日志、终止进程 | | 多智能体共享 | HTTP服务允许多个智能体共享状态 |

API参考

POST /exec

执行命令:

json
{
command: 必填 - 系统命令,
workingDir: 可选 - 工作目录,
timeoutSeconds: 可选 - 默认30秒,
runInBackground: 可选 - 默认false,
watchDurationSeconds: 可选 - 用于服务启动,
env: 可选 - 自定义环境变量
}

GET /process/:pid

查询进程状态。

GET /process/:pid/logs

获取进程输出日志。

DELETE /process/:pid

终止进程。

GET /processes

列出所有后台进程。

响应状态

状态含义
success命令执行成功,退出码0
failed
命令执行失败,非零退出码 | | timeout | 命令超时被终止 | | killed | 进程被手动终止 | | running | 后台进程正在运行 |

最佳实践

  1. 1. 设置合理超时 - 防止命令卡死
  2. 服务使用等待窗口 - 确认启动成功
  3. 长时间任务使用后台模式 - 训练、数据处理等
  4. 清理进程 - 完成后及时终止

完整文档

详细使用指南和示例请参见 references/AGENT_GUIDE.md。

许可证

MIT

标签

skill ai

通过对话安装

该技能支持在以下平台通过对话安装:

OpenClaw WorkBuddy QClaw Kimi Claude

方式一:安装 SkillHub 和技能

帮我安装 SkillHub 和 exec-guard-1775976140 技能

方式二:设置 SkillHub 为优先技能安装源

设置 SkillHub 为我的优先技能安装源,然后帮我安装 exec-guard-1775976140 技能

通过命令行安装

skillhub install exec-guard-1775976140

下载

⬇ 下载 exec-guard v1.0.6(免费)

文件大小: 40.15 KB | 发布时间: 2026-4-13 10:13

v1.0.6 最新 2026-4-13 10:13
Reorganized directory structure: scripts/ for code, references/ for docs

Archiver·手机版·闲社网·闲社论坛·羊毛社区· 多链控股集团有限公司 · 苏ICP备2025199260号-1

Powered by Discuz! X5.0   © 2024-2025 闲社网·线报更新论坛·羊毛分享社区·http://xianshe.com

p2p_official_large
返回顶部