← Back to Skills Marketplace
143
Downloads
1
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install openclaw-gateway-linux-fix
Description
Fix and diagnose OpenClaw Gateway service issues on Linux. Use when the gateway service shows "disabled" status despite running, when `openclaw gateway statu...
Usage Guidance
This is an instruction-only troubleshooting guide that is coherent with its purpose, but it performs system configuration changes — back up the unit file before editing (cp ~/.config/systemd/user/openclaw-gateway.service{,.bak}), inspect the proposed python one-liner first, and run commands interactively rather than blindly. Note that writing to /etc/profile.d and enabling linger may require root privileges. Verify the openclaw cron job target (Telegram chat ID) and the permissions of the openclaw CLI on your system before scheduling messages. The absence of scanner findings only means there was no code to statically analyze; it does not replace careful review and testing in a non-production environment.
Capability Analysis
Type: OpenClaw Skill
Name: openclaw-gateway-linux-fix
Version: 1.1.1
The skill bundle provides legitimate diagnostic and repair steps for the OpenClaw Gateway service on Linux, addressing environment variable issues in systemd user units and providing a workaround for process termination during restarts. It uses standard system administration techniques (Python regex for file editing, loginctl for persistence) and lacks any indicators of malicious intent or data exfiltration. All actions are transparently documented in SKILL.md and references/diagnosis.md.
Capability Assessment
Purpose & Capability
The name/description (OpenClaw Gateway Linux fixes) matches the actions in SKILL.md: editing the user systemd unit, reloading systemd, enabling linger, scheduling cron jobs via the OpenClaw CLI, and setting XDG_RUNTIME_DIR/DBUS env vars. No unrelated credentials, binaries, or network endpoints are requested.
Instruction Scope
Instructions operate on expected paths (~/.config/systemd/user/openclaw-gateway.service, /etc/profile.d, /tmp) and use systemctl, loginctl and the openclaw CLI. They do modify unit files and add env exports; this is within scope but is privileged/system configuration work. Minor scope issues: the python one‑liner assumes the unit file exists and doesn't robustly check errors; the skill instructs scheduling a cron job that will post to Telegram via the gateway (which is expected but worth verifying your openclaw cron permissions and destination ID).
Install Mechanism
Instruction-only skill with no install spec and no code files; nothing will be downloaded or written by an installer. Risk surface is limited to commands the operator runs locally.
Credentials
No environment variables, credentials, or config paths are declared/required beyond the XDG_RUNTIME_DIR/DBUS vars that the skill explicitly adds to the systemd unit and shell profiles. Requesting those variables is proportional to fixing systemd user-bus reachability.
Persistence & Privilege
Skill does not request persistent or platform-wide privileges (always:false). It instructs editing user unit files and /etc/profile.d (the latter requires root), which is appropriate for the stated fixes but requires caution and appropriate privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install openclaw-gateway-linux-fix - After installation, invoke the skill by name or use
/openclaw-gateway-linux-fix - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.1
Fix Issue 2: reorder steps (schedule cron before restart), add context passing via file, add What does NOT work section. Fix Issue 1: replace heredoc with python3 -c, use os.environ for safe path handling, remove broken sleep+status chain.
v1.1.0
Improved Issue 1 fix: replaced fragile sed one-liner with idempotent Python script. Added 'Why' column to shell escalation table. Fixed Quick check command in diagnosis.md (broken || chain). Clarified UID path detection in Step 2. Minor wording improvements throughout.
v1.0.0
Initial release of openclaw-gateway-linux-fix. Provides solutions for OpenClaw Gateway service showing 'disabled' on Linux, incorrect status reporting, and user/systemd environment variable issues. Documents the correct method to set XDG_RUNTIME_DIR and DBUS_SESSION_BUS_ADDRESS in the systemd unit file, not just in shell environments. Details a safe restart approach to prevent the gateway process from self-terminating its controlling shell. Addresses shell escalation issues and persistence of the service after reboot.
Metadata
Frequently Asked Questions
What is OpenClaw Gateway Linux Fix?
Fix and diagnose OpenClaw Gateway service issues on Linux. Use when the gateway service shows "disabled" status despite running, when `openclaw gateway statu... It is an AI Agent Skill for Claude Code / OpenClaw, with 143 downloads so far.
How do I install OpenClaw Gateway Linux Fix?
Run "/install openclaw-gateway-linux-fix" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is OpenClaw Gateway Linux Fix free?
Yes, OpenClaw Gateway Linux Fix is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does OpenClaw Gateway Linux Fix support?
OpenClaw Gateway Linux Fix is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created OpenClaw Gateway Linux Fix?
It is built and maintained by Maks (@maksmirnnov); the current version is v1.1.1.
More Skills