squareup

What This Skill Does

The squareup skill serves as a high-level integration bridge for the Square payment ecosystem, allowing OpenClaw AI agents to interact with Point-of-Sale (POS) data, process transactions, and manage merchant operations securely. By leveraging managed OAuth tokens via the Maton gateway, this skill abstracts the complexity of raw API authentication, enabling the agent to execute operations across Square's vast suite, including catalog management, customer databases, inventory tracking, and financial reconciliation. It acts as a proxy, ensuring that your requests are authorized and routed correctly to Square's backend without needing to handle rotating credentials manually.

Installation

To integrate this skill, use the ClawHub CLI: clawhub install openclaw/skills/skills/byungkyu/squareup. Once installed, ensure you have a valid Maton API key generated at maton.ai. Export this key as MATON_API_KEY in your environment. Before using the skill, you must initialize a connection via the ctrl.maton.ai dashboard or through the provided API endpoints. Once you receive the authorization URL from the connection creation endpoint, navigate to it in your web browser to complete the OAuth handshake. Once authorized, the status will flip to ACTIVE, enabling full access to the Square API.

Use Cases

• Inventory Management: Automatically update stock levels across physical and digital storefronts when orders are placed.
• Payment Orchestration: Generate custom payment links for invoices or accept payments directly through agent-led workflows.
• Customer Relationship Management: Retrieve customer purchase history or contact information to personalize service interactions.
• Sales Analytics: Aggregate daily transaction data to generate reports on store performance across multiple locations.
• Catalog Synchronization: Programmatically update prices and descriptions for products across your entire Square catalog.

Example Prompts

1. "Check the current stock levels for item SKU 98765 and alert me if it falls below 10 units."
2. "Create a new payment link for a service invoice totaling $250.00 and send it to the customer with the email address [email protected]."
3. "List all active business locations and provide a summary of the total sales revenue generated for the current month."

Tips & Limitations

Always manage your connections via the Maton control panel. If you encounter authorization errors, check that your session token is valid and the connection status is set to ACTIVE. Note that this skill is designed specifically for the Square ecosystem; for other third-party payment gateways or non-Square APIs, please use the standard api-gateway skill to avoid configuration conflicts. Ensure your Maton API key is stored securely using an environment variable manager, as hardcoding it in scripts poses a significant security risk.