Typeform：自动化表单与问卷管理 - Openclaw Skills

什么是 Typeform？

Typeform 技能赋予 AI 智能体直接与 Typeform API 交互的能力，从而实现结构化数据收集的自动化。通过在 Openclaw Skills 生态系统中使用此集成，开发者可以构建不仅能提问，还能构建捕获反馈、线索信息和研究数据所需数字基础设施的智能体。

该技能填补了原始 AI 处理与专业表单管理之间的空白。它为智能体提供了技术基础，使其能够列出活动表单、检索详细的提交分析，甚至根据项目需求动态生成新表单。对于任何希望通过 Openclaw Skills 扩展数据收集工作流程的开发者来说，这都是一个至关重要的工具。

下载入口:https://github.com/openclaw/skills/tree/main/skills/mrgoodb/typeform

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install typeform

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 <project>/skills/

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 typeform。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。

Typeform 应用场景

• 在产品里程碑后自动部署客户反馈问卷。
• 通过编程方式检索并总结问卷回复，用于利益相关者报告。
• 通过自动删除特定表单回复来管理数据隐私。
• 通过自动统计回复数量，实时监控潜在客户生成量。

Typeform 工作原理

1. AI 智能体使用 TYPEFORM_API_TOKEN 环境变量初始化连接。
2. 向 Typeform API 端点发送命令，以查询现有表单或创建新结构。
3. 该技能处理 JSON 有效负载，以定义评分、短文本或多选题等表单字段。
4. 数据以结构化格式检索，允许智能体解析回复或使用 jq 等工具计算总量。

Typeform 配置指南

要开始使用此技能，您必须使用来自 Typeform 的有效 API 令牌配置您的环境。

export TYPEFORM_API_TOKEN="tfp_xxxxxxxxxx"

设置环境变量后，AI 智能体即可开始向 API 发起身份验证请求。

Typeform 数据架构与分类体系

实体	描述
表单 (Forms)	问卷的主要容器，包括标题和字段定义。
字段 (Fields)	各个问题类型，如具有特定属性的短文本或评分。
回复 (Responses)	用户提交的数据，可通过特定于表单的标识符访问。
元数据 (Metadata)	包括用于分析的回复计数、项目总数和分页详情。

name: typeform
description: Create and manage forms, surveys, and quizzes via Typeform API. Retrieve responses and analytics.
metadata: {"clawdbot":{"emoji":"??","requires":{"env":["TYPEFORM_API_TOKEN"]}}}

Typeform

Forms and surveys.

Environment

export TYPEFORM_API_TOKEN="tfp_xxxxxxxxxx"

List Forms

curl "https://api.typeform.com/forms" r
  -H "Authorization: Bearer $TYPEFORM_API_TOKEN"

Get Form Details

curl "https://api.typeform.com/forms/{form_id}" r
  -H "Authorization: Bearer $TYPEFORM_API_TOKEN"

Get Responses

curl "https://api.typeform.com/forms/{form_id}/responses" r
  -H "Authorization: Bearer $TYPEFORM_API_TOKEN"

Get Response Count

curl "https://api.typeform.com/forms/{form_id}/responses?page_size=1" r
  -H "Authorization: Bearer $TYPEFORM_API_TOKEN" | jq '.total_items'

Create Form

curl -X POST "https://api.typeform.com/forms" r
  -H "Authorization: Bearer $TYPEFORM_API_TOKEN" r
  -H "Content-Type: application/json" r
  -d '{
    "title": "Feedback Survey",
    "fields": [
      {"type": "short_text", "title": "What is your name?"},
      {"type": "rating", "title": "How would you rate us?", "properties": {"steps": 5}}
    ]
  }'

Delete Response

curl -X DELETE "https://api.typeform.com/forms/{form_id}/responses?included_response_ids={response_id}" r
  -H "Authorization: Bearer $TYPEFORM_API_TOKEN"

Links

• Dashboard: https://admin.typeform.com
• Docs: https://developer.typeform.com