LightClaw documentation

LightClaw is an alpha Telegram control surface for reviewed, verified work by local Codex and Claude coding agents. Start with the token-free path, then read the trust boundary before connecting a bot, provider, or real repository.

Start

• Five-minute token-free quickstart
• Install, upgrade, undo, and uninstall
• Real Telegram verification
• Provider installation and compatibility contract

Understand the delivery contract

• Architecture map and enforced budgets
• Run receipts and sanitized Run Cards
• Telegram approvals and high-risk confirmation
• Reviewable patches, selective apply, and optional PR previews
• Durable queues, cancellation, and recovery
• Namespaced lexical memory

Trust boundaries

• Threat model
• Privacy and public-evidence boundary
• Security policy
• Permissioned skill contract

Operate and maintain

• Optional systemd service
• Upgrade and rollback policy
• Maintenance cadence and evidence policy
• Maintainer publishing runbook
• Provider SDK lifecycle audit

Plans and evidence

• Product roadmap
• Roadmap evidence audit and external gates
• Reproducible benchmarks
• Multi-agent guide
• Sanitized showcase recipes
• Versioned release notes

Fixture success proves LightClaw's local contracts. It does not prove live provider quality, Telegram delivery, external coding-agent behavior, or production readiness.