Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Schedules Tesla charging on specified dates with target battery % and times, managing charge limits during and after sessions for battery health.
Schedules Tesla charging on specified dates with target battery % and times, managing charge limits during and after sessions for battery health.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
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.
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.
Schedule Tesla charging to reach target battery % by a specific time. Runs daily via cron to check a schedule file and only charges on configured dates.
Required: Environment variable: TESLA_EMAIL (your Tesla account email) Skill dependency: tesla skill must be installed and properly configured with Tesla API credentials Security improvements (v1.1.0+): β No shell injection risk: Uses argument lists instead of shell=True β Email validation: TESLA_EMAIL is validated before use β Input validation: Charge limits are validated (0-100% range) β Secure env passing: Credentials passed via environment variables, not string interpolation β Explicit dependencies: Metadata declares required env vars and skill dependencies
Copy the example schedule file: cp skills/tesla-smart-charge/references/tesla-charge-schedule-example.json \ memory/tesla-charge-schedule.json Edit memory/tesla-charge-schedule.json with your planned charge dates: { "charges": [ { "date": "2026-02-01", "target_battery": 100, "target_time": "08:00" }, { "date": "2026-02-03", "target_battery": 80, "target_time": "07:00" } ] }
clawdbot cron add \ --name "Tesla daily charge check" \ --schedule "0 0 * * *" \ --task "TESLA_EMAIL=your@email.com python3 /path/to/skills/tesla-smart-charge/scripts/tesla-smart-charge.py --check-schedule"
For better charge limit management, run both: At midnight (initialize daily charge): clawdbot cron add \ --name "Tesla daily charge check" \ --schedule "0 0 * * *" \ --task "TESLA_EMAIL=your@email.com python3 /path/to/skills/tesla-smart-charge/scripts/tesla-smart-charge.py --check-schedule" Every 30 minutes during active hours (manage session limits): clawdbot cron add \ --name "Tesla session management" \ --schedule "*/30 8-23 * * *" \ --task "TESLA_EMAIL=your@email.com python3 /path/to/skills/tesla-smart-charge/scripts/tesla-smart-charge.py --manage-session" The second job ensures charge limits are properly updated throughout the day: β During session: Maintains 100% (or user-specified) limit β After session: Applies 80% (or user-specified) limit for battery health
Each day at midnight (or whenever cron runs): Script checks memory/tesla-charge-schedule.json If today's date is in the charges array β executes charge plan Fetches current battery level Calculates optimal start time Sets charge limit to session limit (default 100%) Displays charge details Shows next scheduled charge date If today is NOT scheduled β applies post-charge limit Sets charge limit to default 80% (or user-specified) Still displays next scheduled charge date Session Management: During charge session: Charge limit = charge_limit_percent (default 100%) After charge session expires: Charge limit = post_charge_limit_percent (default 80%) Result: One cron job that handles both charging and limit management β no need to create new jobs for each date!
{ "charges": [ { "date": "2026-02-01", "target_battery": 100, "target_time": "08:00", "charge_limit_percent": 100, "post_charge_limit_percent": 80 }, { "date": "2026-02-03", "target_battery": 80, "target_time": "07:00", "charge_limit_percent": 100, "post_charge_limit_percent": 80 } ] } Fields: date: YYYY-MM-DD format (when to charge) target_battery: Target battery % (default: 100) target_time: HH:MM when charging should complete (default: 08:00) charge_limit_percent: Charge limit during session (default: 100%, optional) post_charge_limit_percent: Charge limit after session ends (default: 80%, optional)
export TESLA_EMAIL="your@email.com"
Default: 2.99 kW (home charger, ~13A @ 230V) Adjust in cron task or when calling manually: --charger-power 3.7 # 16A @ 230V --charger-power 7.4 # 32A @ 230V (dual-phase)
TESLA_EMAIL="your@email.com" python3 scripts/tesla-smart-charge.py --check-schedule Output: β If scheduled: Shows charge plan + charge limits + next date β If not scheduled: Shows next scheduled date + applies default 80% limit
TESLA_EMAIL="your@email.com" python3 scripts/tesla-smart-charge.py --manage-session This command: Checks if today's charge session is active During session: Sets charge limit to session limit (default 100%) After session: Sets charge limit to post-charge limit (default 80%) No session: Applies default 80% limit Tip: Run this hourly or every 30 minutes during active charging days for real-time limit management.
python3 scripts/tesla-smart-charge.py --show-schedule
python3 scripts/tesla-smart-charge.py --show-plan
{ "charges": [ {"date": "2026-02-02", "target_battery": 100, "target_time": "08:00"}, {"date": "2026-02-03", "target_battery": 100, "target_time": "08:00"}, {"date": "2026-02-04", "target_battery": 100, "target_time": "08:00"}, {"date": "2026-02-05", "target_battery": 100, "target_time": "08:00"}, {"date": "2026-02-06", "target_battery": 100, "target_time": "08:00"} ] }
{ "charges": [ {"date": "2026-02-01", "target_battery": 80, "target_time": "07:00"}, {"date": "2026-02-04", "target_battery": 80, "target_time": "07:00"}, {"date": "2026-02-07", "target_battery": 80, "target_time": "07:00"} ] }
{ "charges": [ {"date": "2026-02-01", "target_battery": 100, "target_time": "08:00"}, {"date": "2026-02-02", "target_battery": 80, "target_time": "07:00"}, {"date": "2026-02-03", "target_battery": 60, "target_time": "06:00"} ] }
Charge time is calculated as: energy_needed_kwh = (battery_capacity Γ (target - current) / 100) / charge_efficiency charge_time_hours = energy_needed_kwh / charger_power_kw start_time = target_time - charge_time_hours - margin_minutes Where: battery_capacity: Vehicle battery size (kWh, default: 75) charger_power_kw: Your charger's power (kW, default: 2.99) charge_efficiency: ~0.92 (typical AC charging) margin_minutes: Buffer before target (default: 5 min) Example: 75 kWh battery at 50%, charging to 100% by 08:00 with 2.99 kW: Energy needed: (75 Γ 50% / 100) / 0.92 = 40.8 kWh Charge time: 40.8 / 2.99 β 13.6 hours Start time: 08:00 - 13.6h - 5min β 18:25 previous day
Add new charges: Edit memory/tesla-charge-schedule.json β cron picks up changes on next run Plan ahead: Add weeks of charges in advance, script handles date logic One cron job: No need to create separate jobs β one daily check does it all See what's next: Each run displays the next scheduled charge date
When calling manually with --target-time: python3 scripts/tesla-smart-charge.py \ --target-time "HH:MM" \ --target-battery 100 \ --charger-power 2.99 \ --battery-capacity 75 \ --margin-minutes 5 For schedule-based operation, use --check-schedule (reads from JSON file).
CRON_SETUP.md - Full cron integration guide API_REFERENCE.md - Advanced parameters and formulas tesla-charge-schedule-example.json - Schedule file template
Agent frameworks, memory systems, reasoning layers, and model-native orchestration.
Largest current source with strong distribution and engagement signals.