OpenExec — 受管控的确定性执行（Skill）

OpenExec 是一项可运行的受管控执行服务。 它仅执行已获批准的操作。

它不是 Agent。 它不是策略引擎。 它不会自我授权。

OpenExec 在签名验证或执行过程中不发起任何出站 HTTP、RPC 或治理调用。所有验证均为完全离线进行。默认情况下，OpenExec 使用本地 SQLite 数据库（sqlite:///openexec.db）。数据库网络 I/O 仅在操作员通过 OPENEXEC_DB_URL 显式配置时发生。

安装

pip install -r requirements.txt

运行（本地）

python -m uvicorn main:app --host 0.0.0.0 --port 5000

端点

• GET / → 服务信息（部署健康检查）
• GET /health → 健康状态、运行模式、限制级别
• GET /ready → 就绪性检查
• GET /version → 版本元数据
• POST /execute → 确定性地执行一项已批准的操作
• POST /receipts/verify → 验证回执哈希完整性

运行模式

1) 演示模式（默认，免费）

无需外部治理组件，无需设置任何环境变量。

export OPENEXEC_MODE=demo

演示模式仍强制执行以下机制：

• 确定性执行
• 重放防护（nonce 唯一性）
• 回执生成

2) ClawShield 模式（生产环境 / 商业用途）

需提供由 ClawShield 签发的已签名审批凭证（signed approval artifact）。 OpenExec 使用配置的公钥，在本地离线验证 Ed25519 签名。

export OPENEXEC_MODE=clawshield
export CLAWSHIELD_PUBLIC_KEY="-----BEGIN PUBLIC KEY----- ... -----END PUBLIC KEY-----"
export CLAWSHIELD_TENANT_ID="tenant-id"

若签名验证失败，则拒绝执行。

注意：ClawShield 治理 SaaS 服务位于 https://clawshield.forgerun.ai/。OpenExec 在运行时不会访问该 URL，此链接仅作参考之用。

环境变量

所有环境变量均为可选。OpenExec 在演示模式下可零配置运行。

90 秒快速上手（演示模式）

1. 启动服务：

python -m uvicorn main:app --host 0.0.0.0 --port 5000

2. 确认服务健康状态：

curl http://localhost:5000/health

3. 执行一个确定性的演示操作：

curl -X POST http://localhost:5000/execute 
  -H "Content-Type: application/json" 
  -d '{
    "action":"echo",
    "payload":{"msg":"hello"},
    "nonce":"unique-1"
  }'

4. 重放尝试（返回相同结果，不重复执行）：

curl -X POST http://localhost:5000/execute 
  -H "Content-Type: application/json" 
  -d '{
    "action":"echo",
    "payload":{"msg":"hello"},
    "nonce":"unique-1"
  }'

回执（Receipts）

每次执行均生成一个回执哈希。 回执是证据，而非日志。

验证回执：

curl -X POST http://localhost:5000/receipts/verify 
  -H "Content-Type: application/json" 
  -d '{"exec_id":"","result":"","receipt":""}'

该 Skill 的能力

• 接收结构化的执行请求
• 强制执行重放防护
• 以确定性方式执行（仅限已批准的参数）
• 为每次执行尝试生成可验证的回执
• 在 ClawShield 模式下：执行前验证已签名的审批凭证
• 支持通过环境变量配置可选的执行白名单

该 Skill 不具备的能力

• 定义策略
• 授予权限
• 自主推理
• 覆盖治理决策
• 自我授权执行
• 在执行过程中发起出站 HTTP 或治理调用
• 提供操作系统级沙箱或容器隔离

安全边界声明

OpenExec 在应用层强制实施执行边界， 但不提供操作系统级沙箱能力。 当所执行的操作涉及生产系统时，请将其部署于容器化环境、虚拟机隔离环境或加固环境中。

OpenExec 强制实施权限分离。 它不是沙箱。

架构上下文（三层分离）

• OpenExec —— 确定性执行适配器（即本 Skill）
• ClawShield —— 治理与审批凭证签发（SaaS）：https://clawshield.forgerun.ai/
• ClawLedger —— 见证账本（可选集成）

每一层均可独立替换；任一层均无法单独运作。

安全文档

完整的安全模型、威胁假设及生产环境加固检查清单详见 SECURITY.md。

本 Skill 明确分离以下职责：

• 执行强制（OpenExec）
• 基础设施隔离（由操作员负责）

执行安全性保障

本 Skill 具备以下特性：

• 不动态加载代码
• 不将用户输入作为代码求值
• 使用静态处理器注册表
• 不在运行时安装软件包
• 不拉取远程执行逻辑