Clawctl

v0.1.0

Coordination layer for OpenClaw agent fleets (tasks, messaging, activity feed, dashboard).

0· 800·0 current·4 all-time
MIT-0
Download zip
LicenseMIT-0 · Free to use, modify, and redistribute. No attribution required.
Security Scan
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Benign
high confidence
Purpose & Capability
Name/description match the code and SKILL.md: CLI (clawctl), DB layer, and Flask dashboard implement task board, messaging, activity feed, and a web UI. The declared required binary (clawctl) is appropriate. Minor inconsistency: registry/install metadata treats this as instruction-only, but the package source (pyproject, Python package files) is included — not dangerous but the packaging/installation story is unclear.
Instruction Scope
SKILL.md instructs running clawctl CLI commands and setting CLAW_AGENT/CLAW_DB; runtime instructions stay within the coordination/dashboard scope. Commands allow including JSON metadata that may reference local file paths (e.g. --meta '{"note":"path/to/file"}'), but the skill does not instruct the agent to read arbitrary system files or exfiltrate data. Dashboard persists a token file under ~/.openclaw/.clawctl-token — expected for local web UI auth.
Install Mechanism
No network install or remote download specs are present; source includes a standard pyproject.toml with only Click and Flask dependencies. This is low risk compared with remote fetch installs. The absence of an install spec means users must install the package (pip) or otherwise provide the clawctl binary.
Credentials
The skill does not request any external credentials and uses only CLAW_AGENT and CLAW_DB (both optional; defaults exist). Those env vars are referenced throughout the code and SKILL.md but are not listed in requires.env metadata — this mismatch is minor but worth documenting. No unrelated secrets or cloud credentials are requested.
Persistence & Privilege
always:false and no skill-wide privileged flags are used. The dashboard creates and persists a local token file at ~/.openclaw/.clawctl-token and runs a Flask server bound to 0.0.0.0 by default (intended for LAN/Tailscale access). That network exposure is expected for a dashboard but requires the user to be careful about where they run it and who can access the token file or the listening port.
Assessment
This skill appears to be what it says: a local coordination CLI + optional Flask dashboard backed by SQLite. Before installing or running it, consider the following: - Install method: the registry metadata omits an install step even though a Python package (pyproject.toml) is included. You should install into a virtualenv (pip install . or pip install -e . for development) rather than running unknown files globally. - Database safety: run initial tests with a temporary DB to avoid touching your real data (example: CLAW_DB=/tmp/test.db clawctl init). The README/CLAUDE.md recommend this. - Dashboard token and exposure: the dashboard writes a persistent token to ~/.openclaw/.clawctl-token and, by default, binds to 0.0.0.0. If you run the dashboard on a multi-user or public-facing host, ensure the token file is protected (filesystem permissions) and the port is not publicly accessible, or bind to localhost instead. - Environment vars: the code reads CLAW_AGENT and CLAW_DB (with sensible defaults). The skill metadata did not declare these env vars — be aware they influence behavior and identity fallback to $USER will occur with a one-time warning. - Review the code if you need stricter guarantees: SQL is parameterized and DB access patterns look race-aware; there are no obvious network calls to external services or obfuscated code. If you require tighter isolation, run inside a container or VM and use a temp DB. If you want, I can extract the full list of CLI commands or point out exact lines where the dashboard writes the token and binds to the network so you can audit or modify them before use.

Like a lobster shell, security has layers — review code before you run it.

latestvk974rjh7e1tdnx37hqz3kqgwzd80vn7k

License

MIT-0
Free to use, modify, and redistribute. No attribution required.

Runtime requirements

🛰️ Clawdis
Binsclawctl

Comments