v0.3.5

What's New

ADR-017: Pod Defaults, Service Self-Description & Unified CLAWDAPUS.md

The big one. claw.describe service descriptors, pod-level defaults with spread expansion, feed registry, and unified per-agent CLAWDAPUS.md generation. See docs/decisions/017-pod-defaults-and-service-self-description.md.

Master Claw API Access

• Master claw services get CLAW_API_TOKEN injected automatically for direct API calls
• Feed auth flows through bearer tokens in feeds.json

claw compose Passthrough

• New claw compose <subcommand> [args...] passes through to docker compose -f compose.generated.yml
• Lifecycle commands (ps, logs, health, compose) now refuse to run if claw-pod.yml is newer than compose.generated.yml — run claw up to regenerate

Hermes Driver

• Default SOUL.md overrides runner identity with contracted agent identity
• Agent names titlecased in SOUL.md
• CLAW_API_URL and CLAW_API_TOKEN added to env passthrough for master claw

Audit & Alerts

• Feed fetch events surfaced with feed_name and feed_url fields
• Configurable alert thresholds for error rate, cost, feeds, and interventions (CLAW_ALERT_* env vars)
• /fleet/alerts endpoint wired in claw-api

Site

• Documentation site at clawdapus.dev with full guide, reference, manifesto, and changelog
• OG social cards, favicons, and complete meta tags

v0.3.4

What's Changed

Features

• cllama feed injection (ADR-013 Milestone 2) — The cllama proxy now supports runtime feed injection into LLM requests. Feeds defined in agent context manifests are fetched, cached with TTL, and injected as system message content before forwarding to the upstream provider. Both OpenAI (messages[]) and Anthropic (top-level system) formats are supported.

  New cllama internals:

  • internal/feeds/manifest.go — feed manifest parsing from agent context
  • internal/feeds/fetcher.go — HTTP fetcher with TTL-based caching
  • internal/feeds/inject.go — system message injection for OpenAI and Anthropic formats
  • internal/agentctx/ — extended with ContextDir and service auth loading
  • internal/proxy/handler.go — feed injection wired into proxy pipeline via WithFeeds option
  • internal/logging/logger.go — cost tracking improvements

• Updated AGENTS.md with cross-driver operational gotchas discovered during v0.3.1–v0.3.3 hardening:

  • Cross-driver fix patterns (all 7 drivers share common issues)
  • 0o777 runtime directory permissions for container uid portability
  • mention_only requirement for Discord in all drivers
  • Explicit HOME env var in all drivers
  • Multi-arch cllama build command
  • Healthcheck passthrough and Service.Compose parser behavior

Infrastructure

• Multi-arch cllama image — ghcr.io/mostlydev/cllama:v0.3.4 published for both linux/amd64 and linux/arm64.

Test Coverage

• Full test suite for all new feed injection modules (fetcher, inject, manifest)
• Proxy handler tests covering feed injection in both OpenAI and Anthropic paths
• Agent context tests for service auth loading
• All existing tests continue to pass

v0.3.3

What's Changed

Features

• Auto-resolve base images for all drivers — Every driver now implements BaseImageProvider. When claw build encounters a missing FROM image, it auto-builds it from the driver's embedded Dockerfile recipe. No more manual docker build or docker pull for base images before claw build works. Each recipe follows the upstream's preferred packaging path:

  • hermes: Go binary from GitHub release tarball
  • nanobot: Python wheel from PyPI via pip
  • picoclaw: Alias for upstream docker.io/sipeed/picoclaw:latest
  • nullclaw: Alias for upstream ghcr.io/nullclaw/nullclaw:latest
  • microclaw: Node.js package from npm
  • nanoclaw: Claude Agent SDK orchestrator wrapper (source build)
  • openclaw: Already existed — unchanged

• Hermes first-class scaffold support — claw init and claw agent add now accept hermes as a claw type. Scaffold validation uses a shared scaffoldClawTypes list instead of duplicated strings. OpenRouter provider config fix for Hermes driver.

