← Back to Skills Marketplace
29
Downloads
1
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install mainctrl
Description
Manage OpenClaw agent tool-call permissions. A runtime plugin hook intercepts write, edit, exec, process, and apply_patch from controlled agents, redirecting...
Usage Guidance
Install only if you want workflow enforcement where main delegates implementation to sub-agents, not a security sandbox. Turn it on explicitly after install, verify status, restrict who can run the CLI, and treat plugin removal, off mode, and automatic sub-agent delegation as actions that can restore or preserve full write/execute capability.
Capability Assessment
Purpose & Capability
The stated purpose is runtime tool-access control for selected agents, but the actual control mainly reroutes blocked actions to sub-agents that intentionally keep full write and exec access; that is coherent for workflow enforcement but weak as a safety boundary.
Instruction Scope
The skill instructs the controlled main agent to immediately spawn a sub-agent after a block and explicitly not wait for user confirmation, which is high-impact behavior for write, edit, exec, process, and apply_patch operations.
Install Mechanism
The companion plugin installation and removal commands are documented and user-invoked, but they modify OpenClaw plugin state and the install path uses --force without an explicit confirmation step.
Credentials
The before_tool_call hook and local state-file reads are proportionate to the permission-control purpose, and there is no evidence of network exfiltration, credential collection, or unrelated file access.
Persistence & Privilege
The plugin activates on startup and persists until disabled or uninstalled; this is expected for an enforcement plugin, but users should understand that safety starts off and removal or off mode restores unrestricted behavior.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install mainctrl - After installation, invoke the skill by name or use
/mainctrl - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Added README.md with documentation and usage instructions.
- Removed skill-card.md (no longer included).
- Updated plugin/package.json and scripts/state.json (likely for metadata or configuration improvements).
- No user-facing behavior changes; documentation and packaging updates only.
v1.0.0
Initial release of mainctrl: runtime tool-call access control for OpenClaw agents.
- Intercepts and blocks destructive tool calls (`write`, `edit`, `exec`, `process`, `apply_patch`) by selected agents, redirecting them to sub-agents.
- Enables or disables access control instantly at runtime with a script—no config edits or restarts required.
- Only affects agents listed in `controlledAgents`; others retain full access.
- Includes CLI (`scripts/mainctrl.sh`) for managing state, agents, blocked tools, and plugin installation.
- Companion plugin reads state on every call, ensuring immediate effect for any changes.
- Main agent automatically delegates blocked operations to sub-agents and reports to the user.
Metadata
Frequently Asked Questions
What is Mainctrl?
Manage OpenClaw agent tool-call permissions. A runtime plugin hook intercepts write, edit, exec, process, and apply_patch from controlled agents, redirecting... It is an AI Agent Skill for Claude Code / OpenClaw, with 29 downloads so far.
How do I install Mainctrl?
Run "/install mainctrl" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Mainctrl free?
Yes, Mainctrl is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Mainctrl support?
Mainctrl is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Mainctrl?
It is built and maintained by iFeel (@ifeel-is-a-mouse); the current version is v1.0.1.
More Skills