{
  "schemaVersion": "1.0",
  "item": {
    "slug": "openclaw-config-guide",
    "name": "OpenClaw配置管理最佳实践",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/JackTian010105/openclaw-config-guide",
    "canonicalUrl": "https://clawhub.ai/JackTian010105/openclaw-config-guide",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/openclaw-config-guide",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-config-guide",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "references/common-paths.md",
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/openclaw-config-guide"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/openclaw-config-guide",
    "agentPageUrl": "https://openagent3.xyz/skills/openclaw-config-guide/agent",
    "manifestUrl": "https://openagent3.xyz/skills/openclaw-config-guide/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/openclaw-config-guide/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "OpenClaw 配置管理指南",
        "body": "本技能提供 OpenClaw 配置管理的最佳实践，帮助避免常见错误。"
      },
      {
        "title": "⚠️ 黄金法则",
        "body": "永远不要用 write 或 edit 直接修改配置文件！\n\n❌ 错误方式：\n\n直接编辑 ~/.openclaw/openclaw.json\n猜测配置路径（如 plugins.entries.discord.botToken）\n裸写 JSON 没有验证\n\n✅ 正确方式：\n\n使用 gateway config.get 查看当前配置\n使用 gateway config.patch 做增量修改\n修改后用 gateway config.get 验证"
      },
      {
        "title": "📋 配置前检查清单",
        "body": "每次修改配置前，按此顺序执行：\n\n读取现有配置\ngateway config.get\n\n目的：确认当前结构，避免猜测路径\n\n\n确认正确路径\n参考 references/common-paths.md 查找正确的配置项路径\n原则：不确定时，宁可多看一眼，不要盲猜\n\n\n使用 patch 修改\ngateway config.patch\n{\n  \"channels\": {\n    \"discord\": {\n      \"enabled\": true,\n      \"token\": \"YOUR_TOKEN\"\n    }\n  }\n}\n\n\n\n验证修改结果\ngateway config.get\n\n确认修改生效，无语法错误"
      },
      {
        "title": "错误 1：Discord Token 路径错误",
        "body": "// ❌ 错误路径\n{\n  \"plugins\": {\n    \"entries\": {\n      \"discord\": {\n        \"botToken\": \"xxx\"  // 错误！\n      }\n    }\n  }\n}\n\n// ✅ 正确路径\n{\n  \"channels\": {\n    \"discord\": {\n      \"token\": \"xxx\"  // 正确！\n    }\n  }\n}"
      },
      {
        "title": "错误 2：直接覆盖整个配置",
        "body": "// ❌ 危险！会丢失其他所有配置\ngateway config.apply\n{ ...新配置... }\n\n// ✅ 安全！只修改指定部分\ngateway config.patch\n{ ...部分配置... }"
      },
      {
        "title": "📚 参考资源",
        "body": "配置路径速查表: 见 references/common-paths.md\n\n包含常用配置项的正确路径\nProvider 配置路径\nChannel 配置路径\nAgent 默认配置路径"
      },
      {
        "title": "🛠️ 配置管理命令",
        "body": "命令用途gateway config.get查看当前完整配置gateway config.patch增量修改配置（推荐）gateway config.apply完全替换配置（危险）gateway config.schema查看配置 JSON Schema"
      },
      {
        "title": "💡 最佳实践总结",
        "body": "先读后写 - 永远不要假设配置结构\n用 patch 不用 apply - 避免意外覆盖\n验证闭环 - 修改后必须验证\n参考速查表 - 不确定路径时查 common-paths.md\n不要猜测 - 看到实际配置再动手\n\n记住：配置错误会导致 OpenClaw 无法启动，务必谨慎！"
      }
    ],
    "body": "OpenClaw 配置管理指南\n\n本技能提供 OpenClaw 配置管理的最佳实践，帮助避免常见错误。\n\n⚠️ 黄金法则\n\n永远不要用 write 或 edit 直接修改配置文件！\n\n❌ 错误方式：\n\n直接编辑 ~/.openclaw/openclaw.json\n猜测配置路径（如 plugins.entries.discord.botToken）\n裸写 JSON 没有验证\n\n✅ 正确方式：\n\n使用 gateway config.get 查看当前配置\n使用 gateway config.patch 做增量修改\n修改后用 gateway config.get 验证\n📋 配置前检查清单\n\n每次修改配置前，按此顺序执行：\n\n读取现有配置\n\ngateway config.get\n\n\n目的：确认当前结构，避免猜测路径\n\n确认正确路径 参考 references/common-paths.md 查找正确的配置项路径 原则：不确定时，宁可多看一眼，不要盲猜\n\n使用 patch 修改\n\ngateway config.patch\n{\n  \"channels\": {\n    \"discord\": {\n      \"enabled\": true,\n      \"token\": \"YOUR_TOKEN\"\n    }\n  }\n}\n\n\n验证修改结果\n\ngateway config.get\n\n\n确认修改生效，无语法错误\n\n🔥 常见错误案例\n错误 1：Discord Token 路径错误\n// ❌ 错误路径\n{\n  \"plugins\": {\n    \"entries\": {\n      \"discord\": {\n        \"botToken\": \"xxx\"  // 错误！\n      }\n    }\n  }\n}\n\n// ✅ 正确路径\n{\n  \"channels\": {\n    \"discord\": {\n      \"token\": \"xxx\"  // 正确！\n    }\n  }\n}\n\n错误 2：直接覆盖整个配置\n// ❌ 危险！会丢失其他所有配置\ngateway config.apply\n{ ...新配置... }\n\n// ✅ 安全！只修改指定部分\ngateway config.patch\n{ ...部分配置... }\n\n📚 参考资源\n配置路径速查表: 见 references/common-paths.md\n包含常用配置项的正确路径\nProvider 配置路径\nChannel 配置路径\nAgent 默认配置路径\n🛠️ 配置管理命令\n命令\t用途\ngateway config.get\t查看当前完整配置\ngateway config.patch\t增量修改配置（推荐）\ngateway config.apply\t完全替换配置（危险）\ngateway config.schema\t查看配置 JSON Schema\n💡 最佳实践总结\n先读后写 - 永远不要假设配置结构\n用 patch 不用 apply - 避免意外覆盖\n验证闭环 - 修改后必须验证\n参考速查表 - 不确定路径时查 common-paths.md\n不要猜测 - 看到实际配置再动手\n\n记住：配置错误会导致 OpenClaw 无法启动，务必谨慎！"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/JackTian010105/openclaw-config-guide",
    "publisherUrl": "https://clawhub.ai/JackTian010105/openclaw-config-guide",
    "owner": "JackTian010105",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/openclaw-config-guide",
    "downloadUrl": "https://openagent3.xyz/downloads/openclaw-config-guide",
    "agentUrl": "https://openagent3.xyz/skills/openclaw-config-guide/agent",
    "manifestUrl": "https://openagent3.xyz/skills/openclaw-config-guide/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/openclaw-config-guide/agent.md"
  }
}