Install or upgrade VT Sentinel security plugin. Use when the user asks to install, set up, enable, update, or upgrade VT Sentinel, VirusTotal scanning, malware protection, or file security scanning. Handles fresh installs and upgrades from any previous version.
This skill delegates everything to the official openclaw CLI. It does not
delete files, edit openclaw.json manually, download tarballs from external
URLs, or touch system services directly. All filesystem and config changes are
performed by openclaw plugins subcommands.
What this skill will do
Before proceeding, tell the user the exact actions that will run, so they can
approve:
If not installed → openclaw plugins install clawhub:openclaw-plugin-vt-sentinel
(downloads the verified ClawHub package into ~/.openclaw/extensions/).
If installed → openclaw plugins update openclaw-plugin-vt-sentinel
(in-place upgrade handled by the OpenClaw CLI).
openclaw gateway restart — restart the user-scope gateway so the plugin loads.
Verify the plugin is active.
User data (vt-sentinel-agent.json, vt-sentinel-state.json,
vt-sentinel-audit/) lives in <OPENCLAW_STATE_DIR> (outside the plugin
directory) and is preserved across install/upgrade.
The OpenClaw CLI handles the upgrade atomically: it fetches the latest version,
replaces the extension directory, and updates plugins.installs metadata. User
config in plugins.entries and state files under <OPENCLAW_STATE_DIR> are
preserved.
If the CLI reports "already at latest version", tell the user VT Sentinel is
up to date and skip to Step 5 (verify only).
If the update is blocked (for example by a corrupted install), fall back to a
clean reinstall using only official subcommands:
uninstall removes the extension directory and cleans plugins.installs in a
single supported operation — do not edit openclaw.json manually.
Step 4: Restart the gateway
The plugin will not become active until the gateway restarts. The OpenClaw CLI
provides a cross-platform wrapper that handles the underlying service manager
(launchd on macOS, systemd user unit on Linux, schtasks on Windows):
text
exec { "command": "openclaw gateway restart" }
Step 5: Verify
text
exec { "command": "openclaw plugins list" }
Confirm openclaw-plugin-vt-sentinel appears as loaded. A healthy install
registers 9 tools and 2 hooks.
Step 6: Inform the user
VT Sentinel is installed and active (mention whether this was a fresh
install or an upgrade, and from which version if known).
No API key needed — the plugin auto-registers with VirusTotal's AI API
(VTAI) on first scan. Zero configuration required.
Optionally, the user can add their own VirusTotal API key for higher rate
limits:
text
openclaw config set plugins.entries.openclaw-plugin-vt-sentinel.config.apiKey "vt_xxxxxxxx"
Since v0.11.0 the VIRUSTOTAL_API_KEY environment variable fallback was
retired — only the plugin config value or VTAI auto-registration are
supported.
What VT Sentinel provides
Tools exposed after install:
vt_scan_file — Full file scan (AV + AI Code Insight)
vt_check_hash — Quick hash lookup
vt_upload_consent — Consent flow for sensitive file uploads
vt_sentinel_status — View current config, watched dirs, protection status