supervisor-config-gen is a zero-flag bash utility that generates a Supervisor program config from the current app directory using a required run.sh entrypoint.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install supervisor-config-gen
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install supervisor-config-gen using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is supervisor-config-gen?
supervisor-config-gen is a lightweight bash tool designed to turn an application directory into a ready-to-use Supervisor [program:*] configuration with no manual field entry. By running it inside a target app folder, Openclaw Skills can infer the program name, command, working directory, user, and log paths directly from the environment.
It is built for fast, repeatable generation of supervisord configs when an app already has a run.sh startup script. The output is a single local .conf file that can be reviewed, edited if needed, and then used to manage the app under Supervisor with standardized process, logging, and restart settings.
supervisor-config-gen Use Cases
- Generate a Supervisor config for a single app directory that already includes a
run.shentrypoint. - Quickly "supervisorize" an app without hand-writing
[program:*]boilerplate. - Create a predictable baseline config before customizing advanced Supervisor options manually.
- Standardize local deployment or process management workflows across app directories.
- Derive runtime paths and log locations automatically from the current working directory and user context.
- Produce a config file when you want a minimal, repeatable Openclaw Skills workflow with no CLI flags or environment variables.
How supervisor-config-gen Works
- Run the script from inside the target application directory.
- The tool reads ambient context only: current directory name, current path, current user, and the expected
run.shlocation. - It derives the Supervisor program name from the directory basename and sets
commandto<cwd>/run.shanddirectoryto<cwd>. - It constructs a
[program:<name>]Supervisor config with fixed defaults for process count, restart behavior, stop behavior, and log rotation. - It writes the generated file as
<dirname>-supervisor.confinto the current directory. - If a file with that name already exists, it is silently overwritten.
- You then review the generated config and, if necessary, hand-edit unsupported settings before loading it into supervisord.
supervisor-config-gen Setup
- Ensure the target app directory contains an executable
run.shentrypoint. - Make sure
bashis available on the system, since this Openclaw Skills tool is a bash script. - Run the generator from inside the app directory:
cd /path/to/app
supervisor-config-gen
- Confirm that a file named
<dirname>-supervisor.confwas created in the current directory. - Review the generated Supervisor config before using it with supervisord, especially the
command,user, and log paths. - If you need custom Supervisor options, edit the generated file manually after creation.
Notes:
- There are no CLI flags, args, or environment variables to configure.
- Existing output files with the same name are overwritten without prompting.
supervisor-config-gen Data Schema & Taxonomy
The generated artifact is a single Supervisor config file with a fixed naming and field taxonomy.
| Item | Schema / Source | Notes |
|---|---|---|
| Output file | <dirname>-supervisor.conf |
Written to the current working directory |
| Program section | [program:<dirname>] |
Derived from basename $(pwd) |
command |
<cwd>/run.sh |
Required entrypoint reference |
directory |
<cwd> |
Current directory at execution time |
process_name |
%(program_name)s |
Supervisor template token |
numprocs |
1 |
Hardcoded |
user |
$(whoami) |
Current invoking user |
stopsignal |
TERM |
Hardcoded |
stopwaitsecs |
10 |
Hardcoded |
stopasgroup |
true |
Hardcoded |
killasgroup |
true |
Hardcoded |
autostart |
true |
Hardcoded |
autorestart |
true |
Hardcoded |
redirect_stderr |
true |
Hardcoded |
redirect_stdout |
true |
Hardcoded |
stdout_logfile |
$HOME/logs/supervisord/<program>-out.log |
Derived from user home and program name |
stderr_logfile |
$HOME/logs/supervisord/<program>-err.log |
Derived from user home and program name |
stdout_logfile_maxbytes |
50MB |
Hardcoded rotation limit |
stdout_logfile_backups |
10 |
Hardcoded retention |
stderr_logfile_maxbytes |
50MB |
Hardcoded rotation limit |
Metadata taxonomy used by Openclaw Skills:
- Scope: single-directory, single-invocation
- Input model: ambient filesystem and shell context only
- Output model: deterministic local file generation
- Mutability: overwrites existing output without prompting
- Configurability: none via flags; post-generation hand-editing only
supervisor-config-gen Advanced Features
- Zero-argument, zero-flag operation for extremely fast config generation.
- Deterministic output derived entirely from the current directory and invoking user.
- Opinionated Supervisor defaults for process lifecycle, restart policy, and log rotation.
- Automatic log path placement under
$HOME/logs/supervisord/for consistent per-user logging. - Built-in support for generating a reusable baseline that can be manually extended for custom Supervisor settings.
- Designed for simple app-directory workflows where Openclaw Skills can infer everything from context.
- Safe for local-only generation with no network calls or external service dependencies.
SKILL.md
Loading
Related Openclaw Skills
persistent-sshfs
persistent-sshfs is a Bash-based Openclaw Skills utility that retries SSHFS mounts until they connect, then relies on sshfs reconnect for transient drop recovery.
Deep Learner Thinking Adapter
Openclaw Skills adapts AI explanations for first-principles learners, starting at step zero with clear reasoning, analogies, and guess validation.
Schedulala Social Publishing Skill
Openclaw Skills for Schedulala automate social post creation, validation, scheduling, publishing, and monitoring across 12 platforms.
SandBase MCP Setup and Verification
SandBase Openclaw Skills helps you safely connect, configure, and verify the SandBase MCP server in supported AI clients without exposing secrets.
WorkBuddy Workspace Relay
Openclaw Skills for securely packaging a WorkBuddy workspace into an encrypted handoff file and restoring it on another machine to continue development.
Strong Mindset
Openclaw Skills for Strong Mindset turns doubt, friction, and criticism into actionable 24-hour next steps, structured evaluations, and style-aligned writing support.
Featured*
