🧠 Intrusive Thoughts

The complete consciousness framework for AI agents

Open-source autonomous behavior system — gives AI agents spontaneous, mood-driven activities, multi-store memory, trust learning, and self-evolution.

GitHub: https://github.com/kittleik/intrusive-thoughts

Quick Start

Run the interactive setup wizard:

CODEBLOCK0

Or through the main script:

CODEBLOCK1

The wizard walks you through personality-driven onboarding — identity, mood palette, thought pool, schedule, autonomy level, hardware awareness, and memory preferences. Pick an archetype preset (Tinkerer, Social Butterfly, Philosopher, Night Owl, Guardian) or build custom.

What This Does

Core Systems

• - 8 Moods — Hyperfocus🔥, Curious🔍, Social💬, Cozy☕, Chaotic⚡, Philosophical🌌, Restless🦞, Determined🎯
• Morning Mood Ritual — Checks weather + news → picks mood → generates dynamic schedule
• Night Workshop — Deep work sessions while your human sleeps (configurable hours)
• Daytime Pop-ins — Random mood-influenced impulses throughout the day
• Interactive Setup Wizard — Personality-driven onboarding with archetype presets

Advanced Systems (v1.0)

• - 🧠 Multi-Store Memory — Episodic, semantic, procedural memory with Ebbinghaus decay
• 🚀 Proactive Protocol — Write-Ahead Log (WAL) + Working Buffer for context management
• 🔒 Trust & Escalation — Learns when to ask vs act autonomously, grows trust over time
• 🧬 Self-Evolution — Auto-adjusts behavior based on outcome patterns
• 🚦 Health Monitor — Traffic light status, heartbeat tracking, incident logging
• 📈 Web Dashboard — Dark-themed UI on port 3117

Cron Jobs

The system needs OpenClaw cron jobs. Set these up after running the wizard:

Morning Mood Ritual (daily)

Schedule: 0 7 * * * (or your configured morning time)

CODEBLOCK2

Night Workshop (overnight)

Schedule: 17 3,4,5,6,7 * * * (or your configured night hours)

CODEBLOCK3

Note on "prompts": The thoughts.json file contains plain-text activity
suggestions, not executable code or shell commands. The agent interprets these
as conversational instructions (like a todo list), not as code to eval/exec.
All thought prompts are user-editable in thoughts.json.

Daytime Pop-ins (created dynamically by morning ritual)

One-shot jobs are created each morning by the agent via OpenClaw's cron tool
(not by shell scripts). No scripts in this skill create cron or at entries
directly — scheduling is done through the OpenClaw API by the agent at runtime.

Main Script

CODEBLOCK4

Key Files

File	Purpose
INLINECODE4	Interactive setup wizard
INLINECODE5

Main entry point | | config.json | Your agent's configuration | | moods.json | Mood definitions + weather/news influence maps | | thoughts.json | Day and night thought pools | | today_mood.json | Current mood (set by morning ritual) | | today_schedule.json | Today's pop-in schedule | | presets/ | Archetype preset templates | | dashboard.py | Web dashboard (port 3117) | | memory_system.py | Multi-store memory with decay | | proactive.py | Proactive behavior protocol | | trust_system.py | Trust & escalation learning | | self_evolution.py | Self-modification engine | | health_monitor.py | System health monitoring |

Dashboard

CODEBLOCK5

Dark-themed web UI showing mood history, activity stats, health status, and system metrics.

Credentials & Permissions

Optional Integrations

The system works completely offline by default. All integrations are optional and explicitly configured:

• - Weather Data: Uses public wttr.in API (no API key required)

- Accessed via curl requests in set_mood.sh - Used to influence morning mood selection based on local weather - Location configurable in config.json under INLINECODE22

• - News Feeds: Uses public RSS feeds (no API key required)

- BBC World RSS: https://feeds.bbci.co.uk/news/world/rss.xml - Hacker News RSS: https://hnrss.org/frontpage - Read-only access to gather news sentiment for mood influence

• - Telegram Bot (disabled by default)

- Requires bot token in config.json under integrations.telegram.token - Set to "enabled": false in config.example.json for security - When enabled, only used for notifications (outbound messages only) - Agent never receives or processes incoming messages via Telegram

• - OpenAI API (optional)

- Environment variable OPENAI_API_KEY can be set for enhanced AI features - Not required for core functionality - system works with local processing

File Access

The system operates entirely within its skill directory:

• - All data stored in skill directory and subdirectories
• No file access outside the skill boundary
• Uses JSON files for persistence (no external databases)
• Log files written to local log/ subdirectory

Security Model

Autonomous Execution

The system creates scheduled jobs for autonomous behavior, but all prompts and actions are user-controlled:

• - Thought Sources: All prompts come from thoughts.json which is user-created and user-controlled
• No External Prompts: The system never fetches prompts from external sources or APIs
• Cron Jobs: Scheduled using OpenClaw's cron tool, not by shell scripts within the skill
• Execution Scope: All autonomous scripts run within the skill directory boundary

Scripts Executed Autonomously

1. 1. Morning Ritual (set_mood.sh)

- Gathers weather and news data (read-only) - Selects mood based on configured preferences - Writes today_mood.json with selected mood

1. 2. Schedule Creation (schedule_day.py)

- Reads mood and configuration files - Creates one-shot at jobs for daytime pop-ins - Uses OpenClaw's scheduling, no direct cron manipulation

1. 3. Night Workshops (intrusive.sh night)

- Selects random prompt from user's thoughts.json - Executes thought with configured model - Logs results locally via INLINECODE38

1. 4. Daytime Pop-ins (dynamic one-shot jobs)

- Created each morning by schedule_day.py - Execute intrusive.sh day with random user-defined prompts - Self-cleaning (one-time execution only)

Network Activity

All network access is read-only and limited to:

• - Weather API (wttr.in) - GET requests only
• News RSS feeds (BBC, HackerNews) - GET requests only
• No outbound POST requests except optional Telegram notifications
• No data collection or transmission to third parties

Architecture

The system is designed to be modular and portable:

• - No hardcoded personal data — everything in INLINECODE42
• Plain JSON files — no database dependencies
• Bash + Python — runs anywhere with basic tools
• OpenClaw skill compatible — drop-in install
• MIT licensed — fork it, remix it, make it yours