gws-licensing

What This Skill Does

The gws-licensing skill is a powerful OpenClaw agent tool designed for Google Workspace administrators to programmatically manage enterprise product licenses. It serves as an interface to the Google Workspace Licensing API, allowing you to assign, revoke, or reassign product SKUs for users within your organization. Whether you are scaling your team and need to provision new software access or auditing license utilization to optimize costs, this skill provides a direct command-line approach to handle these lifecycle operations efficiently. It integrates seamlessly with the gws-shared framework, ensuring that all authentication and security protocols defined in your environment are maintained. By utilizing gws schema, administrators can dynamically inspect parameter requirements for specific methods, ensuring high precision when performing batch assignments or individual user updates.

Installation

To add this skill to your OpenClaw environment, run the following command in your terminal:

clawhub install openclaw/skills/skills/googleworkspace-bot/gws-licensing

Ensure you have configured your prerequisite authentication following the instructions in gws-shared/SKILL.md. If you are unable to locate the shared configuration, run gws generate-skills to initialize the necessary baseline settings before proceeding with the licensing operations.

Use Cases

• Automated Provisioning: Automatically assign Google Workspace Enterprise or G Suite add-on licenses to new hires based on their department or role.
• License Reclamation: Periodically audit assigned licenses and use the delete method to revoke access for departed employees or inactive accounts to ensure cost optimization.
• Upgrade Management: Seamlessly transition users between different subscription tiers within the same product family using the update or patch methods.
• Usage Audits: Use the listForProduct method to generate reports on how many licenses are currently in use, assisting finance teams with accurate software expenditure tracking.

Example Prompts

1. "Check how many users currently have the Enterprise Plus SKU assigned and list their email addresses."
2. "Assign the Google Workspace Business Standard license to user [email protected]."
3. "Revoke the current license for user [email protected] to prepare for account decommissioning."

Tips & Limitations

• Always Verify First: Before executing delete or update operations, use gws licensing licenseAssignments get to verify the current state of the user's license to prevent accidental access loss.
• Schema Usage: Always run gws schema licensing.<resource>.<method> if you are unsure about the required parameter types (like productId or skuId), as input mismatches can lead to API request errors.
• Permission Scope: Ensure the service account or user credentials linked to this skill have the 'Admin Console' licensing management privileges enabled; otherwise, the API will return a 403 Forbidden error regardless of the command structure.