vehicle-tracker

What This Skill Does

The vehicle-tracker skill is a robust solution designed for OpenClaw users to digitize and organize vehicle-related financial data. It functions as a digital logbook, recording gas expenses, scheduled maintenance, parts replacements, and general repairs. The skill bridges the gap between manual record-keeping and intelligent automation by supporting both cloud-based Google Sheets and local storage options. With built-in support for multiple languages (i18n), it automatically manages photo storage, renames files for better tracking, and interprets vehicle aliases to make logging faster. By leveraging category-specific defaults for quantities and units, the skill minimizes manual input, allowing users to keep their vehicle maintenance records precise and up-to-date with minimal friction.

Installation

To get started, follow these five steps:

1. Choose your preferred locale: en-US, zh-TW, or ja-JP.
2. Create a config.json file in skills/vehicle-tracker/ using the provided template.
3. Configure your category defaults based on your chosen unit system (metric/imperial). Copy these from the documentation into your config.json file.
4. Configure your vehicle storage. Add a Google Spreadsheet ID in the vehicles object to sync to the cloud, or leave it as null to use local Excel files stored in ~/vehicle_tracker/.
5. Optionally, add aliases in the configuration to map shorthand nicknames to full vehicle names. Finally, use clawhub install openclaw/skills/skills/huchengtw/vehicle-tracker to complete the installation.

Use Cases

• Expense Management: Keep track of every gas station visit, including price per liter or gallon, to analyze fuel consumption over time.
• Maintenance Tracking: Log oil changes, tire rotations, and major repairs to maintain a chronological history for resale value or warranty verification.
• Receipt Organization: Automatically save and timestamp photos of invoices and receipts so you never lose track of paper documents.
• Multi-Vehicle Oversight: Manage an entire household fleet within a single interface by using aliases and distinct configuration files.

Example Prompts

1. "Log 45 liters of gas for my Toyota Camry, cost 60 dollars, and save this receipt photo."
2. "Add a maintenance record for the BMW: 2 new tires, cost 300 dollars, category Repair."
3. "Show me the last 5 expense entries for my main car from the spreadsheet."

Tips & Limitations

• Tips: Always use the Google Sheets integration if you plan to access your data from multiple devices, as local files are trapped on the machine where the agent runs. Use meaningful aliases for your vehicles to save time during voice or text input.
• Limitations: The skill currently relies on the user to provide accurate categorical data; while defaults exist, manual oversight is required for irregular expenses. Ensure your Google Service Account has proper write permissions to the spreadsheet before attempting to sync data.