{"skill":{"slug":"clawreceipt","displayName":"ClawReceipt","summary":"Use this skill to extract receipt information, record expenses, track budgets, and manage financial receipts using the ClawReceipt CLI.","description":"---\nname: clawreceipt\ndescription: Use this skill to extract receipt information, record expenses, track budgets, and manage financial receipts using the ClawReceipt CLI.\n---\n\n# ClawReceipt Skill for OpenClaw\n\nUse this skill to interface with the ClawReceipt system whenever the user wants to process a receipt, check their monthly spending budget, or export financial data.\n\n## Trigger Conditions\n\nUse this skill when the user wants to:\n\n- Upload or provide a picture/text of a receipt to be recorded.\n- Add a new expense, bill, or receipt to the database.\n- Check their current total spend against their monthly budget.\n- Update their monthly spending budget.\n- List recent receipts/expenses.\n\n## Core Workflows\n\n### 1) Process and Add a Receipt\n\nWhen the user provides a receipt image or details, extract the relevant fields (Date, Time, Store, Amount, Category) and use the CLI to save it:\n\n1. Extract details using OCR or LLM vision capabilities.\n2. Ensure you have `date` (YYYY-MM-DD), `time` (HH:MM:SS, optional), `store` (string), `amount` (float), and `category` (string, e.g., \"อาหาร\", \"เดินทาง\", \"Shopping\").\n3. Run the CLI command in the ClawReceipt directory:\n\n   ```bash\n   python run.py add --date \"YYYY-MM-DD\" --time \"HH:MM:SS\" --store \"<Store>\" --amount <Amount> --category \"<Category>\"\n   ```\n\n4. Read the output to check if the budget was exceeded and relay that information to the user.\n\n### 2) Check Budget Status\n\nIf the user asks \"How much budget do I have left?\" or \"What is my total spend?\":\n\n1. Run:\n\n   ```bash\n   python run.py budget\n   ```\n\n2. Parse the output which includes \"Total Spent\" and \"Target Budget\" and accurately report to the user.\n3. Alert the user if the status indicates \"Exceeded Budget!\".\n\n### 3) Set New Budget\n\nIf the user wants to set a new monthly budget (e.g., \"Set my budget to 5000 baht\"):\n\n1. Run:\n\n   ```bash\n   python run.py budget --set <Amount>\n   ```\n\n2. Confirm to the user that the budget has been updated successfully.\n\n### 4) List All Receipts\n\nIf the user asks to see history or recently recorded receipts:\n\n1. Run:\n\n   ```bash\n   python run.py list\n   ```\n\n2. Summarize the output table for the user.\n\n### 5) Open TUI / Export (Interactive mode only)\n\nIf the user asks to see a beautiful dashboard or export to CSV/Excel, you can suggest they run:\n\n```bash\npython run.py tui\n```\n\n*(Note: As an agent, do not run the `tui` command directly as it will block the terminal. Instruct the user to run it themselves in a new terminal if they want to interact with the UI or manually export the data).*\n\n## Required Checks Before Execution\n\n- Verify `run.py` is present in the ClawReceipt root folder before calling.\n- Ensure the active Python environment has the required dependencies (`rich`, `pandas`, `openpyxl`, `textual`, etc.) by utilizing `.\\venv\\Scripts\\activate` if available.\n- Always quote string arguments like `--store \"Full Name\"` to prevent shell argument splitting.\n\n## Troubleshooting\n\n- `UnicodeEncodeError`: Ensure the terminal is using UTF-8 encoding. The `run.py` handles this internally for Windows, but be aware if piping output.\n- `unrecognized arguments`: Ensure parameters like `--category` are explicitly mapped and don't contain unescaped quotes.\n\n## Completion Checklist\n\n- Required fields accurately extracted and fed to the `add` command.\n- Command executed successfully (exit code 0).\n- Relevant confirmation (and budget alerts, if any) relayed back to the user clearly.\n","topics":["Financial"],"tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":791,"installsAllTime":30,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1772423915608,"updatedAt":1778994409412},"latestVersion":{"version":"1.0.0","createdAt":1772423915608,"changelog":"Initial release of the ClawReceipt skill for OpenClaw:\n\n- Enables extraction and recording of receipt information using the ClawReceipt CLI.\n- Allows users to add new expenses and categorize receipts.\n- Supports checking of current spend and monthly budget status.\n- Provides the ability to update the monthly budget and list recent receipts.\n- Guides users to launch the dashboard or export data, with clear terminal instructions and necessary pre-checks.","license":null},"metadata":null,"owner":{"handle":"sakurako-irs","userId":"s17cqndpd44kbsex5rq87f5k4s8846zc","displayName":"Sakurako","image":"https://avatars.githubusercontent.com/u/104028329?v=4"},"moderation":null}