Apollo Circadian for Openclaw

Apollo Circadian is an intelligent scheduling skill that synchronizes AI task execution with human biological rhythms to maximize cognitive efficiency.

nic-yuan
v2.0.0
Apr 7, 2026
0
708
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install apollo-circadian

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install apollo-circadian using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Apollo Circadian?

Apollo Circadian is a specialized framework designed to align AI agent activities with the natural 24-hour biological cycle. It operates on the principle that task scheduling should mirror the human circadian rhythm, identifying optimal windows for deep work, routine maintenance, and system recovery. By integrating this logic into Openclaw Skills, developers can ensure their agents prioritize complex analytical tasks during cortisol peaks and shift to organizational maintenance during melatonin windows.

The skill monitors real-time clocks to categorize the current phase into periods such as Peak Productivity, Daytime Homeostasis, or the Post-lunch Dip. This allows for a more human-centric approach to automation where the AI understands not just what needs to be done, but exactly when it is most effective to do it.

Apollo Circadian Use Cases

  • Automatically scheduling deep-thinking and complex analysis during morning high-energy phases.
  • Transitioning to routine data organization and system cleanup during low-energy afternoon windows.
  • Enforcing a mandatory memory consolidation and cleanup phase (Dream Window) after 21:00.
  • Determining task priority based on the remaining time in the current productivity phase.

How Apollo Circadian Works

  1. The system retrieves real-time clock data from the heartbeat-realtime.json log to identify the current biological phase.
  2. It analyzes the complexity of incoming tasks, distinguishing between deep analysis and routine maintenance.
  3. The skill performs phase-task matching, checking if the current energy level (e.g., cortisol peak) matches the task requirements.
  4. If a mismatch is detected, the skill reports the discrepancy and suggests an optimal future execution time.
  5. During specific transition windows, such as the late-evening melatonin peak, it triggers secondary maintenance skills like apollo-dream.

Apollo Circadian Setup

To deploy this skill within your environment, ensure your heartbeat scripts are active and use the following commands:

# Run a manual check of the current circadian phase
bash scripts/circadian/circadian-check.sh

# Ensure the heartbeat logger is integrated
bash scripts/heartbeat-logger.sh

Apollo Circadian Data Schema & Taxonomy

The skill manages state and reporting through localized JSON structures and shell scripts:

Component Path Function
Phase State .circadian/phase-state.json Stores current rhythm status and next phase transition.
Real-time Log /tmp/heartbeat-realtime.json Provides the circadian_phase field for main AI consumption.
Logic Script scripts/circadian/circadian-check.sh Executes the mathematical phase calculation.

Apollo Circadian Advanced Features

  • Multi-skill synergy where apollo-circadian triggers apollo-dream for memory processing during sleep windows.
  • Dynamic execution pathing via apollo-neuro, selecting high-performance paths during peak phases.
  • Contextual filtering through apollo-renal to prioritize important inputs during low-efficiency periods.
  • Fully configurable personal rhythm preferences for late-starters or night-owl users.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*