← Back to Skills Marketplace
Openclaw Gateway Fd Fix
by
Jian Zhang
· GitHub ↗
· v1.0.0
626
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install openclaw-gateway-fd-fix
Description
Fix OpenClaw Gateway "spawn EBADF" / "RPC probe failed" / "EMFILE too many open files" errors caused by file descriptor exhaustion from too many files in wor...
Usage Guidance
This skill appears to do what it says, but it performs destructive and persistent actions: it may delete .venv/node_modules directories and will edit and reload your LaunchAgent plist. Before running: (1) Inspect fix.sh yourself (it's included). (2) Let the script list candidate directories and only approve deletion if you understand which items will be removed — consider moving rather than deleting. (3) Verify the plist backup ($PLIST.bak.<timestamp>) exists before any change. (4) Be aware the script is macOS-only and assumes the 'openclaw' CLI is installed. (5) Note a minor robustness issue: rm -rf uses unquoted variables which can mishandle paths with spaces/newlines — consider running the script in a safe environment or adapting it to safely handle special characters. If unsure, manually follow the SKILL.md manual steps instead of the one-click script.
Capability Analysis
Type: OpenClaw Skill
Name: openclaw-gateway-fd-fix
Version: 1.0.0
The skill bundle is classified as suspicious due to the use of high-risk system modification commands in `fix.sh`. Specifically, the script uses `sed -i` to modify the `ai.openclaw.gateway.plist` LaunchAgent configuration file, `rm -rf` to delete directories within the user's workspace (even with user confirmation), and `launchctl` to manage system services. While these actions are aligned with the stated purpose of fixing file descriptor exhaustion for the OpenClaw Gateway, they represent powerful capabilities that could be abused, fitting the criteria of 'risky capabilities without clear malicious intent'.
Capability Assessment
Purpose & Capability
The skill claims to detect and repair FD exhaustion for the OpenClaw Gateway on macOS. The included fix.sh finds large dependency directories in ~/.openclaw/workspace, optionally deletes them, updates the user's LaunchAgent plist to raise NumberOfFiles, and restarts the gateway—these actions align with the stated goal.
Instruction Scope
Instructions are narrowly focused on the gateway issue and reference only workspace, the LaunchAgent plist, and gateway commands. They do perform destructive actions (rm -rf of .venv/node_modules) and modify ~/Library/LaunchAgents/ai.openclaw.gateway.plist then restart the service. The script prompts for confirmation before deletion and backs up the plist. Minor safety issues: some variables used with rm -rf are unquoted (possible word-splitting/edge-case deletion problems), and the script assumes the presence of 'openclaw' and macOS tools.
Install Mechanism
No install spec; the skill is instruction-only with an included shell script. Nothing is downloaded or installed automatically.
Credentials
The skill requests no environment variables, credentials, or unrelated config paths. It only touches user-owned files under $HOME, which are relevant to the task.
Persistence & Privilege
The script modifies the user's LaunchAgent plist and uses launchctl to unload/load the agent (user-level service changes). This is expected for changing FD limits, but it is a persistent change to user service configuration and requires user consent; there is no 'always: true' privilege escalation.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install openclaw-gateway-fd-fix - After installation, invoke the skill by name or use
/openclaw-gateway-fd-fix - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release: provides one-click detection and repair for OpenClaw Gateway file descriptor exhaustion issues.
- Automatically handles removal of large/dependency directories from workspace (.venv, node_modules).
- Sets LaunchAgent file descriptor limits to prevent "EMFILE" and "spawn EBADF" errors.
- Includes full instructions for manual troubleshooting and verification.
- Addresses the most common OpenClaw Gateway crash related to too many open files in workspace.
Metadata
Frequently Asked Questions
What is Openclaw Gateway Fd Fix?
Fix OpenClaw Gateway "spawn EBADF" / "RPC probe failed" / "EMFILE too many open files" errors caused by file descriptor exhaustion from too many files in wor... It is an AI Agent Skill for Claude Code / OpenClaw, with 626 downloads so far.
How do I install Openclaw Gateway Fd Fix?
Run "/install openclaw-gateway-fd-fix" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Openclaw Gateway Fd Fix free?
Yes, Openclaw Gateway Fd Fix is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Openclaw Gateway Fd Fix support?
Openclaw Gateway Fd Fix is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Openclaw Gateway Fd Fix?
It is built and maintained by Jian Zhang (@thomaszhang2661); the current version is v1.0.0.
More Skills