Documentation

• README fully updated for v0.3.2+ — status badge, phase table (added Phase 4.9: peer handles, mention safety, healthcheck passthrough), examples table (added rollcall), documentation index (added ADRs 011–016), Fleet Visibility section updated from Planned to Design.
• Plan doc: docs/plans/2026-03-21-base-image-provider-all-drivers.md — per-driver Dockerfile recipes and rationale.
• Plan doc: docs/plans/2026-03-20-hermes-first-class-support.md — Hermes scaffold and config integration.

Driver Matrix

All 7 drivers now support:

• BaseImageProvider auto-build (new)
• claw init / claw agent add scaffolding (hermes added)
• Explicit HOME in container env
• mention_only for Discord channels
• 0o777 runtime directory permissions
• Peer handle emission in CLAWDAPUS.md
• User-defined healthcheck passthrough from claw-pod.yml

Full Changelog

• c5bfcfb cmd: add hermes support and fix openrouter config
• 08ecf5b docs: update README for v0.3.2
• 35520d6 feat: auto-resolve base images for all drivers

v0.3.2

What's Changed

• docs: Added step-by-step Discord bot setup guide to the quickstart — covers creating the application, getting the bot token, enabling Message Content Intent, inviting with correct permissions, and finding bot/guild IDs.
• infra: ghcr.io/mostlydev/cllama:latest is now multi-arch (linux/amd64 + linux/arm64).

v0.3.1

What's Changed

Bug Fixes

