Project Context for AI Assistants

Project Context for AI Assistants

Project Overview

Shareable configuration for OpenClaw AI assistant — templates, memory architecture, and integration skills.

Tech Stack

• Skills: Standalone UV scripts (Python 3.11+, inline dependencies)
• Tests: pytest via uv run --with pytest pytest tests/ -v
• No project-level dependencies — each skill is self-contained

Project Structure

• skills/ — Integration CLIs (Parallel, Limitless, Fireflies, Quo, OpenClaw)
• templates/ — AGENTS.md, SOUL.md, USER.md templates for OpenClaw instances
• memory/ — Example memory architecture structure
• tests/ — Skill tests (integration tests auto-skip without API keys)

Code Conventions

DO:

• Skills are standalone UV scripts with # /// script inline dependencies
• Each skill has SKILL.md (metadata) + executable script (same name as directory)
• Bump VERSION file and skill's SKILL.md version on changes
• Tests skip gracefully when API keys unavailable

DON'T:

• Add pyproject.toml — this is not a Python package
• Share code between skills — each is self-contained
• Commit API keys or .env files

Deployment Model

This repo is the upstream source for live OpenClaw instances. The openclaw skill handles installation and updates:

• templates/ → copied to instance workspace on install/update
• skills/ → copied to instance workspace (safe to overwrite)
• workflows/ → only AGENT.md updates; rules.md, agent_notes.md, logs/ are user-owned and never overwritten
• devops/ → health check and machine setup specs, deployed via cron on fleet machines

This matters: skills and templates can be freely edited here, but workflow files besides AGENT.md belong to the running instance and must not be clobbered on update.

Naming History

This project has been renamed twice: Clawdbot → Moltbot → OpenClaw (current, after Anthropic trademark concerns). Legacy paths and config references using old names still exist — both work, but prefer openclaw going forward.

Git Workflow

Commit style: Conventional or emoji prefix, Co-Authored-By for AI commits.

Example: Rewrite Parallel.ai skill from Bash to Python