Klutch Skill

OpenClaw skill for Klutch programmable credit card API integration.

Overview

This skill provides a command-line interface for accessing Klutch credit card data through their GraphQL API. It supports viewing card information, transaction history, spending categories, and spending analysis.

Prerequisites

1. 1. Klutch Account: Active Klutch credit card account
2. API Credentials: Client ID and Secret Key from Klutch developer portal
3. Python 3.10+: Required for running the scripts

Configuration

Environment Variables

Set your Klutch API credentials:

CODEBLOCK0

Configuration File

The skill stores configuration and session tokens in ~/.config/klutch/:

CODEBLOCK1

Configuration Options

Edit ~/.config/klutch/config.json to customize:

CODEBLOCK2

Commands Reference

Balance

CODEBLOCK3

Transactions

CODEBLOCK4

Card Management

List Cards

CODEBLOCK5

View Categories

CODEBLOCK6

View Spending by Category

CODEBLOCK7

Configuration Management

CODEBLOCK8

API Endpoints

The skill connects to Klutch's GraphQL API:

Authentication Flow

The skill uses Klutch's session token authentication:

1. 1. Initial Request: Sends createSessionToken mutation with Client ID and Secret Key
2. Token Caching: Stores the JWT session token in INLINECODE5
3. Subsequent Requests: Uses cached token until it expires
4. Auto-Refresh: Creates a new session token when the cached one fails

Hypothetical Agent Use Cases

The Klutch skill enables agents to handle their own budget or provide personal finance assistance.

• * Sub-Agent Budgeting: Create a virtual card for a sub-agent to pay for its own usage (AWS, OpenAI) with a hard limit.
• Budget Guardrails: Monitor spending categories (e.g., 'FOOD') and alert the user if they exceed a monthly budget.
• Transaction Alerts: Watch for specific merchants or unusual activity and notify the user immediately.
• Expense Summary: Summarize monthly spending and categorize transactions for personal journaling.

Error Handling

The skill handles common error scenarios:

• - Authentication failures: Prompts to verify credentials
• Session expiration: Automatically creates a new session token
• Network errors: Clear error messages with retry suggestions
• GraphQL errors: Detailed error messages from the API

Integration with OpenClaw

Using from OpenClaw Sessions

CODEBLOCK9

Troubleshooting

Authentication Issues

If you receive authentication errors:

1. 1. Verify your credentials with INLINECODE6
2. Delete ~/.config/klutch/token.json to force re-authentication
3. Check that your API credentials are correct

Session Token Issues

Force token refresh:
CODEBLOCK10

Security Notes

• - Never commit credentials to version control
• The skill stores tokens in INLINECODE8
• Session tokens are refreshed automatically when needed