{
  "schemaVersion": "1.0",
  "item": {
    "slug": "config-validator-zh-cn",
    "name": "Config Validator",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/nicoxia/config-validator-zh-cn",
    "canonicalUrl": "https://clawhub.ai/nicoxia/config-validator-zh-cn",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/config-validator-zh-cn",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=config-validator-zh-cn",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "package.json",
      "quick-reference.md",
      "schema-agents.md",
      "schema-channels.md",
      "schema-gateway.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/config-validator-zh-cn"
    },
    "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/config-validator-zh-cn",
    "agentPageUrl": "https://openagent3.xyz/skills/config-validator-zh-cn/agent",
    "manifestUrl": "https://openagent3.xyz/skills/config-validator-zh-cn/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/config-validator-zh-cn/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": "用途",
        "body": "验证 OpenClaw 配置字段和值的有效性，提供完整的 schema 参考和有效值枚举。"
      },
      {
        "title": "✅ 推荐：修改配置前查阅（预防错误）",
        "body": "在思考如何修改配置时就先查阅本 Skill：\n\n确认字段是否存在\n确认有效值是什么\n查看配置示例\n避免写错配置"
      },
      {
        "title": "✅ 必须：修改配置后验证（兜底检查）",
        "body": "在safe-config-workflow 中自动调用验证：\n\n验证配置是否正确\ndoctor --fix 兜底修复"
      },
      {
        "title": "触发条件",
        "body": "当用户需要：\n\n确认某个配置字段是否存在\n查询某个字段的有效值\n验证配置是否正确\n查找配置示例\n修改配置前参考（推荐）"
      },
      {
        "title": "模块结构",
        "body": "本 Skill 按模块组织配置 schema：\n\n文件内容schema-channels.mdChannels 完整 schema（Telegram, WhatsApp, Discord, Slack...）schema-agents.mdAgents 完整 schema（defaults, list, heartbeat, sandbox...）schema-gateway.mdGateway 完整 schema（port, bind, auth, reload...）schema-session.mdSession 完整 schema（dmScope, identityLinks, reset...）schema-tools.mdTools 完整 schema（elevated, sandbox, allow/deny...）schema-models.mdModels 完整 schema（providers, fallbacks, aliases...）quick-reference.md常用字段快速参考（50 个核心字段）"
      },
      {
        "title": "1. 查询字段有效值",
        "body": "用户：telegram 的 streaming 字段有哪些有效值？\nAI: 查阅 schema-channels.md → 返回有效值"
      },
      {
        "title": "2. 验证配置",
        "body": "用户：这个配置对吗？{ \"channels\": { \"telegram\": { \"streaming\": \"on\" } } }\nAI: 查阅 schema-channels.md → 验证并反馈"
      },
      {
        "title": "3. 查找配置示例",
        "body": "用户：如何配置 Telegram 机器人？\nAI: 查阅 schema-channels.md → 返回示例配置"
      },
      {
        "title": "严格验证",
        "body": "字段必须存在于 schema 中\n值必须是枚举中的有效值\n类型必须匹配（string, number, boolean, object, array）"
      },
      {
        "title": "常见错误",
        "body": "错误类型示例正确值无效枚举值\"streaming\": \"on\"\"off\" | \"partial\" | \"block\" | \"progress\"无效类型\"port\": \"18789\"\"port\": 18789未知字段\"channels\": { \"wechat\": {} }不支持的渠道"
      },
      {
        "title": "与 Safe Config Workflow 的集成",
        "body": "本 Skill 被 safe-config-workflow 自动调用：\n\nsafe-config-workflow 修改配置\n    ↓\n自动调用 config-validator 验证字段\n    ↓\n验证通过 → 继续执行\n验证失败 → 反馈错误并停止"
      },
      {
        "title": "官方文档来源",
        "body": "所有 schema 信息来自官方文档：\n\nhttps://docs.openclaw.ai/gateway/configuration-reference\nhttps://docs.openclaw.ai/zh-CN/gateway/configuration"
      },
      {
        "title": "更新机制",
        "body": "当官方文档更新时：\n\n重新读取官方 configuration-reference.md\n更新对应的 schema 模块文件\n更新 quick-reference.md（如有变化）\n在 SKILL.md 中记录版本历史"
      },
      {
        "title": "版本历史",
        "body": "v1.0 (2026-02-26) — 初始版本，包含完整 schema 和模块分文件"
      }
    ],
    "body": "Config Validator Skill（配置验证器）\n用途\n\n验证 OpenClaw 配置字段和值的有效性，提供完整的 schema 参考和有效值枚举。\n\n使用时机\n✅ 推荐：修改配置前查阅（预防错误）\n\n在思考如何修改配置时就先查阅本 Skill：\n\n确认字段是否存在\n确认有效值是什么\n查看配置示例\n避免写错配置\n✅ 必须：修改配置后验证（兜底检查）\n\n在safe-config-workflow 中自动调用验证：\n\n验证配置是否正确\ndoctor --fix 兜底修复\n触发条件\n\n当用户需要：\n\n确认某个配置字段是否存在\n查询某个字段的有效值\n验证配置是否正确\n查找配置示例\n修改配置前参考（推荐）\n模块结构\n\n本 Skill 按模块组织配置 schema：\n\n文件\t内容\nschema-channels.md\tChannels 完整 schema（Telegram, WhatsApp, Discord, Slack...）\nschema-agents.md\tAgents 完整 schema（defaults, list, heartbeat, sandbox...）\nschema-gateway.md\tGateway 完整 schema（port, bind, auth, reload...）\nschema-session.md\tSession 完整 schema（dmScope, identityLinks, reset...）\nschema-tools.md\tTools 完整 schema（elevated, sandbox, allow/deny...）\nschema-models.md\tModels 完整 schema（providers, fallbacks, aliases...）\nquick-reference.md\t常用字段快速参考（50 个核心字段）\n使用方法\n1. 查询字段有效值\n用户：telegram 的 streaming 字段有哪些有效值？\nAI: 查阅 schema-channels.md → 返回有效值\n\n2. 验证配置\n用户：这个配置对吗？{ \"channels\": { \"telegram\": { \"streaming\": \"on\" } } }\nAI: 查阅 schema-channels.md → 验证并反馈\n\n3. 查找配置示例\n用户：如何配置 Telegram 机器人？\nAI: 查阅 schema-channels.md → 返回示例配置\n\n验证规则\n严格验证\n字段必须存在于 schema 中\n值必须是枚举中的有效值\n类型必须匹配（string, number, boolean, object, array）\n常见错误\n错误类型\t示例\t正确值\n无效枚举值\t\"streaming\": \"on\"\t\"off\" | \"partial\" | \"block\" | \"progress\"\n无效类型\t\"port\": \"18789\"\t\"port\": 18789\n未知字段\t\"channels\": { \"wechat\": {} }\t不支持的渠道\n与 Safe Config Workflow 的集成\n\n本 Skill 被 safe-config-workflow 自动调用：\n\nsafe-config-workflow 修改配置\n    ↓\n自动调用 config-validator 验证字段\n    ↓\n验证通过 → 继续执行\n验证失败 → 反馈错误并停止\n\n官方文档来源\n\n所有 schema 信息来自官方文档：\n\nhttps://docs.openclaw.ai/gateway/configuration-reference\nhttps://docs.openclaw.ai/zh-CN/gateway/configuration\n更新机制\n\n当官方文档更新时：\n\n重新读取官方 configuration-reference.md\n更新对应的 schema 模块文件\n更新 quick-reference.md（如有变化）\n在 SKILL.md 中记录版本历史\n版本历史\nv1.0 (2026-02-26) — 初始版本，包含完整 schema 和模块分文件"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/nicoxia/config-validator-zh-cn",
    "publisherUrl": "https://clawhub.ai/nicoxia/config-validator-zh-cn",
    "owner": "nicoxia",
    "version": "1.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/config-validator-zh-cn",
    "downloadUrl": "https://openagent3.xyz/downloads/config-validator-zh-cn",
    "agentUrl": "https://openagent3.xyz/skills/config-validator-zh-cn/agent",
    "manifestUrl": "https://openagent3.xyz/skills/config-validator-zh-cn/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/config-validator-zh-cn/agent.md"
  }
}