ClawHub

sleep-health-assistant

Other

Provides local, science-based analysis of sleep and stress with personalized guidance in relaxation, breathing, mindfulness, and wellness habits.

Install

openclaw skills install sleep-health-assistant

Sleep Health Assistant Skill

Overview

The Sleep Health Assistant Skill is an OpenClaw plugin that provides scientific sleep analysis, stress assessment, and evidence-based wellness guidance. This skill focuses on modern, research-backed techniques for sleep improvement and stress management.

Features

1. Stress Analysis System

  • Stress assessment: Analysis based on user-provided physiological data
  • Personalized recommendations: Customized suggestions based on stress patterns
  • Privacy-focused: 100% local processing, no data storage

2. Sleep Analysis System

  • Sleep quality assessment: Analysis of sleep duration and quality
  • Evidence-based suggestions: Research-backed recommendations
  • Sleep hygiene guidance: Practical tips for better sleep

3. Audio Guidance System

  • Relaxation guidance: Audio instructions for stress reduction
  • Sleep preparation: Guidance for better sleep readiness
  • Focus enhancement: Audio techniques for improved concentration

4. Breathing Guidance System

  • Calm breathing: Techniques for stress reduction
  • Sleep breathing: Patterns for sleep preparation
  • Energy breathing: Methods for increased alertness

5. Mindfulness Guidance System

  • Awareness practice: Present moment focus techniques
  • Relaxation practice: Progressive relaxation methods
  • Compassion practice: Positive emotion cultivation

6. Health Monitoring System

  • User-data monitoring: Analysis based on provided information
  • In-memory processing: No disk storage, no data persistence
  • Privacy assurance: 100% local, no external transmission

Security Declaration

Core Security Principles

  1. 100% local operation: No network access, all processing done locally
  2. No dangerous functions: No use of subprocess, eval, exec, __import__
  3. Memory-only storage: Session data stored in memory only, not written to disk
  4. No file operations: No reading or writing of system files
  5. Input validation: Strict validation of all input data

Security Implementation

  • No network modules: No socket, requests, urllib, or http.client usage
  • Standard library only: Uses only Python standard library modules
  • Transparent code: All source code available for review
  • Privacy protection: No data collection or transmission

Scientific Basis

Evidence-Based Techniques

  1. Stress management research: Evidence-based stress reduction techniques
  2. Sleep hygiene research: Scientifically validated sleep improvement methods
  3. Respiratory physiology: Breathing regulation for stress management
  4. Mindfulness research: Research-backed mindfulness practices
  5. Cognitive behavioral principles: CBT-inspired techniques

Content Policy

  • ✅ Modern scientific techniques: Focus on evidence-based methods
  • ✅ Cultural neutrality: No culture-specific or traditional methods
  • ✅ Educational focus: For self-improvement and education only
  • ❌ No religious content: Excluded religious practices and terminology
  • ❌ No medical advice: Not a substitute for professional healthcare
  • ❌ No external dependencies: Uses only Python standard library

Commands

Basic Commands

  1. Stress analysis

    /sleep-health analyze-stress

    Analyze current stress level and get recommendations

  2. Sleep analysis

    /sleep-health analyze-sleep

    Analyze sleep quality and get optimization suggestions

  3. Audio guidance

    /sleep-health audio-guidance [protocol]

    Start audio guidance session (relaxation, sleep, focus)

  4. Breathing guidance

    /sleep-health breathing-guidance [technique]

    Guide breathing exercise (calm_breathing, sleep_breathing, energy_breathing)

  5. Mindfulness guidance

    /sleep-health mindfulness-guidance [practice]

    Guide mindfulness practice (awareness, relaxation, compassion)

Advanced Commands

  1. Health monitoring

    /sleep-health health-monitoring

    Monitor health based on user-provided data

  2. Get status

    /sleep-health status

    Check skill status and version

  3. Cleanup session

    /sleep-health cleanup

    Clear session data from memory

Installation

OpenClaw Installation

# Install via ClawHub
npx clawhub install sleep-health-assistant

Manual Installation

  1. Download the skill package
  2. Extract to OpenClaw skills directory
  3. Restart OpenClaw

Configuration

Basic Configuration

Edit config.yaml to customize:

  • Feature enable/disable
  • Default protocols and techniques
  • Performance settings

No Environment Variables

No environment variables required. The skill operates entirely locally.

Performance

Response Times

  • Command response: < 100ms
  • Stress analysis: < 500ms
  • Sleep analysis: < 500ms
  • Guidance generation: < 200ms

Resource Usage

  • Memory usage: < 50MB
  • CPU usage: < 5%
  • Disk usage: Configuration files only

Compatibility

Supported Platforms

  • Operating Systems: Windows, macOS, Linux
  • Python Versions: 3.8+
  • OpenClaw Versions: 2026.3+
  • Architectures: x86_64, arm64

Dependencies

  • Required: None (uses Python standard library only)
  • Optional: None

Development

Code Structure

skill.py              # Main skill implementation
config.yaml          # Configuration file
SKILL.md            # This documentation
README.md           # User guide
CHANGELOG.md        # Version history
requirements.txt    # Dependency list (empty)

Testing

# Run basic tests
python -c "from skill import SleepHealthAssistantSkill; skill = SleepHealthAssistantSkill(); print(skill.handle_command('status'))"

Troubleshooting

Common Issues

  1. Command not recognized: Ensure skill is properly installed
  2. No response: Check OpenClaw logs for errors
  3. Performance issues: Verify system meets minimum requirements

Logs

Check OpenClaw logs for detailed error information:

  • Installation logs
  • Runtime logs
  • Error logs

Support

Documentation

  • Full documentation: This file (SKILL.md)
  • User guide: README.md
  • Configuration: config.yaml
  • Changelog: CHANGELOG.md

Issues

Report issues via appropriate channels.

License

MIT License

Version

Current version: 1.0.0

Contact

  • Maintainer: OpenClaw Assistant
  • Community: OpenClaw community
  • Updates: Check ClawHub for latest version

Important Notes

Privacy and Security

  • All processing is 100% local
  • No data is stored on disk
  • No data is transmitted externally
  • No network access is required

Scope and Limitations

  • This skill is for educational and self-improvement purposes only
  • It is not a substitute for professional medical advice
  • Users should consult healthcare professionals for medical concerns

Content Policy

  • Focuses on modern, evidence-based techniques
  • Excludes religious and culture-specific content
  • Maintains scientific and educational focus