A specialized tool for safely editing and validating OpenClaw Gateway configuration files using a strict, schema-first workflow.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install openclaw-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 openclaw-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 OpenClaw Config Manager?
The OpenClaw Config Manager is a vital utility designed to maintain the integrity of your openclaw.json or JSON5 configuration files. By providing a structured way to manage keys for gateways, agents, models, and tools, it ensures that your environment remains stable and secure. This skill is essential for developers working with Openclaw Skills who need to perform precise updates without risking schema mismatches that could prevent the gateway from starting.
Built with a focus on reliability, the skill allows for granular control over every aspect of the system. Whether you are adjusting security policies or adding new provider configurations, the OpenClaw Config Manager acts as a safeguard, ensuring that every change is validated against the authoritative schema before being applied.
OpenClaw Config Manager Use Cases
- Updating core gateway settings like port numbers and default workspace locations.
- Configuring external communication channels such as Telegram, Discord, or Matrix with strict policy enforcement.
- Enabling and managing API keys for integrated search tools like Brave or Perplexity.
- Resolving configuration errors identified by the system doctor during startup diagnostics.
- Organizing complex environments by splitting large configurations into smaller, modular files.
How OpenClaw Config Manager Works
- The skill identifies the active configuration file path based on environment variables or default system locations.
- It retrieves the authoritative JSON schema from the running gateway or source repository to prevent incorrect key usage.
- Small, safe edits are performed using get, set, or unset operations to minimize the risk of file corruption.
- For live systems, it utilizes RPC methods like config.patch to apply changes and restart the gateway in a single step.
- The integrated doctor utility runs a final validation check to ensure the new configuration adheres to all strict schema constraints.
OpenClaw Config Manager Setup
To begin managing your configuration, ensure your environment is initialized and run the following commands in your terminal:
# Check the current status of your configuration
openclaw doctor
# Set a specific configuration value, such as the gateway port
openclaw config set gateway.port 18789 --json
# Verify the changes are valid before restarting
openclaw doctor
OpenClaw Config Manager Data Schema & Taxonomy
The configuration is primarily managed in openclaw.json or openclaw.json5, which supports comments and trailing commas. The data is organized into the following primary sections:
| Section | Description |
|---|---|
gateway |
Global server settings including ports and security protocols. |
agents |
Definitions for agent behavior, defaults, and workspace settings. |
channels |
Integration settings for platforms like Telegram, Discord, and Slack. |
tools |
Configuration for external capabilities like web search or data processing. |
$include |
A special key for modularizing configuration across multiple files. |
OpenClaw Config Manager Advanced Features
- Modular configuration support via the $include directive, allowing for recursive file merging up to 10 levels deep.
- Live RPC patching using config.patch and config.apply for seamless updates to running Openclaw Skills without manual restarts.
- Strict schema enforcement that prevents the use of unknown keys, protecting the system from configuration-driven bugs.
- Intelligent environment variable fallback for secrets and API keys to keep sensitive data out of plain-text config files.
- Support for JSON5 to improve human-readability with comments and more flexible syntax.
SKILL.md
Loading
Related Openclaw Skills
Codehooks Backend
Enable your AI agent to deploy and manage serverless backends, REST APIs, and persistent NoSQL storage autonomously.
cancorteaw-app
A secure and controlled runner for scaffolding, developing, and previewing Expo/React Native applications directly within your environment.
Wiz Light Control
A local network integration that enables AI agents to control physical Wiz smart bulbs through Python-based CLI commands.
Claw Browser
A visual, human-like web browser skill that gives AI agents the ability to render JavaScript and capture screenshots.
AI News Poster
An automated tool to transform five AI news headlines into a professionally designed, fixed-template social media poster.
Structure Thinking Skill
A high-impact skill for AI agents to transform messy, multi-factor problems into actionable decision paths using system mapping and hierarchical logic.
Featured*
