{
  "schemaVersion": "1.0",
  "item": {
    "slug": "config-field",
    "name": "OpenClaw Config Field Validator",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/RedContritio/config-field",
    "canonicalUrl": "https://clawhub.ai/RedContritio/config-field",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/config-field",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=config-field",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "references/schema-fields.md",
      "scripts/field_info.py",
      "scripts/generate_fields.py",
      "scripts/schema.json"
    ],
    "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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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-field"
    },
    "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-field",
    "agentPageUrl": "https://openagent3.xyz/skills/config-field/agent",
    "manifestUrl": "https://openagent3.xyz/skills/config-field/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/config-field/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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Config Field Validator",
        "body": "Validate OpenClaw configuration fields against the official Zod schema."
      },
      {
        "title": "When to Use This Skill",
        "body": "Before editing configurations - Verify a field exists before adding it\nDebugging config errors - Check if invalid fields are causing issues\nMigrating configs - Validate fields after version upgrades\nReviewing configs - Ensure all fields are schema-compliant"
      },
      {
        "title": "How It Works",
        "body": "This skill automatically manages schema synchronization:\n\nCheck Version - Detects local OpenClaw version\nSync Schema - Downloads matching schema from GitHub if needed\nGenerate Fields - Parses Zod schema to extract field definitions\nValidate - Uses generated schema to validate configuration"
      },
      {
        "title": "Quick Start",
        "body": "# Validate a single field (auto-syncs schema if needed)\npython3 scripts/validate_field.py agents.defaults.model.primary\n\n# Validate entire config file\npython3 scripts/validate_config.py /path/to/openclaw.json\n\n# Force schema re-sync\npython3 scripts/sync_schema.py --force\n\n# Check current schema status\npython3 scripts/sync_schema.py --status"
      },
      {
        "title": "Field Path Format",
        "body": "Field paths use dot notation:\n\nagents.defaults.model.primary              → agents.defaults.model.primary\nchannels.telegram.botToken                 → channels.telegram.botToken\ntools.web.search.provider                  → tools.web.search.provider"
      },
      {
        "title": "For Users",
        "body": "Simply use validation commands - schema sync is automatic:\n\n# This will auto-sync schema if version mismatch detected\npython3 scripts/validate_field.py agents.defaults.timeoutSeconds"
      },
      {
        "title": "For Schema Management",
        "body": "# Check schema status\npython3 scripts/sync_schema.py --status\n# Output: Schema version: 2.1.0 (matches OpenClaw)\n\n# Force re-sync (if needed)\npython3 scripts/sync_schema.py --force\n\n# Generate fresh field reference\npython3 scripts/generate_fields.py"
      },
      {
        "title": "Schema Storage",
        "body": "Schema is cached locally at:\n\n~/.config/openclaw/skills/config-field/\n├── schema/              # Downloaded TypeScript schema files\n├── cache/               # Parsed schema cache\n└── schema-fields.md     # Generated field reference"
      },
      {
        "title": "Complete Field Reference",
        "body": "references/schema-fields.md - Auto-generated from official Zod schema"
      },
      {
        "title": "Scripts",
        "body": "ScriptPurposevalidate_field.py <path>Validate single fieldvalidate_config.py <file>Validate entire configfield_info.py <path>Get field detailssync_schema.pyManage schema syncgenerate_fields.pyRegenerate field docs"
      },
      {
        "title": "Agent Configuration",
        "body": "agents.defaults.model.primary - Default model ID\nagents.defaults.workspace - Workspace path\nagents.defaults.timeoutSeconds - Request timeout\nagents.defaults.sandbox.mode - Sandbox mode"
      },
      {
        "title": "Channel Configuration",
        "body": "channels.telegram.botToken - Telegram bot token\nchannels.discord.token - Discord bot token\nchannels.slack.botToken - Slack bot token"
      },
      {
        "title": "Tools",
        "body": "tools.web.search.enabled - Enable web search\ntools.web.search.provider - Search provider\ntools.exec.security - Execution security mode"
      },
      {
        "title": "Schema Out of Date",
        "body": "If you see warnings about unknown fields that should exist:\n\n# Force schema refresh\npython3 scripts/sync_schema.py --force"
      },
      {
        "title": "Validation Errors",
        "body": "# Check field info for correct usage\npython3 scripts/field_info.py agents.defaults.model\n\n# Verify config syntax\npython3 scripts/validate_config.py ~/.config/openclaw/openclaw.json"
      }
    ],
    "body": "Config Field Validator\n\nValidate OpenClaw configuration fields against the official Zod schema.\n\nWhen to Use This Skill\nBefore editing configurations - Verify a field exists before adding it\nDebugging config errors - Check if invalid fields are causing issues\nMigrating configs - Validate fields after version upgrades\nReviewing configs - Ensure all fields are schema-compliant\nHow It Works\n\nThis skill automatically manages schema synchronization:\n\nCheck Version - Detects local OpenClaw version\nSync Schema - Downloads matching schema from GitHub if needed\nGenerate Fields - Parses Zod schema to extract field definitions\nValidate - Uses generated schema to validate configuration\nQuick Start\n# Validate a single field (auto-syncs schema if needed)\npython3 scripts/validate_field.py agents.defaults.model.primary\n\n# Validate entire config file\npython3 scripts/validate_config.py /path/to/openclaw.json\n\n# Force schema re-sync\npython3 scripts/sync_schema.py --force\n\n# Check current schema status\npython3 scripts/sync_schema.py --status\n\nField Path Format\n\nField paths use dot notation:\n\nagents.defaults.model.primary              → agents.defaults.model.primary\nchannels.telegram.botToken                 → channels.telegram.botToken\ntools.web.search.provider                  → tools.web.search.provider\n\nWorkflow\nFor Users\n\nSimply use validation commands - schema sync is automatic:\n\n# This will auto-sync schema if version mismatch detected\npython3 scripts/validate_field.py agents.defaults.timeoutSeconds\n\nFor Schema Management\n# Check schema status\npython3 scripts/sync_schema.py --status\n# Output: Schema version: 2.1.0 (matches OpenClaw)\n\n# Force re-sync (if needed)\npython3 scripts/sync_schema.py --force\n\n# Generate fresh field reference\npython3 scripts/generate_fields.py\n\nSchema Storage\n\nSchema is cached locally at:\n\n~/.config/openclaw/skills/config-field/\n├── schema/              # Downloaded TypeScript schema files\n├── cache/               # Parsed schema cache\n└── schema-fields.md     # Generated field reference\n\nReference\nComplete Field Reference\n\nreferences/schema-fields.md - Auto-generated from official Zod schema\n\nScripts\nScript\tPurpose\nvalidate_field.py <path>\tValidate single field\nvalidate_config.py <file>\tValidate entire config\nfield_info.py <path>\tGet field details\nsync_schema.py\tManage schema sync\ngenerate_fields.py\tRegenerate field docs\nCommon Fields\nAgent Configuration\nagents.defaults.model.primary - Default model ID\nagents.defaults.workspace - Workspace path\nagents.defaults.timeoutSeconds - Request timeout\nagents.defaults.sandbox.mode - Sandbox mode\nChannel Configuration\nchannels.telegram.botToken - Telegram bot token\nchannels.discord.token - Discord bot token\nchannels.slack.botToken - Slack bot token\nTools\ntools.web.search.enabled - Enable web search\ntools.web.search.provider - Search provider\ntools.exec.security - Execution security mode\nTroubleshooting\nSchema Out of Date\n\nIf you see warnings about unknown fields that should exist:\n\n# Force schema refresh\npython3 scripts/sync_schema.py --force\n\nValidation Errors\n# Check field info for correct usage\npython3 scripts/field_info.py agents.defaults.model\n\n# Verify config syntax\npython3 scripts/validate_config.py ~/.config/openclaw/openclaw.json"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/RedContritio/config-field",
    "publisherUrl": "https://clawhub.ai/RedContritio/config-field",
    "owner": "RedContritio",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/config-field",
    "downloadUrl": "https://openagent3.xyz/downloads/config-field",
    "agentUrl": "https://openagent3.xyz/skills/config-field/agent",
    "manifestUrl": "https://openagent3.xyz/skills/config-field/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/config-field/agent.md"
  }
}