Maintenance Scheduler

Create a custom maintenance task

# Create a weekly task
npx maintenance-scheduler create "Water plants" weekly --days 7

# Create a monthly task with advance notice
npx maintenance-scheduler create "Check smoke detectors" monthly --days 30 --notice-days 3

# Create a quarterly task
npx maintenance-scheduler create "Service HVAC" custom --days 90 --notice-days 7

# Create an annual task
npx maintenance-scheduler create "Clean gutters" custom --days 365 --notice-days 14

List upcoming tasks

# Show all upcoming tasks
npx maintenance-scheduler upcoming

# Show tasks due in next 30 days
npx maintenance-scheduler upcoming 30

# Show tasks due today
npx maintenance-scheduler due

Complete a task

npx maintenance-scheduler complete 123

When you complete a recurring task, the next occurrence is automatically scheduled.

View completion history

# View recent completions
npx maintenance-scheduler history

# View more entries
npx maintenance-scheduler history --limit 50

Manage tasks

# List all tasks
npx maintenance-scheduler list

# Get task details
npx maintenance-scheduler get 123

# Update a task
npx maintenance-scheduler update 123 --name "New name" --days 14

# Delete a task
npx maintenance-scheduler delete 123

Templates

# List available templates
npx maintenance-scheduler templates

# Preview what tasks a template will create
npx maintenance-scheduler preview-template house

Statistics

# View completion statistics
npx maintenance-scheduler stats

# Check system health
npx maintenance-scheduler health

Seasonal Templates

House Template

Monthly tasks:

• Check HVAC filters
• Test smoke and CO detectors
• Inspect plumbing for leaks

Quarterly tasks:

• Clean gutters
• Inspect roof
• Service garage door

Bi-annual tasks:

• Deep clean carpets
• Service major appliances
• Inspect exterior paint

Annual tasks:

• Professional HVAC service
• Chimney inspection
• Septic system check

Apartment Template

Monthly tasks:

• Check smoke detectors
• Clean AC filters
• Inspect faucets for leaks

Quarterly tasks:

• Deep clean appliances
• Check weather stripping

Annual tasks:

• Deep clean carpets
• Professional AC service
• Safety inspection

Condo Template

Monthly tasks:

• Check detectors and filters
• Inspect for moisture

Quarterly tasks:

• Clean balcony/terrace
• Service appliances

Annual tasks:

• Deep cleaning
• Maintenance inspection

API Usage

import { MaintenanceSchedulerSkill } from '@openclaw/maintenance-scheduler';

const scheduler = new MaintenanceSchedulerSkill();

// Apply a template
await scheduler.applyTemplate('house');

// Create a custom task
const task = await scheduler.createTask({
  name: 'Water plants',
  frequencyDays: 7,
  advanceNoticeDays: 1,
  category: 'indoor'
});

// Get upcoming tasks
const upcoming = await scheduler.getUpcomingTasks(30);
for (const item of upcoming) {
  console.log(`${item.task.name} due in ${item.daysUntil} days`);
}

// Complete a task (auto-schedules next occurrence)
await scheduler.completeTask(task.id);

// View completion history
const history = await scheduler.getCompletionHistory(20);

// Close connection
await scheduler.close();

Storage

SQLite database at ~/.openclaw/skills/maintenance-scheduler/maintenance.db:

• tasks - Maintenance tasks with schedule configuration
• completion_history - Record of completed tasks

Integration with Reminders Skill

This skill depends on the reminders skill to create notification reminders. When a task is created or completed, a reminder is automatically scheduled based on the advance notice configuration.