/install alfred-openshell-sandbox
OpenShell Sandbox Skill
Secure execution environment for specialist agents using NVIDIA OpenShell.
Overview
OpenShell provides sandboxed containers with Landlock LSM + seccomp + network namespaces + L7 policy engine. Each specialist agent gets an isolated sandbox for safe code execution.
Sandboxes Available
| Sandbox | Agent | Purpose | Status |
|---|---|---|---|
coder-sandbox |
coder | Code execution, builds, tests | Ready |
security-sandbox |
security | Pentesting, security scans | Ready |
debug-sandbox |
debug | Bug reproduction, diagnosis | Ready |
test-sandbox |
qa-tester | Test execution | Ready |
CLI Reference
# List all sandboxes
openshell sandbox list
# Execute command in sandbox
openshell sandbox exec -n \x3Csandbox-name> -- \x3Ccommand> [args...]
# Interactive shell
openshell sandbox connect -n \x3Csandbox-name>
# Create new sandbox
openshell sandbox create --name \x3Cname>
# Delete sandbox
openshell sandbox delete \x3Cname>
# View logs
openshell logs -n \x3Csandbox-name>
# Gateway status
openshell status
# Diagnose issues
openshell doctor check
Agent Integration
For Coder Agent
When executing code that could affect the host system:
# Instead of running locally:
python3 script.py
# Run in sandbox:
openshell sandbox exec -n coder-sandbox -- python3 /workspace/script.py
For Security Agent
When running security tools or scans:
# Run nmap, nikto, etc. in isolated sandbox
openshell sandbox exec -n security-sandbox -- nmap -sV target
For Debug Agent
When reproducing bugs or testing fixes:
openshell sandbox exec -n debug-sandbox -- node test.js
For QA-Tester
When running test suites:
openshell sandbox exec -n test-sandbox -- pytest tests/
File Transfer
To copy files between host and sandbox:
# Copy file INTO sandbox (via exec cat)
cat local_file.py | openshell sandbox exec -n coder-sandbox -- tee /workspace/local_file.py
# Copy file FROM sandbox
openshell sandbox exec -n coder-sandbox -- cat /workspace/result.txt > local_result.txt
Policies
Default policies apply L7 network restrictions. To view/modify:
openshell policy list
Resource Limits
- CPU: Shared with host (24GB RAM server)
- Network: Restricted by L7 policy (no outbound by default)
- Disk: Ephemeral (deleted with sandbox)
- Timeout: 30 min default per exec command
Troubleshooting
- Sandbox not found: Run
openshell sandbox listto check status - Gateway down: Run
openshell statusandopenshell doctor check - Permission denied: Sandboxes run as unprivileged user
- Network blocked: Default policy denies outbound; use
openshell policyto modify
Architecture
Host (Ubuntu ARM64)
└── OpenShell Gateway (Docker + k3s)
├── coder-sandbox (aarch64, Python 3.13, Node 22)
├── security-sandbox (aarch64)
├── debug-sandbox (aarch64)
└── test-sandbox (aarch64)
Version
- OpenShell CLI: 0.0.35
- Base image: ghcr.io/nvidia/openshell-community/sandboxes/base:latest
- Platform: aarch64 (ARM64)
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install alfred-openshell-sandbox - 安装完成后,直接呼叫该 Skill 的名称或使用
/alfred-openshell-sandbox触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Alfred OpenShell Sandbox 是什么?
Provides isolated sandboxes using NVIDIA OpenShell for secure code execution, security scans, debugging, and test running with resource and network restricti... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 73 次。
如何安装 Alfred OpenShell Sandbox?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install alfred-openshell-sandbox」即可一键安装,无需额外配置。
Alfred OpenShell Sandbox 是免费的吗?
是的,Alfred OpenShell Sandbox 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Alfred OpenShell Sandbox 支持哪些平台?
Alfred OpenShell Sandbox 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Alfred OpenShell Sandbox?
由 lJokerl(@lllljokerllll)开发并维护,当前版本 v1.0.0。