sleep-health-assistant

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

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

   text

   /sleep-health analyze-stress
   

   Analyze current stress level and get recommendations

2. Sleep analysis

   text

   /sleep-health analyze-sleep
   

   Analyze sleep quality and get optimization suggestions

3. Audio guidance

   text

   /sleep-health audio-guidance [protocol]
   

   Start audio guidance session (relaxation, sleep, focus)

4. Breathing guidance

   text

   /sleep-health breathing-guidance [technique]
   

   Guide breathing exercise (calm_breathing, sleep_breathing, energy_breathing)

5. Mindfulness guidance

   text

   /sleep-health mindfulness-guidance [practice]
   

   Guide mindfulness practice (awareness, relaxation, compassion)

Advanced Commands

6. Health monitoring

   text

   /sleep-health health-monitoring
   

   Monitor health based on user-provided data

7. Get status

   text

   /sleep-health status
   

   Check skill status and version

8. Cleanup session

   text

   /sleep-health cleanup
   

   Clear session data from memory

Installation

OpenClaw Installation

bash

# 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

text

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

bash

# 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