{
  "schemaVersion": "1.0",
  "item": {
    "slug": "billclaw",
    "name": "Billclaw",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/xBinKai/billclaw",
    "canonicalUrl": "https://clawhub.ai/xBinKai/billclaw",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/billclaw",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=billclaw",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SECURITY.md",
      "SKILL.md",
      "scripts/validate-skill.sh"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "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. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/billclaw"
    },
    "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/billclaw",
    "agentPageUrl": "https://openagent3.xyz/skills/billclaw/agent",
    "manifestUrl": "https://openagent3.xyz/skills/billclaw/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/billclaw/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "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. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "BillClaw - Financial Data Management for OpenClaw",
        "body": "Complete financial data management for OpenClaw with local-first architecture. Sync bank transactions, fetch bills from email, and export to accounting formats."
      },
      {
        "title": "Security & Trust",
        "body": "BillClaw is safe, open-source software designed with security-first principles."
      },
      {
        "title": "Verification",
        "body": "Transparent packages: All npm packages are open-source and published with provenance\nAuditable code: Full source available at GitHub\nnpm provenance: Cryptographic proof linking packages to source code\nLocal-first: Your financial data never leaves your machine\nUser-controlled credentials: You provide all API credentials through your own accounts\nSystem keychain: Tokens encrypted in your platform's secure keychain\nExplicit invocation: Requires explicit user action (disable-model-invocation: true)\n\nSee SECURITY.md for detailed security architecture and verification steps."
      },
      {
        "title": "Addressing Security Concerns",
        "body": "ConcernExplanationsets-process-nameComes from transitive npm dependencies, not BillClaw codedetect-debug-environmentCommon Node.js ecosystem pattern, not maliciousAPI credentialsRequired for functionality; you control them from your accountsExternal packagesAll packages are open-source with npm provenance"
      },
      {
        "title": "Required Credentials",
        "body": "Important: Credentials are NOT required at install time. Configure them when you're ready to use specific features:\n\nEnvironment VariablePurposeRequired ForPLAID_CLIENT_IDPlaid API client IDPlaid bank syncPLAID_SECRETPlaid API secretPlaid bank syncGMAIL_CLIENT_IDGmail OAuth client IDGmail bill fetchingGMAIL_CLIENT_SECRETGmail OAuth client secretGmail bill fetching\n\nObtain credentials from:\n\nPlaid: https://dashboard.plaid.com/\nGmail: https://console.cloud.google.com/apis/credentials\n\nConfigure via:\n\nEnvironment variables (recommended)\nConfiguration file (~/.firela/billclaw/config.json)\nOpenClaw config under skills.entries.billclaw.env"
      },
      {
        "title": "1. Install the Plugin",
        "body": "npm install @firela/billclaw-openclaw\n\nThe plugin registers these tools and commands with OpenClaw:\n\nTools: plaid_sync, gmail_fetch, conversational_sync, conversational_status\nCommands: /billclaw-setup, /billclaw-sync, /billclaw-status, /billclaw-config"
      },
      {
        "title": "2. Configure Credentials",
        "body": "When you're ready to use a feature, configure the required credentials:\n\n# For Plaid bank sync\nexport PLAID_CLIENT_ID=\"your_client_id\"\nexport PLAID_SECRET=\"your_secret\"\n\n# For Gmail bill fetching\nexport GMAIL_CLIENT_ID=\"your_client_id\"\nexport GMAIL_CLIENT_SECRET=\"your_secret\""
      },
      {
        "title": "3. Setup Your Accounts",
        "body": "/billclaw-setup\n\nThe interactive wizard will guide you through:\n\nConnecting bank accounts (Plaid/GoCardless)\nConfiguring Gmail for bill fetching\nSetting local storage location"
      },
      {
        "title": "4. Sync Your Data",
        "body": "You: Sync my bank transactions for last month\n\nOpenClaw: [Uses plaid_sync tool from BillClaw plugin]\nSynced 127 transactions from checking account\n\nOr use the command directly:\n\n/billclaw-sync --from 2024-01-01 --to 2024-12-31"
      },
      {
        "title": "5. Export to Accounting Formats",
        "body": "/billclaw-export --format beancount --output 2024.beancount"
      },
      {
        "title": "OpenClaw Integration",
        "body": "This skill provides instructions for using BillClaw with OpenClaw. The actual integration is provided by the @firela/billclaw-openclaw npm package."
      },
      {
        "title": "Available Tools (via Plugin)",
        "body": "plaid_sync - Sync bank transactions from Plaid\ngmail_fetch - Fetch bills from Gmail\nconversational_sync - Natural language sync interface\nconversational_status - Check sync status"
      },
      {
        "title": "Available Commands (via Plugin)",
        "body": "/billclaw-setup - Configure accounts\n/billclaw-sync - Sync transactions\n/billclaw-status - View status\n/billclaw-config - Manage configuration"
      },
      {
        "title": "Standalone CLI",
        "body": "For users who prefer a command-line interface, the standalone CLI is available as a separate npm package. See https://github.com/fire-la/billclaw for installation instructions."
      },
      {
        "title": "Connect OAuth Server",
        "body": "For self-hosted OAuth flows, the Connect server is available as a separate npm package. See https://github.com/fire-la/billclaw for configuration details."
      },
      {
        "title": "Data Sources",
        "body": "SourceDescriptionRegionsPlaidBank transaction syncUS, CanadaGoCardlessEuropean bank integrationEuropeGmailBill fetching via emailGlobal"
      },
      {
        "title": "Storage",
        "body": "Location: ~/.firela/billclaw/ (your home directory)\nFormat: JSON files with monthly partitioning\nSecurity: Local-only storage"
      },
      {
        "title": "Configuration",
        "body": "Configuration is stored in ~/.firela/billclaw/config.json:\n\n{\n  \"plaid\": {\n    \"clientId\": \"your_client_id\",\n    \"secret\": \"your_secret\",\n    \"environment\": \"sandbox\"\n  },\n  \"gmail\": {\n    \"clientId\": \"your_gmail_client_id\",\n    \"clientSecret\": \"your_gmail_client_secret\"\n  }\n}"
      },
      {
        "title": "Beancount",
        "body": "2024/01/15 * \"Starbucks\"\n  Expenses:Coffee\n  Liabilities:CreditCard:Visa\n    $5.50"
      },
      {
        "title": "Ledger",
        "body": "2024/01/15 Starbucks\n  Expenses:Coffee  $5.50\n  Liabilities:Credit Card:Visa"
      },
      {
        "title": "Getting Help",
        "body": "Documentation: https://github.com/fire-la/billclaw\nIssues: https://github.com/fire-la/billclaw/issues\nSecurity: Report security vulnerabilities privately at security@fire-la.dev\nnpm packages: https://www.npmjs.com/org/firela"
      }
    ],
    "body": "BillClaw - Financial Data Management for OpenClaw\n\nComplete financial data management for OpenClaw with local-first architecture. Sync bank transactions, fetch bills from email, and export to accounting formats.\n\nSecurity & Trust\n\nBillClaw is safe, open-source software designed with security-first principles.\n\nVerification\nTransparent packages: All npm packages are open-source and published with provenance\nAuditable code: Full source available at GitHub\nnpm provenance: Cryptographic proof linking packages to source code\nLocal-first: Your financial data never leaves your machine\nUser-controlled credentials: You provide all API credentials through your own accounts\nSystem keychain: Tokens encrypted in your platform's secure keychain\nExplicit invocation: Requires explicit user action (disable-model-invocation: true)\n\nSee SECURITY.md for detailed security architecture and verification steps.\n\nAddressing Security Concerns\nConcern\tExplanation\nsets-process-name\tComes from transitive npm dependencies, not BillClaw code\ndetect-debug-environment\tCommon Node.js ecosystem pattern, not malicious\nAPI credentials\tRequired for functionality; you control them from your accounts\nExternal packages\tAll packages are open-source with npm provenance\nRequired Credentials\n\nImportant: Credentials are NOT required at install time. Configure them when you're ready to use specific features:\n\nEnvironment Variable\tPurpose\tRequired For\nPLAID_CLIENT_ID\tPlaid API client ID\tPlaid bank sync\nPLAID_SECRET\tPlaid API secret\tPlaid bank sync\nGMAIL_CLIENT_ID\tGmail OAuth client ID\tGmail bill fetching\nGMAIL_CLIENT_SECRET\tGmail OAuth client secret\tGmail bill fetching\n\nObtain credentials from:\n\nPlaid: https://dashboard.plaid.com/\nGmail: https://console.cloud.google.com/apis/credentials\n\nConfigure via:\n\nEnvironment variables (recommended)\nConfiguration file (~/.firela/billclaw/config.json)\nOpenClaw config under skills.entries.billclaw.env\nQuick Start (OpenClaw)\n1. Install the Plugin\nnpm install @firela/billclaw-openclaw\n\n\nThe plugin registers these tools and commands with OpenClaw:\n\nTools: plaid_sync, gmail_fetch, conversational_sync, conversational_status\nCommands: /billclaw-setup, /billclaw-sync, /billclaw-status, /billclaw-config\n2. Configure Credentials\n\nWhen you're ready to use a feature, configure the required credentials:\n\n# For Plaid bank sync\nexport PLAID_CLIENT_ID=\"your_client_id\"\nexport PLAID_SECRET=\"your_secret\"\n\n# For Gmail bill fetching\nexport GMAIL_CLIENT_ID=\"your_client_id\"\nexport GMAIL_CLIENT_SECRET=\"your_secret\"\n\n3. Setup Your Accounts\n/billclaw-setup\n\n\nThe interactive wizard will guide you through:\n\nConnecting bank accounts (Plaid/GoCardless)\nConfiguring Gmail for bill fetching\nSetting local storage location\n4. Sync Your Data\nYou: Sync my bank transactions for last month\n\nOpenClaw: [Uses plaid_sync tool from BillClaw plugin]\nSynced 127 transactions from checking account\n\n\nOr use the command directly:\n\n/billclaw-sync --from 2024-01-01 --to 2024-12-31\n\n5. Export to Accounting Formats\n/billclaw-export --format beancount --output 2024.beancount\n\nOpenClaw Integration\n\nThis skill provides instructions for using BillClaw with OpenClaw. The actual integration is provided by the @firela/billclaw-openclaw npm package.\n\nAvailable Tools (via Plugin)\nplaid_sync - Sync bank transactions from Plaid\ngmail_fetch - Fetch bills from Gmail\nconversational_sync - Natural language sync interface\nconversational_status - Check sync status\nAvailable Commands (via Plugin)\n/billclaw-setup - Configure accounts\n/billclaw-sync - Sync transactions\n/billclaw-status - View status\n/billclaw-config - Manage configuration\nAdditional Components (Optional)\nStandalone CLI\n\nFor users who prefer a command-line interface, the standalone CLI is available as a separate npm package. See https://github.com/fire-la/billclaw for installation instructions.\n\nConnect OAuth Server\n\nFor self-hosted OAuth flows, the Connect server is available as a separate npm package. See https://github.com/fire-la/billclaw for configuration details.\n\nData Sources\nSource\tDescription\tRegions\nPlaid\tBank transaction sync\tUS, Canada\nGoCardless\tEuropean bank integration\tEurope\nGmail\tBill fetching via email\tGlobal\nStorage\nLocation: ~/.firela/billclaw/ (your home directory)\nFormat: JSON files with monthly partitioning\nSecurity: Local-only storage\nConfiguration\n\nConfiguration is stored in ~/.firela/billclaw/config.json:\n\n{\n  \"plaid\": {\n    \"clientId\": \"your_client_id\",\n    \"secret\": \"your_secret\",\n    \"environment\": \"sandbox\"\n  },\n  \"gmail\": {\n    \"clientId\": \"your_gmail_client_id\",\n    \"clientSecret\": \"your_gmail_client_secret\"\n  }\n}\n\nExport Formats\nBeancount\n2024/01/15 * \"Starbucks\"\n  Expenses:Coffee\n  Liabilities:CreditCard:Visa\n    $5.50\n\nLedger\n2024/01/15 Starbucks\n  Expenses:Coffee  $5.50\n  Liabilities:Credit Card:Visa\n\nGetting Help\nDocumentation: https://github.com/fire-la/billclaw\nIssues: https://github.com/fire-la/billclaw/issues\nSecurity: Report security vulnerabilities privately at security@fire-la.dev\nnpm packages: https://www.npmjs.com/org/firela"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/xBinKai/billclaw",
    "publisherUrl": "https://clawhub.ai/xBinKai/billclaw",
    "owner": "xBinKai",
    "version": "0.5.5",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/billclaw",
    "downloadUrl": "https://openagent3.xyz/downloads/billclaw",
    "agentUrl": "https://openagent3.xyz/skills/billclaw/agent",
    "manifestUrl": "https://openagent3.xyz/skills/billclaw/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/billclaw/agent.md"
  }
}