stripe

What This Skill Does

The Stripe skill for OpenClaw provides a powerful, direct command-line interface to interact with your Stripe financial ecosystem. By utilizing a local Python wrapper that communicates directly with api.stripe.com, this skill allows users to perform administrative tasks, audit financial records, and manage customer data without leaving the OpenClaw environment. It supports comprehensive CRUD operations—specifically reading, creating, and updating resources—across key Stripe entities including charges, subscriptions, invoices, and payment intents. By handling authentication via standard environment variables (STRIPE_SECRET_KEY), the tool ensures that sensitive API operations are authenticated directly, providing a secure and reliable way to monitor business metrics and perform operational adjustments.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/codeninja23/native-stripe

Once installed, you must authenticate the skill by acquiring your API secret key from the Stripe Dashboard (Settings -> Developers -> API Keys). Set this as an environment variable in your system configuration: export STRIPE_SECRET_KEY=sk_live_your_secret_key_here It is highly recommended to use a test mode key (sk_test_...) during your initial configuration to ensure correct data retrieval before moving to production environment keys.

Use Cases

This skill is designed for developers, financial analysts, and business operators who need real-time visibility into their Stripe account. Common use cases include:

• Customer Support: Rapidly locating customer records by email to verify subscription status or invoice history.
• Operational Auditing: Monitoring the status of recent charges and payment intents to identify failures or disputes.
• Billing Management: Automating the retrieval of active subscription lists for churn analysis or reporting.
• Financial Reconciliation: Generating lists of refunds or balance transactions for accounting purposes.
• Customer Care: Updating customer metadata or contact information directly through the interface.

Example Prompts

1. "Find the customer associated with the email [email protected] and show me their active subscriptions."
2. "List the last 5 successful charges for this month and output the result in JSON format."
3. "Process a full refund for charge ID ch_12345 and let me know when it's done."

Tips & Limitations

• Output Control: Use the --json flag if you are piping the output into another script or processing it programmatically; otherwise, the tool defaults to a user-friendly table format.
• Pagination: Remember to adjust the --limit parameter if you are scanning through large datasets to avoid missing records or overloading your console.
• API Limits: Since this tool calls api.stripe.com directly, ensure you are aware of your Stripe account's rate limits, especially when scripting bulk updates.
• Scope: The current implementation is optimized for querying and minor management tasks. For highly complex workflows or bulk data migrations, verify the API endpoints covered by the stripe_query.py script.