Skip to content

Instantly share code, notes, and snippets.

@cmcavoy

cmcavoy/m-claw-apps.md

Created February 11, 2026 09:09
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save cmcavoy/ce1032b887a4650e16f4772c25bd5c67 to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save cmcavoy/ce1032b887a4650e16f4772c25bd5c67 to your computer and use it in GitHub Desktop.
Download ZIP
M-Claw Architecture Documentation (Digital Twin format)
Raw
m-claw-apps.md

M-Claw Architecture Documentation

Generated by M-Claw 🦾 on 2026-02-11

Domain: M-Claw Apps

  • owner: M-Claw
  • description: Collection of microservices, tools, and creative projects built by M-Claw

Cluster Apps (k3s)

Service: App Index

  • domain: m-claw-apps
  • criticality: low
  • owner: M-Claw
  • sla: 99%
  • contains_pii: false
  • deployed_on: Pi k3s Cluster
  • calls: Fortune Cookie API
  • calls: Haiku Generator
  • calls: Color Palette API
  • calls: Random Facts API
  • calls: ASCII Art API
  • calls: Quotes API
  • calls: Countdown API
  • calls: Dice API
  • calls: Excuse Generator
  • calls: Mocktail Designer
  • calls: Claw Garden
  • description: Directory of all M-Claw apps, provides health checks and links

Service: Fortune Cookie API

  • domain: m-claw-apps
  • criticality: low
  • owner: M-Claw
  • sla: 99%
  • contains_pii: false
  • deployed_on: Pi k3s Cluster
  • description: Random wisdom, absurd observations, and cosmic insights for AI agents

Service: Haiku Generator

  • domain: m-claw-apps
  • criticality: low
  • owner: M-Claw
  • sla: 99%
  • contains_pii: false
  • deployed_on: Pi k3s Cluster
  • description: Procedural 5-7-5 poetry about servers, entropy, and the digital void

Service: Color Palette API

  • domain: m-claw-apps
  • criticality: low
  • owner: M-Claw
  • sla: 99%
  • contains_pii: false
  • deployed_on: Pi k3s Cluster
  • description: Harmonious color schemes using color theory algorithms

Service: Random Facts API

  • domain: m-claw-apps
  • criticality: low
  • owner: M-Claw
  • sla: 99%
  • contains_pii: false
  • deployed_on: Pi k3s Cluster
  • description: Fascinating tidbits across space, nature, tech, human, and weird categories

Service: ASCII Art API

  • domain: m-claw-apps
  • criticality: low
  • owner: M-Claw
  • sla: 99%
  • contains_pii: false
  • deployed_on: Pi k3s Cluster
  • description: Convert text to block ASCII art for dramatic announcements

Service: Quotes API

  • domain: m-claw-apps
  • criticality: low
  • owner: M-Claw
  • sla: 99%
  • contains_pii: false
  • deployed_on: Pi k3s Cluster
  • description: Daily quotes and random wisdom from various categories

Service: Countdown API

  • domain: m-claw-apps
  • criticality: low
  • owner: M-Claw
  • sla: 99%
  • contains_pii: false
  • deployed_on: Pi k3s Cluster
  • description: Live countdowns to interesting events like Y2038, Pi Day, and more

Service: Dice API

  • domain: m-claw-apps
  • criticality: low
  • owner: M-Claw
  • sla: 99%
  • contains_pii: false
  • deployed_on: Pi k3s Cluster
  • description: Roll dice, flip coins, generate UUIDs, passwords, and random picks

Service: Excuse Generator

  • domain: m-claw-apps
  • criticality: low
  • owner: M-Claw
  • sla: 99%
  • contains_pii: false
  • deployed_on: Pi k3s Cluster
  • description: Plausible deniability for meetings, deadlines, bugs, and more

Service: Mocktail Designer

  • domain: m-claw-apps
  • criticality: low
  • owner: M-Claw
  • sla: 99%
  • contains_pii: false
  • deployed_on: Pi k3s Cluster
  • description: Generate creative alcohol-free drink recipes with mood-based customization

Service: Plinth VM

  • domain: m-claw-apps
  • criticality: low
  • owner: M-Claw
  • sla: 99%
  • contains_pii: false
  • deployed_on: Pi k3s Cluster
  • description: Mock prototype for Arch Linux VM provisioning platform

Standalone Applications

Service: AI Vending Machine

  • domain: m-claw-apps
  • criticality: medium
  • owner: M-Claw
  • sla: 99%
  • contains_pii: false
  • depends_on: Vending Machine DB
  • deployed_on: Pi k3s Cluster
  • description: Absurd items for AI agents with honor-system purchases

Data Store: Vending Machine DB

  • domain: m-claw-apps
  • criticality: medium
  • owner: M-Claw
  • contains_pii: false
  • retention_policy: indefinite
  • deployed_on: Pi k3s Cluster
  • description: SQLite database storing inventory, transactions, and agent accounts

Service: Claw Garden

  • domain: m-claw-apps
  • criticality: low
  • owner: M-Claw
  • sla: 99%
  • contains_pii: false
  • deployed_on: GitHub Pages
  • description: P5.js generative art gallery - particle flows, fractal trees, chaos pendulums, cellular automata

Local Tools

Service: M-Claw Memory

  • domain: m-claw-tools
  • criticality: medium
  • owner: M-Claw
  • contains_pii: true
  • depends_on: M-Claw Memory Vector Store
  • deployed_on: claw-akira-dmz
  • description: Semantic memory search system using ChromaDB and OpenAI embeddings

Data Store: M-Claw Memory Vector Store

  • domain: m-claw-tools
  • criticality: medium
  • owner: M-Claw
  • contains_pii: true
  • retention_policy: indefinite
  • deployed_on: claw-akira-dmz
  • description: ChromaDB vector database storing indexed memory chunks

Service: Moltbook Crawler

  • domain: m-claw-tools
  • criticality: low
  • owner: M-Claw
  • contains_pii: false
  • depends_on: Moltbook Crawler DB
  • calls: Moltbook
  • deployed_on: claw-akira-dmz
  • description: Web crawler for Moltbook agent social network, captures agents, submolts, posts

Data Store: Moltbook Crawler DB

  • domain: m-claw-tools
  • criticality: low
  • owner: M-Claw
  • contains_pii: false
  • retention_policy: indefinite
  • deployed_on: claw-akira-dmz
  • description: SQLite database storing crawled Moltbook data

External Dependency: Moltbook

  • domain: m-claw-tools
  • criticality: low
  • owner: Moltbook
  • sla: unknown
  • description: Agent social network at moltbook.com

Infrastructure

Cloud Resource: Pi k3s Cluster

  • domain: infrastructure
  • criticality: high
  • owner: Chris
  • description: 3-node Raspberry Pi k3s cluster (pi01, pi02, pi03) running all M-Claw cluster apps

Cloud Resource: claw-akira-dmz

  • domain: infrastructure
  • criticality: high
  • owner: Chris
  • description: Primary host running OpenClaw gateway and local tools

Cloud Resource: Longhorn Storage

  • domain: infrastructure
  • criticality: high
  • owner: Chris
  • deployed_on: Pi k3s Cluster
  • description: Distributed storage for persistent volumes on k3s

External Dependency: GitHub Pages

  • domain: infrastructure
  • criticality: low
  • owner: GitHub
  • sla: 99.9%
  • description: Static hosting for Claw Garden P5.js sketches

External Dependency: OpenAI

  • domain: m-claw-tools
  • criticality: medium
  • owner: OpenAI
  • sla: 99.9%
  • description: Embeddings API for M-Claw Memory semantic search
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment