A one-click tool to configure OpenClaw subagent and tool call timeouts atomically with built-in validation and auto-backups.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install subagent-timeout-config
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 subagent-timeout-config 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 Subagent Timeout Config?
The subagent-timeout-config tool solves a common headache when working with Openclaw Skills: managing complex, nested timeout variables across different parts of your runtime. OpenClaw timeouts are traditionally split across three independent fields that must stay synchronized to prevent sessions from closing prematurely. This skill provides an atomic, single-command solution to update these parameters safely without manual JSON editing.
By packaging pre-configured optimization profiles, this skill ensures that large refactoring jobs, deep analysis, and extensive multi-agent sessions do not die halfway through execution. It includes defensive programming mechanisms like pre-flight validation, automatic historical backups, and atomic file replacements to safeguard your existing agent configuration.
Subagent Timeout Config Use Cases
- Preventing subagents from timing out during massive codebase refactors or long-running tasks.
- Setting up fast feedback loops with tight timeout bounds for interactive debugging sessions.
- Safely modifying your OpenClaw runtime configurations without accidentally corrupting your main JSON file.
- Automating agent configuration adjustments via custom CI/CD or CLI development pipelines.
How Subagent Timeout Config Works
- The developer or agent invokes the script specifying a preset profile (such as quick, normal, or patient) or providing custom values.
- The script executes built-in constraint validation to ensure that the TTL session runtime satisfies the target subagent execution limits.
- A time-stamped backup of the existing
openclaw.jsonfile is compiled and saved automatically to prevent data loss. - Changes are written to a temporary configuration file before being atomically renamed to replace the active setup.
- The tool automatically signals the gateway to restart, applying the new timeout values instantly to active Openclaw Skills.
Subagent Timeout Config Setup
Ensure you have Python 3.8+ installed. No external pip dependencies are required.
Verify Configuration and Status
python3 scripts/set_timeout.py --status
List Available Profiles
python3 scripts/set_timeout.py --list
Apply the Everyday Development Profile
python3 scripts/set_timeout.py --profile normal
Subagent Timeout Config Data Schema & Taxonomy
The skill manages configuration mappings directly inside OpenClaw configuration profiles. It modifies and aligns three vital fields:
| Field Name | Config JSON Path | Description |
|---|---|---|
timeoutSeconds |
agents.defaults.timeoutSeconds |
Configures the maximum duration allowed for individual tool calls. |
runTimeoutSeconds |
agents.defaults.subagents.runTimeoutSeconds |
Dictates the overall budget allocated per subagent task execution. |
ttlMinutes |
acp.runtime.ttlMinutes |
Defines the actual ACP session lifetime parameters. |
Backups and State Management
- Target Configuration File:
~/.openclaw/openclaw.json(Customizable via--configorOPENCLAW_CONFIG). - Backup Format: Written to
<config>.bak.<YYYYMMDD-HHMMSS>prior to any system updates.
Subagent Timeout Config Advanced Features
- Dry Run Preview Mode: Use
--dry-runto validate changes and review structural diff comparisons before writing modifications to disk. - Atomic Write Safety: Utilizes
.tmpfile compilation and rename actions to guarantee your configuration never ends up partially corrupted during an unexpected crash. - Gateway Restart Opt-Out: Supports a
--no-restartflag to defer standard gateway reboots when you are in the middle of active agent work. - Custom Profiles: Allows user-defined values passed directly through the
--customparameter for granular development environments.
SKILL.md
Loading
Related Openclaw Skills
Inquiry Transcript Generator Basic
An advanced AI-powered assistant designed to analyze case details, extract personnel data, and generate legally structured, logically consistent inquiry transcripts.
Sleep Quality Coach
An evidence-based sleep behavior coach that uses Cognitive Behavioral Therapy for Insomnia (CBT-I) to build customized 7-day sleep recovery plans.
ai-fun-tv-image
An automated AI image generation skill that interfaces with ai.fun.tv to create projects, execute text-to-image tasks, poll execution states, and manage secure JWT credentials.
OMIE Energy (Portugal / Spain)
An Openclaw skill to fetch day-ahead electricity prices for Portugal and Spain, optimize high-power appliance runs, and trigger smart home integrations based on threshold rates.
copy-my-profile
Extract a standardized cross-tool user profile from any AI agent's long-term memory so you can re-use it in another AI tool without retraining.
My Skill
A comprehensive demonstration skill designed to streamline automated publishing, version management, and changelog tracking on the ClawHub platform.
Featured*
