{
  "schemaVersion": "1.0",
  "item": {
    "slug": "dingtalk-ai-table",
    "name": "Dingtalk Ai Table",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/aliramw/dingtalk-ai-table",
    "canonicalUrl": "https://clawhub.ai/aliramw/dingtalk-ai-table",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/dingtalk-ai-table",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=dingtalk-ai-table",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "CHANGELOG.md",
      "README.md",
      "SKILL.md",
      "package.json",
      "references/api-reference.md",
      "references/error-codes.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. 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/dingtalk-ai-table"
    },
    "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/dingtalk-ai-table",
    "agentPageUrl": "https://openagent3.xyz/skills/dingtalk-ai-table/agent",
    "manifestUrl": "https://openagent3.xyz/skills/dingtalk-ai-table/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/dingtalk-ai-table/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": "钉钉 AI 表格操作（新版 MCP）",
        "body": "按 新版 MCP schema 工作：\n\nBase：baseId\nTable：tableId\nField：fieldId\nRecord：recordId\n\n不要再用旧版 dentryUuid / sheetIdOrName / fieldIdOrName。"
      },
      {
        "title": "版本守门规则（每个 MCP Server 地址只强制检查一次）",
        "body": "在真正开始任何 AI 表格操作前，必须先检查当前 mcporter 注册的 dingtalk-ai-table MCP server 实际返回的 tools schema。但这个检查不该每次都重复做；同一个 MCP Server 地址只需要强制检查一次。"
      },
      {
        "title": "一次性检查策略",
        "body": "先读取当前 mcporter 里 dingtalk-ai-table 对应的 MCP Server 地址。\n用这个地址生成一个本地检查标记（例如基于完整 URL 或其 hash）。\n在工作区保存检查结果，例如放到：\n\n~/.openclaw/workspace/.cache/dingtalk-ai-table/\n\n建议文件名模式：\n\nschema-check-<url-hash>.json\n\n如果当前地址对应的检查标记已经存在，并且结果是“已确认新版 schema”，则跳过重复检查，直接继续后续 AI 表格操作。\n只有在以下情况才重新强制检查：\n\n第一次运行，没有检查标记\nmcporter 里的 MCP Server 地址变了\n之前检查结果是旧版 schema / 检查失败\n用户明确要求重新验证"
      },
      {
        "title": "强制检查时执行",
        "body": "mcporter list dingtalk-ai-table --schema"
      },
      {
        "title": "判断标准",
        "body": "如果返回的 tools 仍然是旧版这一套，例如出现：\n\nget_root_node_of_my_document\ncreate_base_app\nlist_base_tables\nadd_base_record\nsearch_base_record\nlist_base_field\n\n或者整体仍然基于：\n\ndentryUuid\nsheetIdOrName\nfieldIdOrName\n\n那么说明：虽然 skill 文件已经是新版，但 mcporter 里注册的 MCP server 地址还是旧的，不能继续操作。"
      },
      {
        "title": "遇到旧版 schema 时的强制提示",
        "body": "此时必须明确提示用户：\n\n打开这个页面：\nhttps://mcp.dingtalk.com/#/detail?mcpId=9555&detailType=marketMcpDetail\n点击右侧 「获取 MCP Server 配置」 按钮\n复制新的 MCP Server 地址\n用新的地址替换 mcporter 里已经注册的 dingtalk-ai-table 地址\n替换完成后，再重新执行：\n\nmcporter list dingtalk-ai-table --schema\n\n只有当返回的 tools 已经变成新版 schema，例如出现：\n\nlist_bases\nget_base\nget_tables\nget_fields\nquery_records\ncreate_records\nupdate_records\ndelete_records\n\n才允许继续真正的 AI 表格操作。"
      },
      {
        "title": "通过检查后的处理",
        "body": "一旦确认当前 MCP Server 地址返回的是新版 schema，就把结果写入本地检查标记。后续只要 mcporter 里的 dingtalk-ai-table 地址没变，就不要再重复做这一步守门检查。"
      },
      {
        "title": "用户提示文案（可直接复用）",
        "body": "当前 mcporter 里注册的 dingtalk-ai-table 还是旧版 MCP schema，暂时不能按新版技能操作。\n请打开 https://mcp.dingtalk.com/#/detail?mcpId=9555&detailType=marketMcpDetail ，点击右侧“获取 MCP Server 配置”按钮，复制新的 MCP Server 地址，并替换 mcporter 里已注册的 dingtalk-ai-table 地址。替换后重新检查 schema，确认出现 list_bases / get_base / create_records 等新版 tools 后，再继续操作 AI 表格。"
      },
      {
        "title": "安装 mcporter CLI",
        "body": "npm install -g mcporter\n# 或\nbun install -g mcporter\n\n验证：\n\nmcporter --version"
      },
      {
        "title": "配置 MCP Server",
        "body": "在钉钉 MCP 广场 https://mcp.dingtalk.com/#/detail?mcpId=9555&detailType=marketMcpDetail 获取新版钉钉 AI 表格 MCP 的 Streamable HTTP URL。\n\n方式一：直接配置到 mcporter\n\nmcporter config add dingtalk-ai-table --url \"<Streamable_HTTP_URL>\"\n\n方式二：使用环境变量\n\nexport DINGTALK_MCP_URL=\"<Streamable_HTTP_URL>\"\n\n这个 URL 带访问令牌，等同密码，不要泄露。"
      },
      {
        "title": "工作区沙箱",
        "body": "脚本读取本地文件时，会优先使用 OPENCLAW_WORKSPACE 作为允许根目录：\n\nexport OPENCLAW_WORKSPACE=\"$HOME/.openclaw/workspace\"\n\n未设置时默认使用当前工作目录。"
      },
      {
        "title": "Base 层",
        "body": "list_bases\nsearch_bases\nget_base\ncreate_base\nupdate_base\ndelete_base\nsearch_templates"
      },
      {
        "title": "Table 层",
        "body": "get_tables\ncreate_table\nupdate_table\ndelete_table"
      },
      {
        "title": "Field 层",
        "body": "get_fields\ncreate_fields\nupdate_field\ndelete_field"
      },
      {
        "title": "Record 层",
        "body": "query_records\ncreate_records\nupdate_records\ndelete_records"
      },
      {
        "title": "1. 先找 Base",
        "body": "mcporter call dingtalk-ai-table list_bases limit=10 --output json\nmcporter call dingtalk-ai-table search_bases query=\"销售\" --output json"
      },
      {
        "title": "2. 再拿 Table 目录",
        "body": "mcporter call dingtalk-ai-table get_base baseId=\"base_xxx\" --output json"
      },
      {
        "title": "3. 再展开表结构",
        "body": "mcporter call dingtalk-ai-table get_tables \\\n  --args '{\"baseId\":\"base_xxx\",\"tableIds\":[\"tbl_xxx\"]}' \\\n  --output json"
      },
      {
        "title": "4. 字段复杂时读完整配置",
        "body": "mcporter call dingtalk-ai-table get_fields \\\n  --args '{\"baseId\":\"base_xxx\",\"tableId\":\"tbl_xxx\",\"fieldIds\":[\"fld_xxx\"]}' \\\n  --output json"
      },
      {
        "title": "5. 再查 / 写记录",
        "body": "mcporter call dingtalk-ai-table query_records \\\n  --args '{\"baseId\":\"base_xxx\",\"tableId\":\"tbl_xxx\",\"limit\":20}' \\\n  --output json\n\nmcporter call dingtalk-ai-table create_records \\\n  --args '{\"baseId\":\"base_xxx\",\"tableId\":\"tbl_xxx\",\"records\":[{\"cells\":{\"fld_name\":\"张三\"}}]}' \\\n  --output json"
      },
      {
        "title": "批量新增字段",
        "body": "python3 scripts/bulk_add_fields.py <baseId> <tableId> fields.json\n\nfields.json 示例：\n\n[\n  {\"fieldName\":\"任务名\",\"type\":\"text\"},\n  {\"fieldName\":\"优先级\",\"type\":\"singleSelect\",\"config\":{\"options\":[{\"name\":\"高\"},{\"name\":\"中\"},{\"name\":\"低\"}]}}\n]\n\n兼容项：\n\nname 会自动映射为 fieldName\nphone 会自动映射为 telephone"
      },
      {
        "title": "批量导入记录",
        "body": "python3 scripts/import_records.py <baseId> <tableId> data.csv\npython3 scripts/import_records.py <baseId> <tableId> data.json 50\n\n说明：\n\nCSV 表头默认按 fieldId 解释\nJSON 支持：\n\n[{\"cells\": {...}}]\n[{\"fld_xxx\": \"value\"}]"
      },
      {
        "title": "安全规则",
        "body": "文件路径受 OPENCLAW_WORKSPACE 沙箱限制\n仅允许读取工作区内 .json / .csv 文件\nBase / Table / Field / Record ID 都做格式校验\n批量上限按 MCP server 实际限制控制：\n\ncreate_fields：最多 15\nget_tables / get_fields：最多 10\ncreate_records / update_records / delete_records：最多 100"
      },
      {
        "title": "调试原则",
        "body": "先 get_base，再 get_tables，必要时 get_fields\n不要猜 fieldId\n复杂参数一律用 --args JSON\nsingleSelect / multipleSelect 过滤时必须传 option ID，不是 option name"
      },
      {
        "title": "参考",
        "body": "API 参考：references/api-reference.md\n错误排查：references/error-codes.md"
      }
    ],
    "body": "钉钉 AI 表格操作（新版 MCP）\n\n按 新版 MCP schema 工作：\n\nBase：baseId\nTable：tableId\nField：fieldId\nRecord：recordId\n\n不要再用旧版 dentryUuid / sheetIdOrName / fieldIdOrName。\n\n版本守门规则（每个 MCP Server 地址只强制检查一次）\n\n在真正开始任何 AI 表格操作前，必须先检查当前 mcporter 注册的 dingtalk-ai-table MCP server 实际返回的 tools schema。但这个检查不该每次都重复做；同一个 MCP Server 地址只需要强制检查一次。\n\n一次性检查策略\n先读取当前 mcporter 里 dingtalk-ai-table 对应的 MCP Server 地址。\n用这个地址生成一个本地检查标记（例如基于完整 URL 或其 hash）。\n在工作区保存检查结果，例如放到：\n~/.openclaw/workspace/.cache/dingtalk-ai-table/\n\n\n建议文件名模式：\n\nschema-check-<url-hash>.json\n\n如果当前地址对应的检查标记已经存在，并且结果是“已确认新版 schema”，则跳过重复检查，直接继续后续 AI 表格操作。\n只有在以下情况才重新强制检查：\n第一次运行，没有检查标记\nmcporter 里的 MCP Server 地址变了\n之前检查结果是旧版 schema / 检查失败\n用户明确要求重新验证\n强制检查时执行\nmcporter list dingtalk-ai-table --schema\n\n判断标准\n\n如果返回的 tools 仍然是旧版这一套，例如出现：\n\nget_root_node_of_my_document\ncreate_base_app\nlist_base_tables\nadd_base_record\nsearch_base_record\nlist_base_field\n\n或者整体仍然基于：\n\ndentryUuid\nsheetIdOrName\nfieldIdOrName\n\n那么说明：虽然 skill 文件已经是新版，但 mcporter 里注册的 MCP server 地址还是旧的，不能继续操作。\n\n遇到旧版 schema 时的强制提示\n\n此时必须明确提示用户：\n\n打开这个页面： https://mcp.dingtalk.com/#/detail?mcpId=9555&detailType=marketMcpDetail\n点击右侧 「获取 MCP Server 配置」 按钮\n复制新的 MCP Server 地址\n用新的地址替换 mcporter 里已经注册的 dingtalk-ai-table 地址\n替换完成后，再重新执行：\nmcporter list dingtalk-ai-table --schema\n\n\n只有当返回的 tools 已经变成新版 schema，例如出现：\n\nlist_bases\nget_base\nget_tables\nget_fields\nquery_records\ncreate_records\nupdate_records\ndelete_records\n\n才允许继续真正的 AI 表格操作。\n\n通过检查后的处理\n\n一旦确认当前 MCP Server 地址返回的是新版 schema，就把结果写入本地检查标记。后续只要 mcporter 里的 dingtalk-ai-table 地址没变，就不要再重复做这一步守门检查。\n\n用户提示文案（可直接复用）\n当前 mcporter 里注册的 dingtalk-ai-table 还是旧版 MCP schema，暂时不能按新版技能操作。\n请打开 https://mcp.dingtalk.com/#/detail?mcpId=9555&detailType=marketMcpDetail ，点击右侧“获取 MCP Server 配置”按钮，复制新的 MCP Server 地址，并替换 mcporter 里已注册的 dingtalk-ai-table 地址。替换后重新检查 schema，确认出现 list_bases / get_base / create_records 等新版 tools 后，再继续操作 AI 表格。\n\n前置要求\n安装 mcporter CLI\nnpm install -g mcporter\n# 或\nbun install -g mcporter\n\n\n验证：\n\nmcporter --version\n\n配置 MCP Server\n\n在钉钉 MCP 广场 https://mcp.dingtalk.com/#/detail?mcpId=9555&detailType=marketMcpDetail 获取新版钉钉 AI 表格 MCP 的 Streamable HTTP URL。\n\n方式一：直接配置到 mcporter\n\nmcporter config add dingtalk-ai-table --url \"<Streamable_HTTP_URL>\"\n\n\n方式二：使用环境变量\n\nexport DINGTALK_MCP_URL=\"<Streamable_HTTP_URL>\"\n\n\n这个 URL 带访问令牌，等同密码，不要泄露。\n\n工作区沙箱\n\n脚本读取本地文件时，会优先使用 OPENCLAW_WORKSPACE 作为允许根目录：\n\nexport OPENCLAW_WORKSPACE=\"$HOME/.openclaw/workspace\"\n\n\n未设置时默认使用当前工作目录。\n\n核心工具集\nBase 层\nlist_bases\nsearch_bases\nget_base\ncreate_base\nupdate_base\ndelete_base\nsearch_templates\nTable 层\nget_tables\ncreate_table\nupdate_table\ndelete_table\nField 层\nget_fields\ncreate_fields\nupdate_field\ndelete_field\nRecord 层\nquery_records\ncreate_records\nupdate_records\ndelete_records\n推荐工作流\n1. 先找 Base\nmcporter call dingtalk-ai-table list_bases limit=10 --output json\nmcporter call dingtalk-ai-table search_bases query=\"销售\" --output json\n\n2. 再拿 Table 目录\nmcporter call dingtalk-ai-table get_base baseId=\"base_xxx\" --output json\n\n3. 再展开表结构\nmcporter call dingtalk-ai-table get_tables \\\n  --args '{\"baseId\":\"base_xxx\",\"tableIds\":[\"tbl_xxx\"]}' \\\n  --output json\n\n4. 字段复杂时读完整配置\nmcporter call dingtalk-ai-table get_fields \\\n  --args '{\"baseId\":\"base_xxx\",\"tableId\":\"tbl_xxx\",\"fieldIds\":[\"fld_xxx\"]}' \\\n  --output json\n\n5. 再查 / 写记录\nmcporter call dingtalk-ai-table query_records \\\n  --args '{\"baseId\":\"base_xxx\",\"tableId\":\"tbl_xxx\",\"limit\":20}' \\\n  --output json\n\nmcporter call dingtalk-ai-table create_records \\\n  --args '{\"baseId\":\"base_xxx\",\"tableId\":\"tbl_xxx\",\"records\":[{\"cells\":{\"fld_name\":\"张三\"}}]}' \\\n  --output json\n\n脚本\n批量新增字段\npython3 scripts/bulk_add_fields.py <baseId> <tableId> fields.json\n\n\nfields.json 示例：\n\n[\n  {\"fieldName\":\"任务名\",\"type\":\"text\"},\n  {\"fieldName\":\"优先级\",\"type\":\"singleSelect\",\"config\":{\"options\":[{\"name\":\"高\"},{\"name\":\"中\"},{\"name\":\"低\"}]}}\n]\n\n\n兼容项：\n\nname 会自动映射为 fieldName\nphone 会自动映射为 telephone\n批量导入记录\npython3 scripts/import_records.py <baseId> <tableId> data.csv\npython3 scripts/import_records.py <baseId> <tableId> data.json 50\n\n\n说明：\n\nCSV 表头默认按 fieldId 解释\nJSON 支持：\n[{\"cells\": {...}}]\n[{\"fld_xxx\": \"value\"}]\n安全规则\n文件路径受 OPENCLAW_WORKSPACE 沙箱限制\n仅允许读取工作区内 .json / .csv 文件\nBase / Table / Field / Record ID 都做格式校验\n批量上限按 MCP server 实际限制控制：\ncreate_fields：最多 15\nget_tables / get_fields：最多 10\ncreate_records / update_records / delete_records：最多 100\n调试原则\n先 get_base，再 get_tables，必要时 get_fields\n不要猜 fieldId\n复杂参数一律用 --args JSON\nsingleSelect / multipleSelect 过滤时必须传 option ID，不是 option name\n参考\nAPI 参考：references/api-reference.md\n错误排查：references/error-codes.md"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/aliramw/dingtalk-ai-table",
    "publisherUrl": "https://clawhub.ai/aliramw/dingtalk-ai-table",
    "owner": "aliramw",
    "version": "0.5.2",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/dingtalk-ai-table",
    "downloadUrl": "https://openagent3.xyz/downloads/dingtalk-ai-table",
    "agentUrl": "https://openagent3.xyz/skills/dingtalk-ai-table/agent",
    "manifestUrl": "https://openagent3.xyz/skills/dingtalk-ai-table/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/dingtalk-ai-table/agent.md"
  }
}