config-safe

What This Skill Does

The config-safe skill is a critical tool for OpenClaw users who need to perform administrative tasks on their Gateway configuration. It acts as a safety layer, preventing common configuration errors that could lead to Gateway downtime. By mandating a workflow involving reading official documentation, validating against JSON Schemas, and requiring explicit user confirmation before any write operation, it ensures that your system configuration remains stable and valid. It transforms manual, error-prone configuration editing into a structured, safe process.

Installation

To add this skill to your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/glfruit/config-safe

Use Cases

• Safe Feature Enablement: Safely enable or configure communication channels like Telegram or Discord without risking syntax errors.
• Agent Identity Management: Update agent names, emojis, or personality settings while ensuring the change adheres to the system's schema requirements.
• Sandbox Configuration: Adjust security and sandbox policies (such as scope or mode) to match your current development needs without manual file tampering.
• Configuration Audits: Using the read-only functions to verify current settings against the latest official docs.

Example Prompts

1. "修改配置，把 Telegram 频道设置为启用状态，并配置好我的 Bot Token。"
2. "config，我想把主 Agent 的名字改成 Samantha，图标设为 🦥。"
3. "设置 openclaw，将沙箱模式改为所有权限，作用域限制在会话级别。"

Tips & Limitations

• Always Read Documentation First: Even if you are an expert, configuration schemas evolve. Always check the files in /opt/homebrew/lib/node_modules/openclaw/docs/gateway/ to see the latest parameters.
• Respect the Hash: The baseHash is essential for consistency. If you receive a hash mismatch error, re-fetch the current configuration before retrying.
• Don't Bypass Confirmation: The skill is designed to prevent "blind" edits. If you force an apply without checking the preview, you accept the risk of a potential system crash.
• Emergency Recovery: If the system fails to start after an update, use openclaw doctor immediately; do not try to manually force-patch the file until you have diagnosed the syntax issue.