Safe Config Modifier for Openclaw

A standardized workflow tool for the safe, validated, and backed-up modification of OpenClaw configuration files.

justaboyhai-wq
v1.0.0
Mar 8, 2026
0
1.1k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install safe-config

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install safe-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 Safe Config Modifier?

Safe Config Modifier is a specialized utility designed to handle sensitive updates to the ~/.openclaw/openclaw.json file. It ensures that every configuration change—from switching LLM models to configuring communication channels—is performed through a fail-safe, standardized process. By integrating these Openclaw Skills into your workflow, you prevent service outages caused by malformed JSON or accidental credential exposure.

The skill prioritizes security and system stability by enforcing data sanitization and strict user confirmation protocols. It automatically masks sensitive keys such as API tokens and passwords during previews, providing a transparent yet secure environment for administrative tasks.

Safe Config Modifier Use Cases

  • Switching primary or fallback AI models within the OpenClaw environment.
  • Configuring new communication channels like Telegram or Slack with secure bot tokens.
  • Managing tool settings and search provider configurations safely.
  • Installing and enabling new plugins or Openclaw Skills while maintaining configuration integrity.
  • Performing bulk updates to model provider endpoints and context window settings.

How Safe Config Modifier Works

  1. The skill reads the current JSON configuration to identify the specific fields targeted for modification.
  2. It runs a sanitization script to mask sensitive data like apiKeys and tokens before displaying any output.
  3. A local validation check is performed using jq and internal scripts to ensure the proposed JSON syntax is valid.
  4. The system presents the proposed changes to the user and waits for a specific confirmation phrase: "ojbk可以改了".
  5. Upon confirmation, the skill creates a timestamped backup of the current openclaw.json file.
  6. The new configuration is written to the file, and the OpenClaw gateway is optionally restarted to apply changes.

Safe Config Modifier Setup

To begin using these configuration-focused Openclaw Skills, ensure you have the necessary scripts in your local directory:

# Navigate to the safe-config skill directory
cd ~/.openclaw/skills/safe-config

# Ensure scripts are executable
chmod +x scripts/*.sh

# Run the preview script to verify your current environment
./scripts/preview.sh

Safe Config Modifier Data Schema & Taxonomy

The skill manages the core configuration schema of OpenClaw. Data is organized into the following primary categories within the JSON structure:

Section Key Path Purpose
Agents .agents.defaults Configures default models and agent behaviors.
Models .models.providers Manages API keys, base URLs, and model specifications.
Channels .channels Defines settings for Telegram, Discord, and other integrations.
Tools .tools Enables and configures external search and processing tools.

Safe Config Modifier Advanced Features

  • Automatic sanitization of sensitive fields including apiKey, token, password, and secret.
  • Mandatory backup creation before any write operation to facilitate instant rollbacks.
  • Strict confirmation logic requiring a specific passphrase to prevent accidental automation triggers.
  • Integration with jq for precise, path-based JSON manipulation within the Openclaw Skills framework.
  • Post-update verification checks to confirm Gateway status and JSON integrity.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*