google-forms

What This Skill Does

The google-forms skill allows your OpenClaw agent to seamlessly interact with the Google Forms API. It provides a robust, authenticated bridge to Google's ecosystem, enabling you to programmatically create new forms, append complex question structures, and ingest participant responses directly into your workflow. By leveraging managed OAuth via the Maton gateway, the skill abstracts the complexity of token management and refresh cycles, allowing you to focus on form orchestration rather than credential handling.

Installation

To install this skill, run the following command in your terminal:

clawhub install openclaw/skills/skills/byungkyu/google-forms

Once installed, ensure your MATON_API_KEY environment variable is exported to your shell session. You must initialize your OAuth connection by visiting the controller URL provided in the connection management documentation before the agent can successfully authenticate with Google's APIs.

Use Cases

• Automated Survey Deployment: Automatically generate feedback forms immediately following the conclusion of a project or customer support ticket.
• Data Collection Pipelines: Programmatically retrieve form submissions to trigger downstream business logic or aggregate data into external analytics databases.
• Dynamic Quiz Generation: Create unique, personalized assessments for educational or training purposes based on user-provided curriculum parameters.
• Event Registration: Programmatically structure registration forms to manage attendee data and export response metrics for event planning.

Example Prompts

1. "Create a new Google Form named 'Customer Feedback Q1' with fields for Name, Email, and a 1-5 satisfaction rating."
2. "Check the current status of my Google Forms connections on Maton and list all active sessions."
3. "Retrieve the latest 20 responses from the form with ID '1abc-123-xyz' and summarize the findings in a bulleted list."

Tips & Limitations

• Connection Management: Always ensure your OAuth connection status is 'ACTIVE' at https://ctrl.maton.ai before executing requests. If a request fails with an unauthorized error, trigger the refresh or re-authorization flow.
• Rate Limiting: Be mindful of Google's API quotas; avoid flooding the API with bulk creation requests in rapid succession.
• Scope Permissions: Ensure that the Google account authorized through the Maton gateway has the appropriate permissions to read and write forms within your organization's domain.