caffeine

What This Skill Does

The caffeine skill for OpenClaw is a powerful utility designed to maintain system uptime by preventing your computer from entering sleep mode, screen dimming, or system idle states. On macOS, it leverages the native caffeinate utility, which provides fine-grained control over display and system power management. On Windows, the skill provides multiple robust strategies to simulate user activity or adjust power configurations, ensuring that long-running processes, file transfers, or presentations are never interrupted by aggressive power-saving policies.

Installation

To integrate this skill into your environment, run the following command within your terminal or OpenClaw interface:

clawhub install openclaw/skills/skills/bunsdev/caffeine

Once installed, you can trigger the skill via natural language commands, and OpenClaw will execute the appropriate script based on your detected operating system.

Use Cases

This skill is ideal for professionals and developers who perform tasks that run for hours without continuous user interaction. Use this skill when you are:

• Running long-running data compilation or code builds that are prone to crashing if the system sleeps.
• Giving a presentation or watching a video stream where you don't want the screen to turn off.
• Downloading large files over a slow network connection that requires a persistent connection.
• Managing remote server maintenance that relies on a stable terminal session.

Example Prompts

1. "OpenClaw, keep my display awake for the next two hours so I can monitor this build."
2. "I need to run a large update that will take a while. Please prevent my computer from going to sleep until I tell you otherwise."
3. "Stop the caffeine timer; I am finished with my long-running task."

Tips & Limitations

• Safety: Always remember to disable the caffeine process once your task is complete to preserve battery life and hardware longevity, especially on laptops.
• Platform Differences: macOS caffeinate is a system-level process that is highly efficient. Windows methods such as the PowerShell activity simulator (SCROLLLOCK emulation) effectively keep the computer 'awake' by tricking the system into thinking there is user activity, whereas the powercfg method changes actual OS settings. Be mindful that powercfg changes persist until you revert them, whereas most script-based methods only last as long as the process is running.