Klutch Agentic Credit Card OpenClaw Skill. Manage virtual cards, transactions, and automated spending patterns.
OpenClaw skill for Klutch programmable credit card API integration.
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.
Set your Klutch API credentials:
# Option 1: Direct credentials
export KLUTCH_CLIENT_ID="your-client-id"
export KLUTCH_SECRET_KEY="your-secret-key"
# Option 2: 1Password CLI integration (requires 'op' CLI)
export KLUTCH_1PASSWORD_ITEM="Klutch API Credential"
The skill stores configuration and session tokens in ~/.config/klutch/:
~/.config/klutch/
├── config.json # User preferences
└── token.json # Cached session token (auto-managed)
Edit ~/.config/klutch/config.json to customize:
{
"api": {
"endpoint": "https://graphql.klutchcard.com/graphql",
"timeout": 30
}
}
# Check card information
python scripts/klutch.py balance
# Example output:
{
"cards": [
{
"id": "crd_xxx",
"name": "Martin Kessler",
"status": "ACTIVE"
}
]
}
# List recent transactions (last 30 days)
python scripts/klutch.py transactions
# Limit results
python scripts/klutch.py transactions --limit 25
# Example output:
{
"transactions": [
{
"id": "txn_xxx",
"amount": -100.0,
"merchantName": "Checking",
"transactionStatus": "SETTLED"
}
]
}
python scripts/klutch.py card list
python scripts/klutch.py card categories
python scripts/klutch.py card spending
# Get configuration value
python scripts/klutch.py config get api.timeout
# Set configuration value
python scripts/klutch.py config set api.timeout 60
# View all configuration
python scripts/klutch.py config get
The skill connects to Klutch's GraphQL API:
| Environment | Endpoint |
|---|---|
| Production | https://graphql.klutchcard.com/graphql |
| Sandbox | https://sandbox.klutchcard.com/graphql |
The skill uses Klutch's session token authentication:
createSessionToken mutation with Client ID and Secret Key~/.config/klutch/token.jsonThe Klutch skill enables agents to handle their own budget or provide personal finance assistance.
The skill handles common error scenarios:
# OpenClaw can invoke the skill directly
klutch balance
klutch transactions --limit 5
klutch card list
If you receive authentication errors:
python scripts/klutch.py config get~/.config/klutch/token.json to force re-authenticationForce token refresh:
rm ~/.config/klutch/token.json
~/.config/klutch/token.json