Skill Information
Issue Description
The terminal-killer skill is flagged with a ⚠️ "suspicious" warning by VirusTotal Code Insight
when users try to install it.
This is a false positive. The detected patterns (execSync, shell config access, etc.) are
intentional core functionality, not malicious behavior.
What Does This Skill Do?
terminal-killer is a smart command router for OpenClaw agents:
- Detects if user input is a shell command (e.g.,
ls -la, git status, adb devices)
- Executes commands directly via
execSync (bypassing LLM for speed)
- Passes to LLM if input is a natural language request (e.g., "help me write code")
Why VirusTotal Flags It (and Why It's Safe)
| Detected Pattern | Why It's Flagged | Actual Purpose |
|-----------------|------------- -----|----------------|
| execSync / child_process | Can execute arbitrary code | Core functionality — executes user
commands |
| Reading ~/.zshrc, ~/.bashrc | Config file access | Load user's PATH and environment variables |
| Reading shell history | Privacy concern | Improve command detection accuracy |
| process.env access | Environment manipulation | Inherit user's shell environment |
| spawn for interactive shells | Process creation | Handle ssh, adb shell, docker exec -it |
Security Verification
✅ No Malicious Patterns
- ❌ No hard-coded API keys or secrets
- ❌ No external network calls (no
fetch, axios, http modules)
- ❌ No data exfiltration (no sending data to external servers)
- ❌ No code obfuscation (all plain JavaScript)
- ❌ No persistence mechanisms (no startup scripts, registry edits)
- ❌ No privilege escalation (runs as current user only)
✅ Security Measures Implemented
- Dangerous Command Detection — Prompts for confirmation on
rm -rf, sudo, dd, etc.
- 30-Second Timeout — Prevents hangs
- Environment Isolation — Runs in user's shell context, no system-wide modifications
- Full Transparency — All source code public, author identity disclosed
Code Statistics
| File |
Purpose |
Lines |
scripts/index.js |
Main entry point |
~180 |
scripts/detect-command.js |
Command detection logic |
~350 |
scripts/exec-command.js |
Command execution |
~80 |
scripts/interactive.js |
Interactive shell handling |
~150 |
clawhub.json |
Skill metadata (includes securityNote) |
~40 |
README.md |
Documentation with security notice |
~300 |
Total: ~1,100 lines of plain, readable JavaScript
Request
I respectfully request ClawHub to:
- Whitelist this skill from automatic VirusTotal warnings, OR
- Mark my account (@cosperypf) as a trusted developer for future publications, OR
- Add a visible note on the skill page explaining this is a known false positive
How to Verify
# Install the skill
clawhub install terminal-killer --force
# Review source code
cd ~/.openclaw/workspace/skills/terminal-killer
cat scripts/*.js
# Run tests
node scripts/test-detector.js
# Test execution
node scripts/index.js "ls -la"
node scripts/index.js "help me write code"
Contact
- Author: Cosper
- Email: cosperypf@163.com
- ClawHub Account: cosperypf (ID: kn7exrggk246859ahw29g0mk89820076 )
Thank you for reviewing this appeal! 🙏
Date: 2026-03-02
Skill Information
terminal-killerIssue Description
The⚠️ "suspicious" warning by VirusTotal Code Insight
terminal-killerskill is flagged with awhen users try to install it.
This is a false positive. The detected patterns (
execSync, shell config access, etc.) areintentional core functionality, not malicious behavior.
What Does This Skill Do?
terminal-killeris a smart command router for OpenClaw agents:ls -la,git status,adb devices)execSync(bypassing LLM for speed)Why VirusTotal Flags It (and Why It's Safe)
| Detected Pattern | Why It's Flagged | Actual Purpose |
|-----------------|------------- -----|----------------|
|
execSync/child_process| Can execute arbitrary code | Core functionality — executes usercommands |
| Reading
~/.zshrc,~/.bashrc| Config file access | Load user's PATH and environment variables || Reading shell history | Privacy concern | Improve command detection accuracy |
|
process.envaccess | Environment manipulation | Inherit user's shell environment ||
spawnfor interactive shells | Process creation | Handlessh,adb shell,docker exec -it|Security Verification
✅ No Malicious Patterns
fetch,axios,httpmodules)✅ Security Measures Implemented
rm -rf,sudo,dd, etc.Code Statistics
scripts/index.jsscripts/detect-command.jsscripts/exec-command.jsscripts/interactive.jsclawhub.jsonsecurityNote)README.mdTotal: ~1,100 lines of plain, readable JavaScript
Request
I respectfully request ClawHub to:
How to Verify