Skip to content

[Appeal] terminal-killer False Positive — Request to Remove VirusTotal Warning #579

@cosperypf

Description

@cosperypf

Skill Information

Field Value
Skill Name terminal-killer
Slug terminal-killer
Version 1.2.0
Author Cosper (@cosperypf)
Email cosperypf@163.com
Skill URL https://clawhub.ai/skills/terminal-killer

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:

  1. Detects if user input is a shell command (e.g., ls -la, git status, adb devices)
  2. Executes commands directly via execSync (bypassing LLM for speed)
  3. 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

  1. Dangerous Command Detection — Prompts for confirmation on rm -rf, sudo, dd, etc.
  2. 30-Second Timeout — Prevents hangs
  3. Environment Isolation — Runs in user's shell context, no system-wide modifications
  4. 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:

  1. Whitelist this skill from automatic VirusTotal warnings, OR
  2. Mark my account (@cosperypf) as a trusted developer for future publications, OR
  3. 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

Metadata

Metadata

Assignees

No one assigned

    Labels

    r: rescan-guidanceGuides owners to the ClawHub rescan flow for review requests.

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions