← Back to Skills Marketplace
385
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install openclaw-tmux-persistent-process
Description
Run programs that survive OpenClaw exec session cleanup and gateway restarts via tmux. Use when you need long-running servers, dev servers, tunnels (ngrok/cl...
Usage Guidance
This skill is basically a how-to for running tmux-based persistent processes and is coherent with that goal. Before installing/use: 1) Ensure tmux 2.6+ is available (the registry metadata should list tmux as a required binary — consider updating that). 2) Prefer a per-user socket path (for example under /run/user/$UID or a directory you own) or make sure /tmp/openclaw-tmux is created with restrictive ownership/permissions to avoid local symlink/TOCTOU attacks; /tmp is world-writable and can be abused if other users exist. 3) Be aware that processes started in tmux will persist across gateway restarts and can expose network endpoints (ngrok/ssh tunnels) — only run commands you trust. 4) Avoid embedding long-lived secrets on command lines (they may be visible in process listings or shell history); instead inject secrets into session environments securely. 5) The skill’s examples assume binaries like ngrok, ssh, npm, node exist; install those separately as needed. If you need tighter security, require the skill metadata to declare tmux as a required binary and change the socket location to a per-user path.
Capability Analysis
Type: OpenClaw Skill
Name: openclaw-tmux-persistent-process
Version: 1.0.0
The skill provides utility instructions and code snippets for using tmux to manage long-running background processes (e.g., dev servers, tunnels) that survive OpenClaw session cleanups. It uses a dedicated socket (/tmp/openclaw-tmux/openclaw.sock) to avoid conflicts and follows standard practices for process management without any signs of malicious intent, data exfiltration, or unauthorized persistence.
Capability Assessment
Purpose & Capability
The SKILL.md clearly documents using tmux to keep long-lived processes running. Registry metadata lists no required binaries, but the instructions explicitly require tmux 2.6+ — a small mismatch. Otherwise the commands and guidance align with the stated purpose (dev servers, tunnels, workers).
Instruction Scope
All runtime instructions are limited to managing tmux sessions (create, list, capture-pane, send-keys, kill-session/kill-server) and using a dedicated socket. Tunnel examples (ngrok, ssh -R) are expected for the use-cases. The instructions do not ask the agent to read unrelated files, other env vars, or to exfiltrate data.
Install Mechanism
This is instruction-only (no install spec, no code written to disk), which is low-risk. The SKILL.md suggests how to install tmux via package managers, which is appropriate.
Credentials
The skill requests no environment variables or credentials. It notes that tmux inherits the environment at creation time and shows how to set env vars for sessions — appropriate for the purpose. There is no unnecessary request for unrelated secrets.
Persistence & Privilege
The skill is not force-enabled (always: false) and does not request persistent platform privileges. Its guidance intentionally creates long-lived processes, which is the intended behavior and not a platform privilege escalation.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install openclaw-tmux-persistent-process - After installation, invoke the skill by name or use
/openclaw-tmux-persistent-process - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: run long-lived processes in tmux that survive OpenClaw exec cleanup and gateway restarts. Explains why every OpenClaw user needs this for tunnels, dev servers, and long tasks.
Metadata
Frequently Asked Questions
What is OpenClaw Tmux Persistent Process?
Run programs that survive OpenClaw exec session cleanup and gateway restarts via tmux. Use when you need long-running servers, dev servers, tunnels (ngrok/cl... It is an AI Agent Skill for Claude Code / OpenClaw, with 385 downloads so far.
How do I install OpenClaw Tmux Persistent Process?
Run "/install openclaw-tmux-persistent-process" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is OpenClaw Tmux Persistent Process free?
Yes, OpenClaw Tmux Persistent Process is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does OpenClaw Tmux Persistent Process support?
OpenClaw Tmux Persistent Process is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created OpenClaw Tmux Persistent Process?
It is built and maintained by Joey Luo (@darwin7381); the current version is v1.0.0.
More Skills