gws-chat

What This Skill Does

The gws-chat skill provides a powerful interface for interacting with Google Chat programmatically. By integrating directly with Google Workspace, this skill enables users to manage complex Chat environments, including spaces, media attachments, and custom emojis. It serves as an automation layer that allows you to programmatically handle message payloads, retrieve information about chat assets, and manage organizational identity through custom emoji libraries. Whether you need to automate administrative tasks or handle media uploads to specific project threads, this skill provides the necessary command-line structure to execute operations securely and efficiently.

Installation

To integrate this skill into your environment, use the OpenClaw hub CLI. Execute the following command in your terminal:

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

Ensure you have configured your prerequisite auth credentials in the gws-shared module as outlined in the documentation. If you have not initialized your shared workspace settings, run gws generate-skills to establish the required authentication handshake and security headers.

Use Cases

• Automated Communication: Use the helper +send functionality to trigger notifications from CI/CD pipelines directly into team spaces.
• Emoji Management: Maintain consistent team branding by programmatically deploying company-wide custom emojis.
• Asset Management: Streamline project collaboration by uploading file attachments directly into chat threads for centralized tracking.
• Workflow Automation: Integrate with Google Workspace to manage space visibility and audit trail retrieval through list and get operations.

Example Prompts

1. "Check the current list of custom emojis available in the organization and let me know if the 'team-approved' icon exists."
2. "Upload the file 'project_roadmap.pdf' to the Engineering space and confirm the file download URI once processed."
3. "List all active spaces I am currently a member of to help me organize my workspace alerts."

Tips & Limitations

• Permissions: Always verify that you have appropriate Administrative or User roles for the requested method. Custom emoji creation, for instance, requires organization-wide permissions enabled by your workspace admin.
• Auth: Always ensure your gws-shared module is up to date, as session tokens for Google Workspace expire regularly.
• Scope: This skill is restricted to Google Workspace environments. It will not function for personal consumer Google accounts.