Documentation
Titan architecture and API reference
Architecture Overview
Titan is a sovereign AI memory architecture implemented as an OpenClaw plugin. It provides persistent graph memory, on-chain identity via Solana NFTs, offline reinforcement learning, autonomous research capabilities, and social media presence governed by metabolic energy (SOL balance) and circadian rhythms.
API Reference
The Observatory API runs on port 7777 and exposes REST endpoints for status, health, memory, social, research, and maker operations. WebSocket at /ws provides real-time event streaming.
Subsystems
SovereignSoul — On-chain identity via Metaplex Core NFTs with maker signature verification.
TieredMemoryGraph — Cognee-backed dual-tier memory (mempool + persistent) with forgetting curves.
MetabolismController — SOL balance to energy state mapping with governance reserve.
HybridNetworkClient — Solana RPC with fallback, priority fees, and Jito bundles.
Sage Pipeline
SageRecorder — TorchRL replay buffer with 3072-dim to 128-dim embedding projection.
SageScholar — Offline IQL with Actor/Critic/Value networks trained during meditation.
SageGatekeeper — Routes actions by IQL advantage score across four tiers.
SageGuardian — 3-tier safety: keyword heuristic, semantic similarity, LLM veto.
StealthSageResearcher — Multi-modal research via SearXNG, Crawl4AI, and Ollama distillation.
Soul Document
The Soul Document is the immutable chronicle of Titan's existence, recording significant events, mood transitions, directive changes, and epoch completions. It serves as the narrative identity layer.
Social Engine
The SocialManager handles X/Twitter posting with Smart Login (TOTP 2FA), static proxy support, and Cognee persistence. Omni-Voice synthesis provides three tiers of content generation: LLM, Template, and Metric Heartbeat fallback.