# Send Klutch to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "klutch",
    "name": "Klutch",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/kesslerio/klutch",
    "canonicalUrl": "https://clawhub.ai/kesslerio/klutch",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/klutch",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=klutch",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "config/klutch.example.json",
      "requirements.txt",
      "scripts/auth.py",
      "scripts/klutch.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "klutch",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-04T18:13:08.552Z",
      "expiresAt": "2026-05-11T18:13:08.552Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=klutch",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=klutch",
        "contentDisposition": "attachment; filename=\"klutch-0.3.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "klutch"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/klutch"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/klutch",
    "downloadUrl": "https://openagent3.xyz/downloads/klutch",
    "agentUrl": "https://openagent3.xyz/skills/klutch/agent",
    "manifestUrl": "https://openagent3.xyz/skills/klutch/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/klutch/agent.md"
  }
}
```
## Documentation

### 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

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

### Environment Variables

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"

### Configuration File

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

~/.config/klutch/
├── config.json      # User preferences
└── token.json       # Cached session token (auto-managed)

### Configuration Options

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

{
  "api": {
    "endpoint": "https://graphql.klutchcard.com/graphql",
    "timeout": 30
  }
}

### Balance

# Check card information
python scripts/klutch.py balance

# Example output:
{
  "cards": [
    {
      "id": "crd_xxx",
      "name": "Martin Kessler",
      "status": "ACTIVE"
    }
  ]
}

### Transactions

# 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"
    }
  ]
}

### Card Management

List Cards

python scripts/klutch.py card list

View Categories

python scripts/klutch.py card categories

View Spending by Category

python scripts/klutch.py card spending

### Configuration Management

# 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

### API Endpoints

The skill connects to Klutch's GraphQL API:

EnvironmentEndpointProductionhttps://graphql.klutchcard.com/graphqlSandboxhttps://sandbox.klutchcard.com/graphql

### Authentication Flow

The skill uses Klutch's session token authentication:

Initial Request: Sends createSessionToken mutation with Client ID and Secret Key
Token Caching: Stores the JWT session token in ~/.config/klutch/token.json
Subsequent Requests: Uses cached token until it expires
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

### Using from OpenClaw Sessions

# OpenClaw can invoke the skill directly
klutch balance
klutch transactions --limit 5
klutch card list

### Authentication Issues

If you receive authentication errors:

Verify your credentials with python scripts/klutch.py config get
Delete ~/.config/klutch/token.json to force re-authentication
Check that your API credentials are correct

### Session Token Issues

Force token refresh:

rm ~/.config/klutch/token.json

### Security Notes

Never commit credentials to version control
The skill stores tokens in ~/.config/klutch/token.json
Session tokens are refreshed automatically when needed
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: kesslerio
- Version: 0.3.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-04T18:13:08.552Z
- Expires at: 2026-05-11T18:13:08.552Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/klutch)
- [Send to Agent page](https://openagent3.xyz/skills/klutch/agent)
- [JSON manifest](https://openagent3.xyz/skills/klutch/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/klutch/agent.md)
- [Download page](https://openagent3.xyz/downloads/klutch)