Tencent Survey for Openclaw

A professional integration for managing Tencent Survey (wj.qq.com) operations including survey creation, structural updates, and data retrieval via AI agents.

sky-lv
v1.0.0
May 10, 2026
0
463
17

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install tencent-survey

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install tencent-survey using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Tencent Survey?

The Tencent Survey skill is a comprehensive MCP integration designed to bridge the gap between AI assistants and the wj.qq.com platform. It allows developers and teams to automate the full lifecycle of online surveys, including polls, exams, and assessments. By utilizing a pure-text DSL, agents can programmatically build complex survey structures and manage team-based projects with ease.

This skill is built for efficiency, providing high-fidelity access to survey titles, settings, page structures, and question options. Whether you are conducting market research or internal evaluations, this Openclaw Skills contribution provides the necessary tools to handle high-volume survey data and real-time response monitoring directly through a terminal or an AI-native interface.

Tencent Survey Use Cases

  • Creating new online surveys, exams, or voting forms using natural language prompts.
  • Updating existing survey questions by referencing specific IDs and DSL snippets.
  • Automatically retrieving and paginating through large sets of survey responses for data analysis.
  • Extracting survey details and structural metadata from a wj.qq.com URL.
  • Monitoring survey status and project-specific organization within a team environment.

How Tencent Survey Works

  1. The AI agent detects survey-related keywords or a wj.qq.com link and triggers the Tencent Survey skill.
  2. An authentication check is performed using either a pre-configured TENCENT_SURVEY_TOKEN or the OAuth device flow.
  3. For data retrieval, the agent parses the Survey ID from the URL and calls the get_survey tool to fetch the full JSON structure and DSL.
  4. To create or update content, the agent generates a text-based DSL and sends it to the create_survey or update_question endpoints.
  5. For analytics, the agent calls list_answers, utilizing cursor-based pagination to collect all respondent data until the list is exhausted.

Tencent Survey Setup

To get started with this Openclaw Skills package, ensure you have the mcporter CLI installed and an active Tencent Survey token.

Environment Variable Setup

If you have a token starting with wjpt_, export it to your environment:

export TENCENT_SURVEY_TOKEN=your_token_here
bash "${SKILL_DIR}/setup.sh" wj_check_and_start_auth

OAuth Authorization

If you do not have a token, run the setup script to begin the OAuth flow:

bash "${SKILL_DIR}/setup.sh" wj_check_and_start_auth
# Follow the URL provided in the output, then run:
bash "${SKILL_DIR}/setup.sh" wj_wait_auth

Tencent Survey Data Schema & Taxonomy

The skill organizes data based on a hierarchical Survey-to-Option relationship and a separate Answer-to-Question response model.

Level Components
Survey id, hash, title, scene (1=Survey, 3=Exam, 6=Evaluation, 8=Vote), state
Structure Pages[] > Questions[] > Options[]
Question Meta type, sub_type, title, required, DSL text
Answer Data answer_id, respondent_nickname, location (province/city), timestamp, answers[]

Tencent Survey Advanced Features

  • Support for Pure-Text DSL allowing AI agents to draft complex question logic without manual UI interaction.
  • Cursor-based pagination in list_answers for reliable handling of thousands of responses.
  • Project-level filtering to manage surveys across different team workspace IDs.
  • Integrated skill update checker (check_skill_update) to ensure the local MCP implementation is current.
  • Intelligent URL parsing to automatically extract survey_id from standard sharing links.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*