国内应用接入
金数据 MCP 接入:让 AI 助手整理表单与确认后录入
为 Hermes Agent 或 OpenClaw 连接金数据 API,读取指定表单的报名、反馈或业务记录;需要补录时,先核对表单和字段,再提交真实数据。
把表单里的记录变成可核对的行动清单
活动报名、售后反馈和项目需求往往已经收集在金数据里。连接后,您可以给助手一个明确的表单标识,让它查询对应记录,再归纳报名情况、整理反馈主题或列出需要跟进的事项。摘要由 Agent 根据读取结果生成,并非金数据接口直接提供的统计报告。
OpenClaw Launch 当前提供查询表单数据和新增单条数据两项操作。查询支持时间条件、字段过滤和分页;录入会写入真实表单,必须先得到您的确认。金数据官方 API 还有更多功能,本页只介绍国内应用列表已经接入的范围。
托管接入步骤适用于 Hermes Agent 和 OpenClaw:都在国内应用页面填写凭证。Hermes 在首次加载工具时可能显示正在重载,等连接就绪再开始查询。连接记录已保存,并不等于金数据已经确认该凭证能访问每一个表单。
接入后可以做什么?
- 读取指定表单:使用 form_token 查询数据列表,适合查看报名、需求登记或反馈记录;需要您先提供目标表单标识。
- 按条件分批查看:可传 created_at 筛选某个时间点之后的数据,或用 filters 按字段值过滤;存在下一页时使用 next 继续查询。
- 整理已读取的反馈:Agent 可以对查询结果归类、提取待办和汇总重复问题。结论只覆盖实际读取的记录,应说明筛选范围和是否读完分页。
- 确认后新增一条数据:核对目标表单、字段编码与完整字段值后,才以 confirm:true 提交。当前没有修改已有记录或删除记录的操作。
金数据 Access Token 怎么创建和连接?
新连接使用金数据 Access Token。个人账号在个人 API 页面创建,企业管理员也可使用企业 API 页面的企业 Token;免费账号同样有 API 入口,具体额度和可访问范围按账号套餐与权限执行。
金数据官方:API v1 认证与 Access Token 创建步骤
- 创建专用 Token — 在新版金数据 PC 后台进入右上角头像→个人中心→API,在个人 Access Token 区域点击创建 Token 并命名。企业管理员可在系统设置→企业 API 创建企业 Token。
- 保存凭证并确定目标 — Token 只在创建时完整显示一次,请保存在密码管理器。另行准备目标表单的 form_token 与需要操作的字段 api_code;这些标识不能用表单标题或题目文字替代。
- 连接托管助手 — 在 OpenClaw Launch 的国内应用列表选择金数据,将 Token 填入 Access Token 字段。Hermes Agent 和 OpenClaw 使用同一连接入口,等待页面显示工具已就绪。
- 先查询测试表单 — 使用您自己的非敏感测试表单执行只读查询,核对字段含义、时间范围和分页。若无权访问,检查 Token 所属账号与目标表单,不要反复创建新 Token。
- 需要录入时逐项确认 — 先让助手展示表单标识、字段编码和拟写入内容。确认无误后再新增一条记录,并在金数据后台检查结果;响应不确定时先查询,避免重复录入。
连接后可以直接这样问
- “查询我提供的表单 form_token 中 2026-09-01 之后的记录,按 next 继续分页;整理反馈主题,并标明读取了多少条。”
- “根据刚才读到的报名记录,汇总需要跟进的事项;只使用已返回的字段,不要补猜缺失信息,也不要联系报名者。”
- “根据我提供的 form_token 和字段 api_code 整理一条测试报名记录,先给我看全部字段,等我确认后再写入。”
使用前必须知道的限制
当前工具不提供表单列表或结构查询、创建表单、修改记录、删除记录、批量新增或附件上传。字段过滤需要正确的 api_code 和匹配字段类型的条件,托管连接最多接受 20 个过滤条件。查询结果可能分页或受返回大小限制,不能把第一页当成全部数据。created_at 的筛选时间按金数据接口使用北京时间,结果中的 UTC 时间需转换后再展示。
请先用自己创建的测试表单验证访问。共享表单能否读取应以具体接口实际授权为准,不要仅凭后台可见就承诺可读。报名者手机号、客户联系方式等信息只读取完成任务所需的部分;不要将 Token 放进聊天。停用时可断开连接,并在金数据创建 Token 的原位置撤销凭证。
托管连接还是自己搭工具?
| 方案 | 适合谁 | 您需要负责什么 |
|---|---|---|
| OpenClaw Launch 托管 | 希望尽快让机器人持续在线并连接金数据的用户 | 提供必要授权、确认敏感操作并管理自己的应用账户 |
| 自行部署 | 已有服务器、愿意维护 OpenClaw/Hermes 与兼容工具的开发者 | 为 Hermes Agent 或 OpenClaw 分别接入兼容工具,安全保存 Access Token,维护表单字段映射、分页、北京时间与 UTC 转换、配额处理以及写入前的确认流程;自行维护的工具不自动继承托管连接。 |
自行部署是合理选择;托管方案省下的是服务器配置、运行监控和集成维护时间。OpenClaw Launch 的托管价格为首月 $3,续费 $6/月,支持支付宝和微信支付。应用自身的会员、API 配额或其他费用仍按应用方规则计算。
已经有机器人?前往国内应用一键接入查看连接状态;第一次部署可先阅读养龙虾入门指南。
金数据接入常见问题
Hermes Agent 可以连接金数据吗?
可以。OpenClaw Launch 托管的 Hermes Agent 与 OpenClaw 使用同一国内应用连接入口,支持查询指定表单和确认后新增单条数据。Hermes 首次加载工具时需等待重载完成。
新账号为什么找不到 API Key 和 Secret?
金数据新接入使用 Access Token。请在个人中心→API 创建个人 Token,或由企业管理员在企业 API 创建企业 Token。此前已经生成的旧 Key/Secret 仍有兼容支持。
免费版金数据能接入吗?
金数据官方文档已向免费账号开放个人 API。是否能访问某张表单以及可用调用额度,仍受该账号的权限和套餐限制;连接成功不代表不限量。
能直接修改或删除已有记录吗?
当前托管连接没有这两项操作,只提供表单数据查询和确认后新增一条数据。不要把官方 API 的全部功能当成本连接已经支持的功能。
字段名应该填题目文字还是 field_1?
录入时需要表单对应的字段 api_code,例如 field_1。它不一定等于您看到的题目文字;请从目标表单确认字段和选项编码,再让助手准备写入内容。
为什么总结的记录比表单总数少?
查询可能带有时间或字段筛选,也可能只读取了一页。请让助手说明条件与记录数,并在有 next 时继续分页;大结果应缩小查询范围。