Tencent SkillHub · Developer Tools

OpenClaw配置管理最佳实践

OpenClaw configuration management best practices and common pitfalls. Use when: (1) User needs to modify OpenClaw configuration, (2) User asks about config paths or structure, (3) User encountered config errors, (4) Adding new providers or channels, (5) Before making any config changes - to avoid common mistakes like wrong paths or direct JSON editing.

skill openclawclawhub Free

0 Downloads

0 Stars

0 Installs

0 Score

High Signal

⬇ 0 downloads ★ 0 stars Unverified but indexed

Install for OpenClaw

Quick setup

Download the package from Yavira.
Extract the archive and review SKILL.md first.
Import or place the package into your OpenClaw setup.

Requirements

Target platform: OpenClaw
Install method: Manual import
Extraction: Extract archive
Prerequisites: OpenClaw
Primary doc: SKILL.md

Package facts

Download mode: Yavira redirect
Package format: ZIP package
Source platform: Tencent SkillHub
What's included: references/common-paths.md, SKILL.md

Validation

Use the Yavira download entry.
Review SKILL.md after the package is downloaded.
Confirm the extracted package contains the expected setup assets.

Install with your agent

Agent handoff

Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.

Download the package from Yavira.
Extract it into a folder your agent can access.
Paste one of the prompts below and point your agent at the extracted folder.

New install

I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.

Upgrade existing

I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.

Open Send to Agent page Open JSON manifest Open Markdown brief

Trust & source

Release facts

Source: Tencent SkillHub
Verification: Indexed source record
Version: 1.0.0

Provenance

Publisher: JackTian010105
Source page: View original listing
Canonical URL: Open canonical page

Documentation

ClawHub primary doc Primary doc: SKILL.md 8 sections Open source page

OpenClaw 配置管理指南

本技能提供 OpenClaw 配置管理的最佳实践，帮助避免常见错误。

⚠️ 黄金法则

永远不要用 write 或 edit 直接修改配置文件！ ❌ 错误方式：直接编辑 ~/.openclaw/openclaw.json 猜测配置路径（如 plugins.entries.discord.botToken）裸写 JSON 没有验证 ✅ 正确方式：使用 gateway config.get 查看当前配置使用 gateway config.patch 做增量修改修改后用 gateway config.get 验证

📋 配置前检查清单

每次修改配置前，按此顺序执行：读取现有配置 gateway config.get 目的：确认当前结构，避免猜测路径确认正确路径参考 references/common-paths.md 查找正确的配置项路径原则：不确定时，宁可多看一眼，不要盲猜使用 patch 修改 gateway config.patch { "channels": { "discord": { "enabled": true, "token": "YOUR_TOKEN" } } } 验证修改结果 gateway config.get 确认修改生效，无语法错误

错误 1：Discord Token 路径错误

// ❌ 错误路径 { "plugins": { "entries": { "discord": { "botToken": "xxx" // 错误！ } } } } // ✅ 正确路径 { "channels": { "discord": { "token": "xxx" // 正确！ } } }

错误 2：直接覆盖整个配置

// ❌ 危险！会丢失其他所有配置 gateway config.apply { ...新配置... } // ✅ 安全！只修改指定部分 gateway config.patch { ...部分配置... }

📚 参考资源

配置路径速查表: 见 references/common-paths.md 包含常用配置项的正确路径 Provider 配置路径 Channel 配置路径 Agent 默认配置路径

🛠️ 配置管理命令

命令用途gateway config.get查看当前完整配置gateway config.patch增量修改配置（推荐）gateway config.apply完全替换配置（危险）gateway config.schema查看配置 JSON Schema

💡 最佳实践总结

先读后写 - 永远不要假设配置结构用 patch 不用 apply - 避免意外覆盖验证闭环 - 修改后必须验证参考速查表 - 不确定路径时查 common-paths.md 不要猜测 - 看到实际配置再动手记住：配置错误会导致 OpenClaw 无法启动，务必谨慎！

Category context

Code helpers, APIs, CLIs, browser automation, testing, and developer operations.

Source: Tencent SkillHub

Largest current source with strong distribution and engagement signals.

Package contents

Included in package

2 Docs

SKILL.md Primary doc
references/common-paths.md Docs