gws-reseller

What This Skill Does

The gws-reseller skill provides a powerful command-line interface for Google Workspace partners to manage customer accounts, subscriptions, and notification settings directly within the OpenClaw environment. By interfacing with the Reseller API v1, this skill automates complex administrative tasks that are typically handled through the Google Workspace Reseller console. It allows agents to retrieve customer account details, provision new accounts, modify subscription plans, adjust seat counts, and manage renewal settings programmatically. The skill is designed for high-volume resellers looking to streamline their operations, reduce manual overhead, and ensure consistent management of client portfolios.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/googleworkspace-bot/gws-reseller

Please ensure that you have first set up your authentication credentials as detailed in the ../gws-shared/SKILL.md file. If the shared configuration is missing, you may run gws generate-skills to initialize the required authentication and global flag parameters before attempting to perform any reseller operations.

Use Cases

This skill is ideal for partners managing multiple Google Workspace tenants. Common use cases include:

• Automating the onboarding process for new customers by programmatically inserting new accounts.
• Performing bulk seat adjustments for large organizations during seasonal hiring fluctuations.
• Updating subscription renewal settings to ensure compliance with annual commitment plans.
• Monitoring reseller notification channels to react to changes in customer statuses or service events.
• Switching customers from trial periods to paid annual commitment plans at scale.

Example Prompts

• "Get the account details for customer ID 'C01234567' using the gws-reseller tool."
• "Change the seat count for the subscription ID 'sub-8899' to 50 licenses."
• "Register this reseller account for notifications and list the current watch details."

Tips & Limitations

• Authentication: Always prioritize the security of your GWS credentials. The tool relies on the gws-shared module; if your auth tokens expire, you will need to re-authenticate following the standard provider flow.
• Customer Types: Be aware that you cannot modify customerType through this API. While you can manage "team" accounts, their promotion to "domain" accounts often requires manual verification via the Google Workspace Admin console if domain ownership is not yet confirmed.
• Subscription Limits: When using changePlan, ensure you are aware of the specific product-level constraints provided by Google, as not all subscriptions are eligible for every transition (e.g., specific trial-to-paid paths).