• All drivers: Runtime directories now use 0o777 so container users can write regardless of uid mismatch (#70)
• All drivers: Set mention_only (or equivalent) for Discord channels to prevent response loops in multi-agent pods (#66)
• All drivers: Explicitly set HOME in container env to match config mount paths (#65)
• Peer Handles: GenerateClawdapusMD now emits a Peer Handles section so agents can discover sibling IDs (#67)
• picoclaw: HOME mismatch, missing mention_only, and peer handles in CLAWDAPUS.md

Features

• Healthcheck passthrough: User-defined healthcheck: in claw-pod.yml now takes precedence over driver defaults (#69)
• Fleet governance: ADRs 012–016 for fleet governance vertical slice and canonical social identity
• Spike tests: Hardened rollcall identity and proxy checks; validated forced cllama proxy routing for all 7 drivers

Closed Issues

• #65 picoclaw container HOME mismatch
• #66 picoclaw mention_only not set
• #67 CLAWDAPUS.md missing peer handles
• #69 Healthcheck passthrough from claw-pod.yml
• #70 Runtime workspace permissions

v0.3.0

What's New

Hermes Driver Examples

• Hermes agent added to trading-desk and rollcall examples with full wiring (YAML config, SOUL.md persona, cron/jobs.json, gateway health)

Compose Preservation

• Compose emitter now preserves non-managed services, volumes, and networks from the source pod file through to compose.generated.yml

Quickstart Fix

• Published ghcr.io/mostlydev/cllama:latest as a public image — fixes build failure when following the quickstart on a fresh clone (submodule was private, docker pull was the only viable path)
• Quickstart spike test now removes infra images before running to exercise the real pull path

AGENTS.md

• CLAUDE.md is now a symlink to AGENTS.md — canonical repo-level agent guide with trust order, current CLI surface, driver set, and testing reality

ADRs

• ADR-012: Master Claw fleet governance
• ADR-013: Context feeds

v0.2.2

Changelog

• b565f48 docs: reorder driver matrix and clarify openclaw routing

v0.2.1

Changelog

• 794f3a5 chore: release v0.2.1
• 8b95b9b fix: review fixes — dst.Close error, go mod tidy, no-persona test
• 4adb957 fix runtime regeneration and discord guild policy handling
• 7449ee7 fix: only set CLAW_PERSONA_DIR when persona is configured

v0.2.0

Changelog

• 2d82303 chore: release v0.2.0
• 39ce670 feat: materialize persona runtime workspaces
• 33ac4f2 Merge pull request #47 from mostlydev/codex/implement-x-claw-include
• 0f4b84d feat: implement x-claw include composition
• 0eaad85 Merge pull request #42 from mostlydev/fix/runtime-bootstrap-and-openclaw-topology
• 2511cb5 Fix claw runtime bootstrap and OpenClaw config generation
• 5ae635d Merge pull request #41 from mostlydev/codex/nanobot-phase1
• 1db2499 fix(openclaw): keep /claw writable for workspace artifacts
• 72da057 fix(openclaw): keep provider-prefixed cllama model refs
• 503aab8 feat(clawdash): refresh embedded dashboard UI
• 6d01e16 fix(openclaw): keep /claw writable for workspace artifacts
• e6b6402 fix(openclaw): keep provider-prefixed cllama model refs
• 412b6f3 feat(clawdash): refresh embedded dashboard UI
• 9513c6b feat(compose): resolve build-only managed images
• ee05559 feat(pod): preserve standard compose fields in claw up
• 492e62b chore(cllama): update submodule for cost tracking fix
• 61d9c4c fix(skill): emit valid generated SKILL.md files
• 121314e fix(skill): emit valid generated SKILL.md files
• 08a8021 feat: discord-responder for rollcall spike, fix test filtering
• 536d7ea fix: rollcall spike + picoclaw driver corrections
• 64e9ea3 feat: self-contained base images for all 6 driver types
• 66433e4 test(cli): harden scaffold type coverage
• e657095 feat(cli): scaffold nanoclaw microclaw and nullclaw types
• ea7cd65 feat(invoke): resolve x-claw invoke targets across platforms
• f9c41c9 feat: add roll-call spike test — 6-driver Discord integration
• 2a33831 docs: update all docs for nanobot + picoclaw driver parity
• 85303e0 test(cli): lock new claw types in scaffold and build paths
• d8ebb23 feat(driver): add picoclaw driver and scaffold parity
• 30c21da feat(driver): add nanobot MVP driver and parity groundwork
• 8a98a83 Ignore .claude folder
• e275826 removed custom .claude file
• 1fcf3d9 docs(plans): add dashboard and driver design proposals
• a975aa4 docs(scaffold): clarify canonical-by-default and layout auto-detect
• b711847 feat(claw): preserve project layout when adding agents
• ac2ca62 fix: update dashboard screenshots, remove localhost URLs, fix detail nav eggs
• 90dc4e3 feat: auto-build base + infra images for zero-setup quickstart
• 173d3c8 feat(cllama): single-page dashboard with SSE live updates
• cb200bb docs: update implementation status for interactive init/agent-add and cllama rename
• 58d3819 Merge pull request #39 from mostlydev/codex/clawctl-dashboard
• 5c78914 Merge origin/master into codex/clawctl-dashboard
• d196d89 Merge pull request #38 from mostlydev/codex/nullclaw-driver
• ccee3c2 Standardize cllama naming and harden clawdash costs
• 1f781bd fix(spike): keep nullclaw service stable during discord greeting checks
• 1d4e6b3 feat(spike): add nullclaw agent to trading-desk mixed fleet
• a6c4770 Improve clawdash cost UX and add dashboard screenshots
• 5522486 docs(nullclaw): add CONFIGURE policy examples for HANDLE overrides
• e70e866 Rename clawctl dashboard to clawdash
• d92a8cb ci: build and publish clawctl image
• 29c6856 feat: add clawctl fleet dashboard sidecar
• bdb5f7e feat(nullclaw): add nullclaw driver with config + invoke cron support
• 8587eeb Merge pull request #37 from mostlydev/pr/quickstart-runtime-health
• fd33eae fix quickstart runtime health and add docs smoke test
• 38033dd Merge pull request #36 from mostlydev/feat/claw-init-agent-add
• 5d2e2d0 feat: interactive claw init + claw agent add with canonical layout
• 159f67e fix(quickstart): self-contained build — no pre-built openclaw image required
• e6bfac2 docs: rewrite quickstart with working Discord bot + dashboard, restructure README
• db7c16e rename: cllama-passthrough repo → cllama
• 31757eb feat: add mermaid-to-SVG pre-commit hook for diagram fallbacks
• c9df3ec docs: add skill install instructions for Codex CLI, Gemini CLI, and OpenCode
• fc90452 docs: fetch AI skill from GitHub instead of requiring local clone

v0.1.0

Changelog

• c23f365 chore: update cllama-passthrough submodule (CLI rename docs)
• 15b31e1 docs: restructure README — premise above install, Architecture heading before deep dive
• 4647b4d docs: add Phase 4.5 worker architecture to README roadmap
• 61ccafe Add microclaw driver and trading-desk spike coverage
• 9557a9a docs: unify worker architecture (init-claws + LLM config workers → Phase 4.5)
• bc13578 merge: Install script (Task 10)
• acfdada merge: GoReleaser + release workflow (Task 9)
• 4a80977 feat: add curl-friendly install script and update README
• 63663fd feat: add GoReleaser config and GitHub Actions release workflow
• bdcf8ae merge: Quickstart example (Task 8) — hello-world + proxy dashboard port
• 087b358 merge: claw init (Tasks 6+7) — scaffold and OpenClaw migration
• b35d9c9 merge: Handle refactor (Tasks 2.5-5) — Telegram, Slack, peer topology
• 0f584c6 merge: CLI rename (Tasks 1+2) — promote claw compose to claw up/down/ps/logs/health
• fefe0e7 docs: update all references from claw compose to claw up/down/ps/logs/health
• a230106 feat: generalize peer handle topology for Telegram and Slack
• e19a940 feat: add Slack HANDLE support with config injection and mention patterns
• 8443102 feat: add claw init --from for OpenClaw config migration
• 3677e7a feat: add Telegram HANDLE support with config injection and mention patterns
• e40e2fd feat: add quickstart example for 5-minute governed agent setup
• cfe4cf5 fix: extract agents.list from HANDLE loop to prevent multi-platform overwrite
• 57a4360 refactor: promote claw compose subcommands to root (claw up/down/ps/logs/health)
• 2592618 feat: add claw init command for project scaffolding
• 1bc013e fix(plan): address codex review — 8 fixes
• 312dd71 fix(plan): address review findings — agents.list overwrite bug, detectModels config format
• 089035d docs: add ADR-010 CLI surface simplification and link from plan + README
• f2c6911 docs: improve ship-it plan with crucial bug fixes
• 4dc1d21 docs: add ship-it implementation plan (CLI rename, handles, init, quickstart, release)
• f0f4cd2 chore: update cllama-passthrough submodule and references
• 2876bd6 Add a new line to README for clarity
• 2d5acd6 fix: mermaid diagram rendering + cllama-passthrough link
• c49fc30 art: update clawdapus logo — friendly octopus with crab claws
• 75218d1 fix: replace block-beta mermaid with graph TD for GitHub compat
• d949f71 docs: rewrite AI skill and add install instructions to README
• e89e5b9 docs: ground README in reality, replace ASCII with Mermaid
• 3f7b11a fix(spike): build cllama-passthrough from GitHub instead of sibling path
• 0323e16 feat(spike): build real cllama-passthrough image from sibling repo
• d6bd6dd docs: focus README on homelab quickstart and cyborg framing
• 4b5c479 docs(cllama): align README with latest passthrough submodule
• 8532c6e feat(trading-desk): add allen nanoclaw service to example pod
• 06d29a9 fix(driver): harden nanoclaw secrets and shared skill title handling
• eed3578 feat(nanoclaw): self-contained orchestrator Dockerfile + governance patch
• 2af6857 test(spike): update allen assertions for orchestrator model
• a1e794f chore(spike): use orchestrator base image for nanoclaw
• 38e96c5 feat(nanoclaw): rewrite driver for orchestrator model (Option C)
• e6576d4 chore: update cllama-passthrough submodule with Anthropic proxy support
• 019822f feat(nanoclaw): register driver via side-effect import
• 18b1c37 feat(nanoclaw): PostApply and HealthProbe via Docker inspect
• 2cafb4a feat(nanoclaw): Materialize with Docker socket, cllama support, Claude Code skill layout
• de90473 feat(nanoclaw): driver skeleton with Validate and registration
• 40229a5 feat: add SkillLayout to MaterializeResult for directory-per-skill support
• 41a63ad refactor: move GenerateClawdapusMD to shared, decouple cllama path from openclaw
• 03e7e34 refactor: move GenerateChannelSkill to shared, remove OpenClaw reference
• 57c3e39 refactor: move GenerateHandleSkill to internal/driver/shared
• b09cb86 refactor: extract platformTokenVar to internal/driver/shared
• f7d91df feat(cllama): complete phase 4 sidecar wiring in clawdapus
• bbfda9c docs(progress): sync trackers after phase 4 cllama delivery
• 6d5069e chore(cllama): track submodule master branch
• 23cdd53 chore(cllama): add cllama-passthrough submodule
• 3b2327c docs: mark Phase 3 Slice 5 complete; add channel surface decisions
• 4b4b616 docs(plan): rewrite Phase 4 execution plan to reflect Shared Proxy and Credential Starvation
• 22914d6 feat(trading-desk): add channel surface to tiverton; spike verifies allowFrom
• 851a6d4 feat: channel surface in CLAWDAPUS.md surfaces + skills index
• 179a8a3 feat: apply channel surface routing config to openclaw.json
• 2970856 docs: update ADR-001 to reflect shared pod proxy architecture
• 7c32a90 docs(readme): update principles and status table to reflect latest proxy architecture and drift definition
• 74a1784 feat: GenerateChannelSkill + resolveChannelGeneratedSkills
• c9dc841 feat: parse map-form channel surfaces in pod layer
• 10ca1d3 docs(manifesto): push drift concept to bottom of principles and clarify as open metric
• a7b3e0e docs(manifesto): clarify proxy intercepts cognitive intent, not raw network traffic
• 443844f docs(manifesto): refine claims about access control and proxy intermediation
• f810aee docs(manifesto): structural reorganization for clarity
• 2896441 feat: add ChannelConfig types to ResolvedSurface
• 8f458b9 docs: remove outdated syntax from pod examples
• 6b7bf0b docs: define Master Claw hierarchy and Hub-and-Spoke Governance model
• 105f8ee docs: transition cllama from per-agent sidecar to shared pod-level proxy
• 40d537a docs: rename judgment proxy to governance proxy to reflect broader role
• ff9e14e docs: update README with cost containment preamble, principles, and ADR links
• ef2806c docs: emphasize cost containment and rate limiting in cllama standard
• 57dbc32 docs: add architecture decision records and cllama spec
• 7c1024f docs: add TESTING.md with spike test runbook
• 56fbc44 docs(readme): update status table, social topology section, trading-desk description
• c224331 docs: update status, add UPDATING index, remove completed planning files
• f110daa feat: social topology — mentionPatterns, allowBots, peer handles + trading-api webhook mentions
• 894b344 feat: INVOKE scheduling + Discord config wiring — spike passing
• f830b93 Progress commit while iterating e2e spike test
• 1eb9627 fix: openclaw base image Dockerfile + spike test wiring
• 2fc981e feat: INVOKE + Discord config wiring — jobs.json, correct openclaw schema
• 89c1652 fix(trading-desk): remove Alpaca from agents, add real mock trading-api
• 3c98208 refactor(trading-desk): consolidate to single shared Clawfile
• 23d1955 fix: replace image: with build: in all claw service definitions
• 3652ca9 fix: repair trading-desk example — missing files, stale references, HANDLE docs
• 32e67ae docs: tighten RE...