openclaw-settings

Configure OpenClaw runtime behavior via a centralized openclaw.json file.

4|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/oabdelmaksoud/Openclaw-skills-Compilations --skill openclaw-settings
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openclaw-settings
Source: https://github.com/oabdelmaksoud/Openclaw-skills-Compilations/tree/main/openclaw-settings
Command: npx skills add https://github.com/oabdelmaksoud/Openclaw-skills-Compilations --skill openclaw-settings

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Centralizes and stabilizes OpenClaw configuration across agents, providers, and crons, reducing misconfigurations and drift.

Core Features & Use Cases

  • Central configuration file located at ~/.openclaw/openclaw.json that governs agents, models, providers, gateway, crons, skills, plugins, and subagents.
  • Per-agent defaults and per-skill settings are read from the shared configuration to customize behavior per installation.
  • Guidance for secure handling of secrets via per-agent auth-profiles.json and best practices for key management and validation.

Quick Start

Update your ~/.openclaw/openclaw.json with your desired settings and restart the gateway to apply changes.

Frequently Asked Questions about openclaw-settings

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure multi-agent deployments in OpenClaw?

Set per-agent defaults and gateway rules in the centralized ~/.openclaw/openclaw.json configuration file. This structured JSON schema governs agents, models, providers, and skills to ensure safe, auditable multi-agent operation.

What is the best way to manage provider settings and gateway rules for AI agents?

Define provider integration and gateway rules inside the openclaw.json configuration file. This structured JSON schema centralizes settings to reduce misconfigurations and configuration drift across multiple agents.

How do I securely handle API keys and secrets for OpenClaw providers?

Handle secrets securely using per-agent auth-profiles.json files rather than embedding them in openclaw.json. This enforces best practices for key management and validation while keeping runtime configuration safe and auditable.

Can I set per-skill configuration entries for specific agents?

Yes, you can define per-skill entries within the openclaw.json configuration. The shared configuration file reads per-skill settings alongside per-agent defaults to customize runtime behavior for each installation.

How do I apply changes to OpenClaw runtime settings after updating the configuration?

Update your ~/.openclaw/openclaw.json file with the desired settings and restart the gateway to apply changes. The restart loads the new configuration for agents, crons, plugins, and gateway rules.

What configuration sections are required in openclaw.json for safe operation?

The openclaw.json schema enforces structured sections for agents, models, providers, gateway, crons, plugins, and skills. Defining these sections ensures safe, auditable operation across multi-agent deployments.