quickbooks-openclaw

What This Skill Does

The quickbooks-openclaw skill provides a robust, direct integration between your OpenClaw agent and your Intuit QuickBooks Online company account. By bridging the gap between your conversational agent and your financial management platform, this skill empowers OpenClaw to perform complex accounting tasks on your behalf. Whether you need to generate professional invoices, reconcile incoming payments, manage inventory levels, or retrieve real-time financial reporting data, this skill enables seamless synchronization. It leverages OAuth 2.0 for secure access, ensuring that your financial data is handled with appropriate authentication protocols without manual entry. Beyond simple data retrieval, it allows for proactive financial management, enabling the agent to draft purchase orders, track accounts payable, and organize customer or vendor records, making your accounting workflow significantly more efficient.

Installation

To get started, first ensure your environment meets the prerequisites by installing Node.js version 18.0.0 or higher. Navigate to your desired workspace directory and run 'npm install' to fetch the necessary dependencies, specifically axios, express, and open. You must then register an app at the Intuit Developer Portal to obtain your Client ID and Client Secret. Create a 'config.json' file using the provided template and populate it with these credentials. Finally, integrate the skill into your OpenClaw configuration file by adding the path to your local workspace, enabling the 'quickbooks' skill block, and ensuring 'autoStart' is set to true. Once configured, execute the 'qb_authenticate' command within OpenClaw to finalize the OAuth handshake.

Use Cases

• Automated Billing: Automatically generate and email professional invoices to clients based on project completion logs.
• Expense Tracking: Query the agent to categorize recurring business expenses or reconcile vendor bills against recorded purchase orders.
• Financial Reporting: Request instant summaries such as 'What is my current profit and loss for this quarter?' or 'Show me an aging summary of all unpaid invoices.'
• Vendor Relations: Use the agent to update contact information for vendors or verify the status of pending purchase orders.

Example Prompts

1. "OpenClaw, please generate an invoice for Acme Corp for the 10 hours of consulting work we completed yesterday and send it to their billing contact."
2. "Can you pull my Profit and Loss statement for last month and highlight the top three expense categories?"
3. "Check the status of unpaid bills and list any vendors that are currently overdue by more than 30 days."

Tips & Limitations

• Safety First: Always double-check generated invoices before finalizing or sending them to clients, especially when they involve complex line items or inventory deductions.
• Sandbox Testing: We highly recommend testing your automation workflows in a QuickBooks sandbox company before connecting to your production production environment.
• Rate Limits: Be aware that the QuickBooks Online API enforces strict rate limits; heavy bulk data requests should be scheduled during off-peak hours.
• Authentication: The skill relies on a local callback server; ensure your firewall or port configuration allows traffic on the specified redirect URI port.