An interactive Telegram skill that presents multiple clarifying questions as a structured form with inline buttons and free-text support.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install questions-form
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install questions-form 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 Questions Form?
The Questions Form skill is designed to optimize how AI agents gather information from users on Telegram. Instead of asking questions one-by-one, which can be tedious and disruptive, this skill allows the agent to present a suite of questions simultaneously. Each question is rendered as a separate message with intuitive inline buttons, allowing users to provide structured responses or utilize a free-text escape hatch for more complex answers.
This approach is essential for Openclaw Skills that require multi-faceted requirement gathering, onboarding flows, or preference collection. By utilizing a standardized callback protocol, the skill ensures that data is collected accurately and remains manageable for the agent's internal logic. This structured interaction model significantly improves user experience by providing a clear, non-linear way to complete complex input tasks within the chat interface.
Questions Form Use Cases
- Gathering multi-faceted project requirements before starting a technical task.
- Executing user onboarding flows that require specific configuration data.
- Collecting user preferences for automated reports or notifications.
- Any scenario where an agent needs 2 or more clarifying answers to proceed accurately.
How Questions Form Works
- Initialize the internal tracking state and define the form questions with unique, short identifiers.
- Send a plain text header message to introduce the form purpose to the user.
- Dispatch each question as a separate Telegram message containing inline buttons for predefined options.
- Append a final message featuring Submit and Cancel buttons to control the submission lifecycle.
- Process incoming callbacks using the mandatory form: prefix to update the state or trigger free-text input for Other options.
- Validate that all required fields are filled upon submission before passing the structured data to the next step of the workflow.
Questions Form Setup
To implement this within your Openclaw Skills environment, ensure your agent is configured for Telegram and follow the protocol for defining callback data. No external dependencies are required beyond a standard Telegram bot integration.
# Define your internal state and tracking logic
form_state = { "type": null, "timeline": null }
# Ensure your callback handlers look for the form: prefix
Ensure that all button callback data follows the form:<question_id>:<value> convention to maintain compatibility with the state manager.
Questions Form Data Schema & Taxonomy
The skill organizes data through a state object and specific callback conventions to ensure lightweight processing within the 64-byte Telegram limit.
| Component | Description | Format |
|---|---|---|
| form_state | Internal object storing user responses | Key-Value Pairs |
| callback_data | The button payload for Telegram communication | form:<qid>:<value> |
| qid | Short question identifier (2-8 chars) | String |
| value | The selected option identifier or 'other' | String |
Questions Form Advanced Features
- Free-text Other escape hatch for non-enumerable answers or specific user input.
- Real-time answer updates allowing users to change selections dynamically before submission.
- Support for dependent question logic, showing specific questions based on previous answers.
- Multi-select toggle patterns for complex data sets requiring multiple choices.
- Built-in validation that identifies and prompts for specific unanswered questions upon submission.
SKILL.md
Loading
Related Openclaw Skills
TokenGuard
TokenGuard is a lightweight prevention engine that intercepts LLM API requests to avoid rate limits and optimize token usage efficiency.
AOI / Aoineco Starter Pack
A streamlined utility pack designed to install curated bundles of AI agent skills in a single command.
Aoineco Squad Dispatch
A lightweight Python engine that orchestrates multi-agent squads by routing tasks to the most efficient model based on skill requirements and cost.
Aoineco Ledger
A high-efficiency financial tracking engine for AI agents to monitor API costs, gas fees, and revenue in real-time.
Clinico Geral (Dr. Medice)
An AI-powered medical assistant providing educational insights into symptoms, diseases, medications, and general health maintenance.
Investment Analyst Agent
A specialized AI agent for fundamental and technical investment analysis across stocks, FIIs, and ETFs.
Featured*
