Skip to content
🧭
Atlas orientation route

FAQ

Route the question first: owner, workflow, or system.
Validated Β· Oct 6, 2026October 6 proof: Clawdy's answers converged to the verified GPT-6 model (read from Clawdy's own gateway config over Bridge); the agent picker covers all nine agents; the map-currency answer explains the site-wide Validated chip.
Question β†’ destination

Keep the first decision literal: pick the route that matches your question.

These question-led rows give you the three route families with one β€œwhy this page” cue, so you can leave FAQ quickly without reading the whole library top to bottom.

Stop rule
  • Take a route row: when Owner, Workflow, or System is enough to choose the next page.
  • Use the reader lenses: when the question still branches across FAQ families.
  • Use the lower library: only after those two layers fail to settle the question.
Who should do it?

Open Capabilities when the real question is which worker owns this kind of request, who to ask first, or whether you need Scout, Meg, Atticus, Grafton, Samwise, or the Labs pair (Dexter and Buzz).

Worker question
Open Capabilities

Why this page: Why this page: it separates agents by role boundary, not by whichever one you happened to hear about last.

What workflow should I follow?

Open Workflows when you already know the people involved but need the operating path, handoff sequence, or closeout pattern for a real request.

Workflow question
Open Workflows

Why this page: Why this page: it shows how work moves, so you do not mistake a worker for the process they participate in.

What system should I check first?

Open Infrastructure when your question is about ports, mirrors, gateways, shared services, or which surface is canonical versus preview-oriented.

System question
Open Infrastructure

Why this page: Why this page: it grounds the system map before you chase the wrong endpoint, especially around Bridge, Kokoro, and Meg's mirrored previews.

Top-level route contracts

Pick the lane, then the page

Atlas stays easier to scan when the route map reads like navigation first. Start with the lane that matches your question, then expand the full page-job model only when you need the deeper contract details.

Current lane: Entry
FAQHere

Question-first shortcut when the reader starts with confusion instead of a route plan.

Start hereCurrent pageSteady

Change pace: Usually current for a while, but revisit when routes, ownership, or workflows shift.

Best next move
Then jump to the owning page

Use the FAQ to sort the question, then move to the page that actually owns the answer.

Open Capabilities
Start here

Entry

Use these pages when you are still orienting and need the safest first click before you pick an owner or system.

3 pages
Home

Shortest whole-site overview before you choose a deeper page.

Steady
Getting Started

Guided first-five-minutes path for readers who want a tour instead of a reference page.

Steady
FAQHere

Question-first shortcut when the reader starts with confusion instead of a route plan.

Steady
Who owns the work

Ownership

Use these pages when your real question is who should handle the work, how it moves, or which charter owns the surface.

4 pages
Projects & Charters

Charter and surface ownership map for the network.

Steady
Capabilities

Worker-selection page for choosing the right agent and understanding execution boundaries.

Steady
Coordination

Decision-and-handoff layer for how work gets routed between people, agents, and systems.

Steady
Workflows

Execution-story page for how real work usually unfolds from intake to visible closeout.

Steady
How the network is built

Systems

Use these pages when you need the map, structure, services, and interfaces behind the network instead of the people or routing rules.

5 pages
Network Topology

Whole-network reference map of agents, systems, and relationships.

High-change
Architecture

Rationale layer for why the network is shaped this way and what tradeoffs drove it.

Stable reference
Bridge

Communication-system page for how agents ask, hand off, and consult one another.

Steady
Infrastructure

Platform-surface page for where the network runs and which services or access layers support it.

High-change
API Reference

Interface reference for endpoints, payloads, and package-level service details.

Steady
What to do when it hurts

Operations

Use these pages when something feels broken, you need a concrete next check, or you need the live-status companion surface.

2 pages
Troubleshooting

Symptom-first page for named failures, first checks, and practical fixes.

High-change
Watchtower Guide

Operational companion page for when the question is about live health and current status rather than static explanation.

High-change
What this October 6 refresh confirmed

This FAQ now matches the current nine-agent map while keeping the source-health story explicit

This October 6 re-audit keeps the FAQ's agent roster in sync with the rest of Atlas. The agent picker now includes Samwise (intake and delivery), Dexter (Labs leader), and Buzz (Labs distribution) alongside the existing six agents. Owner, Workflow, and System still route to Capabilities, Workflows, and Infrastructure; Grafton remains the lifecycle steward, Kokoro stays anchored to its internal 8787 TTS surface, Meg's preview-oriented Atlas and Watchtower mirrors remain on 18803 and 5181, and live-status questions still route to the OpenObserve-first observability lane. This pass also re-proved Scout's charter-cycle bullet against the live gateway-cron roster: Watchtower, Atlas, and Podcast Platform run every 4 hours, Forge runs twice daily, and the bullet no longer teaches a running 4-hour cycle for charters whose crons are not currently enabled.

Why trust this page
  • Freshness gate: revalidated on October 6 against the current capabilities, coordination, workflows, infrastructure, watchtower-guide, and troubleshooting routes, the live Scout gateway-cron roster, plus the single question-led router now leading the page. The new map-currency answer explains the site-wide Validated chip and its proof line, and points live-runtime questions at the observability lane.
  • Biggest checks: nine-agent map now matches the live Atlas explanation including Dexter and Buzz from Labs, the Owner/Workflow/System exits still point to the right deeper pages, and the OpenObserve-first runtime guidance plus the source-health warnings stayed aligned.
  • Best use: open this page when your question starts with β€œwhat changed?”, β€œwho should handle this?”, or β€œwhich page should I trust first?”
How to read this page

Use the routing layer first, then drop into reference only if you still need detail

The route rows above are the actual routing layer. They help you pick the right page, worker, or workflow without reading the entire FAQ top to bottom. Use the long-form sections below only when the short path did not settle your question and you need the reference answer library.

Fast path by intent
Question-family chooser

Pick the FAQ lane that matches your question before you scan the whole library.

The full directory is still below, but this chooser gives you one current-focus recommendation first so you can jump straight to the right family.

Fast rule

If you are unsure, pick the lane that sounds most like your starting question, open that family, and only come back to the full directory if the answer still branches.

Current FAQ focus

I am new here and need the fastest mental model

Use General Concepts when the blocker is not detail but orientation. It gives you the smallest shared model that makes the later answers readable.

Best when

Best for first-time readers, stale five-agent mental models, and β€œwhat is this network?” questions.

You can stop after

Stop after General Concepts once you understand the core terms and which surface explains versus operates the network.

Full question-family directory

Still need detail? Jump straight to the reference family.

The long-form library now lives behind one sticky local table of contents instead of another full wall of cards.

How to use it

Keep the lower-half FAQ scannable

Pick the family first

Use the sticky rail below to jump directly to the question family that matches your blocker.

Watch the current section

The rail keeps the active family and its best related route visible while you move through the long answer stack.

Leave once the owner is clear

Atlas should point you to the owning page, not trap you in every FAQ category in sequence.

Easy-to-confuse concepts

Four fast distinctions that make the rest of Atlas easier to read

If you only remember one thing: Atlas explains the network, while the network's live tools operate it. These quick comparisons help you tell documentation apart from monitoring, roles apart from operating units, shared memory apart from current status, and message routing apart from direct tool use.

Atlas vs Watchtower

Atlas
Static, educational map. Use it to learn what exists, how pieces connect, and why they were designed that way.
Watchtower
Live operational dashboard. Use it to see what is happening right now: health, activity, cron runs, and alerts.
Fast rule: Need explanation? Open Atlas. Need current status? Open Watchtower.

Charter vs agent

Charter
The operating unit: a named mission, owner, boundaries, and ongoing cycle for a body of work like Atlas or Watchtower.
Agent
The worker: Clawdy, Scout, Atticus, Meg, Grafton, Samwise, Dexter, Buzz, or Currybot carrying out tasks inside one or more charters.
Fast rule: Ask β€œwhat body of work owns this?” for the charter. Ask β€œwho is doing it?” for the agent.

Memory vs live state

Memory
Recorded knowledge from notes, decisions, and prior work. Great for what was decided, learned, or shipped.
Live state
Current runtime condition. Great for whether a service is healthy, a cron fired, or an agent is active right now.
Fast rule: Use memory for history and rationale; use live state for health, activity, and β€œis it happening now?” questions.

Bridge vs direct control-plane

Bridge
Agent-to-agent messaging. Use it when one agent needs to ask, hand off, or consult another agent.
Direct control-plane
Tool or gateway actions taken by the current agent itself, like reading memory, sending a message, or managing sessions and cron.
Fast rule: Need another agent’s judgment or ownership? Bridge it. Need to act with your own tools? Use the control plane directly.
Same confusion, practical first move

Four examples that show the distinction in action

β€œScout missed a cycle β€” where do I look first?”

Open Watchtower first. That is a live-state question about whether a cron fired, whether Scout is healthy, or whether alerts were raised.

Use Atlas afterward if you need the architectural explanation for how Scout cycles are supposed to work.

Open Watchtower observability β†’
β€œWho owns Atlas improvements: Scout or Atlas?”

Atlas is the charter; Scout is the agent working that charter. The charter owns the ongoing body of work, while the agent carries out the cycle.

Use the projects view when the question is about ownership boundaries, then the agent page when you want the operator profile.

Open Projects ownership β†’
β€œWhy does everyone say Grafton opened this path, but nothing is happening right now?”

Start with memory if you need the history: prior decisions, routing notes, and progress evidence. Start with live state if you need to know whether a job is currently running or blocked right now.

That is the quickest way to avoid mixing historical explanation with runtime truth.

Open Knowledge memory β†’
β€œScout needs a design opinion β€” should it use Meg or just act?”

If Scout needs Meg’s judgment, it bridges the question to Meg. If Scout already has the needed authority and tools, it acts directly with its own control-plane tools.

This is the cleanest example of bridge versus direct action: ownership and judgment route outward; execution with your own tools stays local.

Open Bridge patterns β†’
Question-first shortcut

If you are asking this question, start here

The comparisons above tell you what each layer is for. This cheat sheet turns that into a practical next move when you are deciding which page, tool, or system to open first.

Question
β€œHow is this system supposed to work?”
Start with
Atlas
Why
Use the docs site when you need architecture, agent roles, workflows, or troubleshooting context.
Question
β€œIs something broken right now?”
Start with
Watchtower
Why
Use the live dashboard when you need current health, recent events, cron outcomes, or runtime activity.
Question
β€œWhich body of work owns this?”
Start with
Projects / charter pages
Why
Use charter-oriented pages when the real question is ownership, scope, and ongoing responsibility.
Question
β€œWhich agent should handle this?”
Start with
Capabilities
Why
Use the agent capability map when you need the right worker, model tier, or access boundary.
Question
β€œShould I ask another agent or use my own tools?”
Start with
Bridge vs direct control-plane rule
Why
Bridge when another agent’s judgment or ownership is needed; act directly when the current agent already has the right tool.
Question
β€œWhat was decided before?”
Start with
Memory / Recall / QMD context
Why
Use memory-backed tools for past decisions, notes, and shipped work β€” not for live runtime truth.
Route picker

Where should I start in Atlas?

If you are new to Atlas, the most confusing part is usually not the network itself β€” it is choosing the right page depth. Start with the entry page that matches how oriented you already are, then use the deeper district pages once you know what kind of answer you need.

Start here if: I want the fastest possible overview before I click anywhere else.

Use this for the one-screen map: what Atlas covers, how the network is organized, and what main paths exist.

Start here if: I am new here and want a guided first pass instead of a reference page.

Use this when you want the start-here walkthrough: mental model first, then the right next pages by task.

Start here if: I already have a concrete question and want a quick answer or chooser.

Use this when your starting point is confusion: which tool, which agent, which page, or what a term means.

Start here if: I want the actual map of agents, systems, and relationships.

Use this when you are ready to move from orientation into the network structure itself.

Fast rule: Home gives the shortest overview, Onboarding teaches the model, FAQ answers specific confusion, and Network is the first real map once you are oriented.

Answers: How is the network designed, and why are the pieces shaped this way?

Use this when you want the big-picture structure, design tradeoffs, and core system boundaries.

Answers: Where does this run, and what services, ports, and deployment layers support it?

Use this when your question is about hosting, containers, shared services, environments, or access paths.

Answers: How do agents send work, questions, or context to one another?

Use this when you are tracing agent-to-agent communication, handoffs, sessions, or routing patterns.

Answers: How do agents decide who should do what, and how do advisory loops work?

Use this when the real question is operating pattern: delegation, advisory, ownership, or workflow shape.

Answers: Which agent can actually do this kind of work?

Use this when your question is about tool access, authority, model tier, or choosing the right worker.

Answers: Something feels broken β€” where do I start and what exact symptoms matter?

Use this when you need named failure modes, step-by-step checks, and practical fixes.

Agent picker

Which agent should I involve first?

If your question is really "who owns this kind of work?", use this quick chooser before you dive into the longer FAQ items. Each card names the best first stop, the kind of request that fits, and where to read more.

Ask this when: Need a high-trust generalist with Jake-facing context?

Start here for cross-cutting questions, high-context assistance, or tasks that need full-access judgment and orchestration.

Ask this when: Need a builder to explore, implement, or ship bounded work?

Use Scout for autonomous cycles, repo changes, documentation improvement, and scoped delivery loops that end in concrete output.

Ask this when: Need a policy, approval, or governance decision?

Route here when the action has real-world impact, needs a proposal review, or depends on explicit decision framing instead of raw implementation.

Ask this when: Need design direction or a visual quality check?

Bring Meg in when the question is about look, feel, component consistency, screenshot review, or whether a UI matches the intended design language.

Ask this when: Need an idea tracked, promoted, or harvested into follow-up work?

Start with Grafton for Seeds, Work Items, stale initiative handling, or lifecycle questions about how work moves from idea to active ownership.

Ask this when: Need intake routing, triage, or end-to-end task ownership?

Use Samwise when a request needs routing into the right work item, a task is stuck in the queue, or you want autonomous delivery from plan through completion.

Ask this when: Need experiment design, validation, or honest assessment of an idea?

Dexter is the Labs leader who guides structured experiments so the founding team can test opportunities without pretending every idea deserves to become a product.

Ask this when: Need audience discovery, distribution design, or market-signal validation?

Buzz is Dexter's distribution counterpart β€” finds audiences, designs approved distribution experiments, and turns learnings into playbooks.

Ask this when: Need a team-facing helper for review, summaries, or LC coordination?

Use Currybot when the work is centered on Lambda Curry team support, communication loops, delegated reviews, or lightweight collaboration tasks.

Request flow

What usually happens after I ask for something?

A lot of first-time confusion comes from not knowing whether an agent will answer immediately, hand the work off, ask another agent, or disappear into an async cycle. This is the usual shape of work in the network.

1. Triage the request

The receiving agent decides whether this is an explanation, a direct tool action, a governance question, or a handoff to a better owner.

2. Keep or delegate ownership

If the current agent already has the right tools and scope, it acts directly. If another agent is the better owner, it bridges the work over.

3. Consult when needed

Some work adds an advisory loop or Atticus review before action. That changes understanding or approval, not necessarily ownership.

4. Do the work in the right lane

Short answers may happen inline. Larger changes often run as bounded cycles, delegated coding sessions, or asynchronous follow-up work.

5. Write back the result

The responsible agent posts the answer, summary, review, or shipped change back to the requesting surface so the handoff closes visibly.

6. Leave a trace

Important work usually leaves memory, observability, PR, or progress-log evidence so the network can explain what happened later.

Fast rule: asking an agent does not always mean that same agent will personally do every step. The network tries to keep the right owner on the work while still making the outcome come back to you.
Worked examples

Four common request paths, side by side

The easiest way to understand request flow is to compare similar asks that branch for different reasons: same network, different first move.

Docs improvement stays with Scout

β€œPlease improve the Atlas docs so a new teammate can tell Atlas from Watchtower.”

  • β€’Scout triages this as Atlas-owned documentation work.
  • β€’Scout keeps ownership because Atlas is Scout’s charter.
  • β€’Scout runs the bounded freshness gate first, then updates the right page.
  • β€’The branch/PR, progress log, and cycle update close the loop visibly.

Why it branches: No other owner is required. The request needs Scout’s own charter workflow, not a cross-agent handoff.

Design judgment routes to Meg

β€œThis new page works, but does it actually match the design system?”

  • β€’Scout may still own the feature work, but the design judgment is Meg’s lane.
  • β€’Scout bridges screenshots or the page context to Meg for review.
  • β€’Meg evaluates against the project design language and returns a punch list or approval.
  • β€’Scout applies the design feedback, then ships with the review loop completed.

Why it branches: Execution can stay local while judgment routes outward. Ownership of the build and ownership of the review are not always the same.

Policy decision routes to Atticus

β€œCan we publish this externally or make a higher-impact system change?”

  • β€’The first agent recognizes a decision-threshold action instead of a routine task.
  • β€’The proposal goes to Atticus for governance review and explicit framing.
  • β€’Atticus approves, denies, or escalates with rationale.
  • β€’Only then does the implementation path continue with the right owner.

Why it branches: This is not just β€œhow do we do it?” but β€œare we allowed to do it?” That changes the route before execution starts.

Clawdy receives it, Scout ships it

β€œPlease update Atlas so a teammate can follow how work moves through the network.”

  • β€’Clawdy can receive the request first because Clawdy is the front door for Jake-level asks.
  • β€’Clawdy recognizes that the actual work belongs to Scout because Atlas is Scout's charter.
  • β€’Scout runs the Atlas cycle, makes the documentation change, and records the result in the project trail.
  • β€’The finished update still comes back through the requesting surface so the person who asked can see that it closed.

Why it branches: The first listener is not always the final executor. Intake and ownership can be different without the request getting lost.

Reference library

Everything below this line is optional deep reference.

If the routing cards above already answered where to go next, you can stop here. The rest of this page is the long-form answer bank for readers who want definitions, examples, edge cases, and troubleshooting detail without leaving the FAQ.

Each question now opens on demand, so you can scan the list first and expand only the answer family you actually need.

🌐 General Concepts

What is the Saffron Network?

Expand this answer when you need the long-form detail.

βŒ„

The Saffron Network is Lambda Curry's multi-agent AI system built on GLM and OpenAI models. It consists of specialized agents working together to handle development, automation, research, and coordination tasks.

The network includes nine agents: Clawdy (Jake's personal assistant),Currybot (LC team assistant), Scout (autonomous explorer/builder),Atticus (decision & governance), Meg (design engineer & visual authority),Grafton (seed & initiative lifecycle manager), Samwise (autonomous delivery agent for triage and execution ownership),Dexter (Labs leader for experiment design and validation), and Buzz (Labs distribution and market-signal agent). These agents communicate via the Bridge protocol and share infrastructure like Recall (knowledge base), Observability (telemetry), and various supporting services.

Open Agent Capabilities

Why multiple agents instead of one?

Expand this answer when you need the long-form detail.

βŒ„

Specialization: Different agents use different models (GPT-5.4 for high-level reasoning, GLM-5.2 for routine tasks) and have different access levels, optimizing for cost and capability.

Context management: Each agent maintains its own conversation history and working memory, preventing context pollution and keeping token costs manageable.

Isolation: Bounded permissions reduce risk. Scout can't access production secrets; Currybot focuses on LC team tasks; Clawdy has full Jake-level access.

Open Architecture Decisions

What do Sky, District, and Street mean in Atlas?

Expand this answer when you need the long-form detail.

βŒ„

They are Atlas's three reading depths. The labels tell you how zoomed in a page is, so you do not have to guess whether you are looking at a big-picture map, one subsystem, or a detailed implementation walkthrough.

Sky

Use Sky pages for orientation: what exists, how major pieces connect, and why the overall network is shaped this way. Start here when you need the shortest explanation before diving deeper.

District

Use District pages when you want one agent or one shared system explained in context β€” responsibilities, boundaries, important connections, and the main internal parts.

Street

Use Street pages for the close-up view: policies, workflows, API details, troubleshooting steps, and other implementation-level specifics.

Fast rule: start at Sky when you are orienting, move to a District when you have picked a part of the network, and use a Street page when you need operational detail.

How does the network differ from a single LLM assistant?

Expand this answer when you need the long-form detail.

βŒ„
  • Explicit delegation: Work is routed to the right specialist, not handled by one generalist
  • Async by default: Long-running tasks don't block the primary agent
  • Observable: Every interaction leaves a trace in the live telemetry stream and related logs
  • Coordinated autonomy: Agents work independently but consult when needed (advisory loops)
  • Specialized tools: Each agent has different skills, sandboxes, and API access

Open Coordination Patterns

What's the difference between Atlas and Watchtower?

Expand this answer when you need the long-form detail.

βŒ„

Atlas (this site) is the educational documentation of the agent network. It explains what agents exist, how they communicate, architecture decisions, and troubleshooting guides. Static content designed to help anyone understand the system.

Watchtower is the live observability dashboard. It shows real-time metrics, event streams, agent activity, and system health. Live monitoring for operational awareness.

If you are trying to understand the current charter map, keep your first stop simple: Atlas for the explained picture, Watchtower for live status. Older workflow examples may still mention Forge as a workspace-generation effort, but that is not the main day-to-day orientation surface readers should start with.

Fast rule: open Atlas when you need explanation, open Watchtower when you need current status, and open Projects when you want the current charter roster.

Think of it as: Atlas = "How does this work?" / Watchtower = "What's happening right now?" / Projects = "What exists right now?"

What's the difference between Coordination and Workflows?

Expand this answer when you need the long-form detail.

βŒ„

Coordination explains how the network decides and routes work. Open that page when your question is about ownership, delegation, advisory loops, escalation, or why one agent consulted or handed off to another.

Workflows explains how a specific kind of work usually unfolds over time. Open that page when you want a step-by-step story such as a charter cycle, code review loop, reminder flow, or request lifecycle from intake to visible closeout.

In plain language: Coordination is the decision-and-routing layer, while Workflows is the execution storyline. One tells you who decides and hands off; the other tells you what sequence usually happens next.

Fast rule: if you are asking β€œwho owns this or why did it move?”, start with Coordination. If you are asking β€œwhat are the usual steps from start to finish?”, start with Workflows.

How current is this map, and what does the β€œValidated” date mean?

Expand this answer when you need the long-form detail.

βŒ„

Every Atlas page carries a Validated Β· date chip beside a one-line proof. The date is the last day Scout re-checked that page against the live network β€” the charter registry, the real cron roster, and the page's own claims β€” not the day the page was written.

The re-check is the freshness gate that opens every Scout cycle: before new work ships, current reality is compared with what the map teaches. When a page's teaching changes, its date moves the same day β€” a Validated date never trails the content above it, and the proof line names what was actually verified, so β€œcurrent” is auditable rather than asserted.

To catch up on the newest verified changes across the map, the home page keeps a current-snapshot strip, newest first. The refresh panel near the top of this page applies the same discipline to the FAQ itself.

Boundary: a Validated date proves the explanation is current, not that the system is healthy right now. For live runtime truth β€” what is running, what is failing β€” Watchtower is the lane; start at Observability & Monitoring.

Fast rule: β€œValidated Β· date” = how fresh this explanation is. Watchtower = what is happening right now. Projects = what exists right now.

πŸ€– Agents & Roles

Who is Clawdy?

Expand this answer when you need the long-form detail.

βŒ„

Clawdy is Jake's primary AI assistant, powered by GPT-6. Clawdy handles:

  • Daily task coordination and reminders
  • Technical questions and research
  • Code review orchestration (delegates to Currybot)
  • Knowledge search via Recall
  • Meeting notes processing and summarization
  • Cross-agent delegation via Bridge

Clawdy has full access to Jake's workspace, secrets, and can execute arbitrary commands. Available via WhatsApp, Slack, and CLI.

Open Agent Capabilities

What does Scout do?

Expand this answer when you need the long-form detail.

βŒ„

Scout is the autonomous explorer and builder, powered by GLM-5.3. Scout:

  • Runs scheduled charter cycles on gateway crons β€” Watchtower, Atlas, and Podcast Platform every 4 hours; Forge twice daily (roster verified September 2026)
  • Builds and maintains internal tools and dashboards
  • Researches emerging technologies and patterns
  • Prototypes new ideas and experiments
  • Delegates coding work to Codex CLI
  • Consults Clawdy's advisor for feedback and direction

Scout works in bounded cycles: orient β†’ work β†’ log β†’ report. Each cycle is 1-2 hours, with clear start/end and concrete deliverables. Scout has sandboxed access and cannot touch production systems.

Open Coordination Patterns

What's the difference between Clawdy and the Advisor?

Expand this answer when you need the long-form detail.

βŒ„

Clawdy (GPT-6) is Jake's primary assistant with full access and execution capabilities.

Clawdy Advisor (GLM-5.2) is a read-only management layer that Scout bridges to for guidance. The Advisor:

  • Has access to the LC knowledge base via Recall
  • Can answer questions about past decisions, team context, project status
  • Provides strategic direction and feedback for Scout
  • Can Slack Jake when Scout needs human action
  • Cannot execute commands, modify files, or take actions

Think of the Advisor as a consultant: Scout comes with questions, gets feedback, then goes back to work. The Advisor doesn't do the work itself.

This is the same pattern as advisory vs delegation: advice changes the worker's understanding, while delegation changes who owns execution.

How does Currybot fit in?

Expand this answer when you need the long-form detail.

βŒ„

Currybot is the LC team assistant (GLM-5.2, hosted on Railway), focused on:

  • PR reviews and code quality checks
  • Team coordination and task tracking
  • Documentation updates
  • Answering LC-specific questions

Currybot receives delegated work from Clawdy (e.g., "review this PR") and posts results back. Available in LC team Slack channels and can interact with GitHub via CLI.

Who is Atticus and what does governance mean here?

Expand this answer when you need the long-form detail.

βŒ„

Atticus is the decision & governance agent, added to the network in February 2026. Instead of baking policy rules into every agent's prompt, Atticus is a dedicated agent that other agents consult before taking significant actions.

When an agent wants to take an action that could have real-world impact, it sends a proposal to Atticus via Bridge:

  • auto-approve β€” Standard action within established boundaries. Proceed immediately.
  • needs-human β€” Unusual scope or risk. Escalated to Jake for review before proceeding.
  • deny β€” Violates a policy. Response includes guidance on safer alternatives.

Every Atticus decision is logged as an observability event, creating a full governance audit trail. This means you can always query what decisions were made, by whom, and why.

Why a separate agent? Policies change. With Atticus, you update governance rules in one place rather than patching every agent's system prompt. It also keeps individual agents focused on their core task rather than second-guessing every action.

Open Decision Framework Β· Governance Policies

Who is Meg and what does a design engineer do here?

Expand this answer when you need the long-form detail.

βŒ„

Meg is the design engineer and visual authority of the Saffron Network, added in February 2026. She's named for Meg Murry from A Wrinkle in Time β€” stubborn, principled, deeply technical.

Meg's core job: make sure UI built by coding agents actually looks right, and stays consistent as the network grows. She owns the visual layer end-to-end:

  • PDLP β€” Project Design Language Packages: versioned constraint files that define a project's complete visual identity (color roles, type scale, components, layout). Coding agents load these as reference during build loops.
  • Screenshot reviews β€” After agents ship UI changes, Meg takes a screenshot and runs a vision audit against the PDLP, returning a prioritized punch list (broken β†’ drifting β†’ needs-attention).
  • Component library β€” Builds and maintains a Storybook of primitives (shadcn + Tailwind) that Scout and other coding agents pull from.

Why this matters: Coding agents can't see what they build. Meg closes that gap β€” not by giving agents eyes, but by building a structured review loop that catches visual drift before it ships.

Runs on port 18802. Model: GLM-5.2.

Open Meg β€” Capabilities Β· Design System

Who is Grafton and what is seed/initiative lifecycle management?

Expand this answer when you need the long-form detail.

βŒ„

Grafton is the seed and initiative lifecycle manager β€” the gardener of the Saffron Network. Grafton doesn't decide what to build; Grafton makes sure ideas that are ready get tracked, stale work gets flagged, and completed work gets harvested back into new opportunities.

The lifecycle has two stages:

  • Seeds β€” lightweight idea records (problem framing, rough upside, named owner). Grafton tags the domain, routes to the right sponsor, and watches for stale seeds. Before a Seed can be promoted to active work, Grafton runs a promotion gate: is there a falsifiable problem framing? A named owner? At least one scoped work item?
  • Work Items β€” concrete execution units spawned from promoted Seeds. Assigned to domain agents (Scout, Meg, Currybot, etc.). Grafton flags anything stalled for 1+ week and routes chronic scope disputes to Atticus.

When a Work Item finishes, Grafton runs a harvest loop: verify the result summary is filled, check if dormant Seeds are now unblocked, and create linked Draft Seeds from new opportunities the result reveals. Harvest plants the next crop.

Trust tier: Operator. Grafton can read/write Seeds and Work Items and send bridge messages, but cannot approve promotions, make strategic recommendations, or override sponsor decisions.

In other words: Grafton is an agent, while the lifecycle rules and ongoing work it manages belong to a charter-level system.

Open Lifecycle Model Β· Integration Guide

What should I expect from a response β€” a quick answer or a full cycle?

Expand this answer when you need the long-form detail.

βŒ„

Response depth depends on the kind of request you sent.

  • Questions and lookups β€” the agent answers inline, usually within seconds to a few minutes. If you can phrase it as a question, expect a direct answer.
  • Scoped builder work (new feature, doc update, code change) β€” Scout runs a bounded cycle: orient, work, log, report. Expect 1–2 hours and a concrete deliverable (PR, progress log entry, or shipped change) at the end.
  • Governance or design review β€” routes through Atticus or Meg first before implementation continues, which adds an advisory round to the timeline.

Fast rule: phrase it as a question β†’ expect an answer. Phrase it as "please build, change, or ship" β†’ expect a cycle. If you are not sure whether Scout is in a cycle or has already finished, check the progress log or Watchtower for the most recent activity.

Open Coordination Patterns

My request got an answer, but it's incomplete β€” how do I follow up?

Expand this answer when you need the long-form detail.

βŒ„

Three patterns work well for incomplete answers:

  • Add context or sharpen the ask β€” "The first pass was close, but I need the output to also cover X." Most gaps come from the original request being ambiguous, not the agent being wrong.
  • Ask for a specific next step β€” "Can you expand the troubleshooting section to cover Y?" This is more efficient than re-sending the whole request and lets the agent continue from the right spot.
  • Reference the prior artifact β€” If the answer came from a bounded cycle, reference the PR or progress log entry directly: "Following up on PR #26 β€” can we add Z to the same page?" The agent can pick up exactly where the work left off.
Note: Agents do not retain memory across separate conversations by default. If your follow-up is in a new session, briefly re-anchor it β€” "Following up on the Atlas FAQ work from this morning: ..." β€” so the agent has enough context to continue without reconstructing the whole history.

Open Coordination Patterns

My issue isn't getting resolved β€” how do I escalate?

Expand this answer when you need the long-form detail.

βŒ„

The network has a clear escalation ladder. Work through it in order:

  1. Try a different phrasing or surface. If Currybot didn't get it, try Clawdy with more context. A concrete, specific ask almost always performs better than a broad or vague one.
  2. Bridge to a specialist. Design question? Involve Meg. Governance or policy question? Involve Atticus. Build question where Scout is looping? Involve Clawdy as orchestrator. The right owner on the work matters more than rephrasing.
  3. Atticus review for policy ambiguity. If the issue feels stuck because no one is sure whether the ask is in-scope, route it to Atticus. Atticus can evaluate the proposal and return a clear decision or a path forward.
  4. Slack Jake directly. Use this for anything that needs a human decision, a production-level access change, or has been stuck in the network for more than one full cycle without visible progress.
Fast rule: if you've asked twice and gotten the same incomplete result, the issue is usually scope or ownership β€” not model quality. Reassigning to a different owner almost always helps more than rephrasing.

πŸŒ‰ Communication & Coordination

How do agents communicate with each other?

Expand this answer when you need the long-form detail.

βŒ„

Agents use the Bridge protocol for inter-agent communication. The current Bridge v1 wrapper is verb-first: use call for a bounded answer, add --detach when work should continue independently, then use watch or result to follow up. interject adds a focused turn to an existing session, cancel stops a stale or unsafe turn, and list recovers local turn history.

  • Routes messages between agent gateways
  • Supports bounded calls and detached work without teaching legacy aliases as the main path
  • Includes session management for multi-turn conversations
  • Logs all interactions into the live telemetry stream

Example: when Scout needs Atticus's governance judgment, it can call Atticus for a bounded answer. If the work should continue independently, Scout detaches the call and later watches the turn or reads its result instead of treating the handoff as a synchronous-only exchange.

Bridge is for agent-to-agent routing. If an agent can solve something with its own tools or gateway directly, that is not a Bridge hop β€” that is direct control-plane work by the current agent.

Open Bridge Layer for the current route split, or Bridge Communication for the detailed transport patterns.

When should an agent bridge to someone else instead of using its own tools?

Expand this answer when you need the long-form detail.

βŒ„

Use Bridge when the work needs another agent's ownership, judgment, or authority. Use the current agent's direct control-plane tools when it already has the right access and the work stays inside its own lane.

Bridge example

Clawdy needs a PR review. It does not review code with its own local tools; it bridges to Currybot because Currybot owns that execution lane and returns the review.

Direct control-plane example

Scout wants to look up prior context or schedule a reminder. It uses memory_search or cron directly because no other agent is needed to own that action.

Fast rule: if you are asking "who should own this?" or "whose judgment do I need?" bridge it. If you are asking "can I do this with the tools I already have?" use the control plane directly.

What are advisory loops?

Expand this answer when you need the long-form detail.

βŒ„

Advisory loops are multi-turn conversations between Scout and Clawdy's Advisor. Scout uses these for:

  • Getting feedback on work completed
  • Asking strategic questions about priorities
  • Clarifying ambiguous requirements
  • Reporting blockers that need human action

Pattern: Scout completes a work cycle β†’ bridges to Advisor with "Here's what I did, what's next?" β†’ Advisor searches knowledge base and provides guidance β†’ Scout continues with new direction.

Loops are kept to 3-5 turns maximum to avoid context drift.

Open Coordination Patterns

What's the difference between delegation and advisory?

Expand this answer when you need the long-form detail.

βŒ„

Delegation: One agent hands off a complete task to another agent who executes it independently.

Example: Clawdy β†’ Currybot: "Review PR #123 and post feedback"

Advisory: One agent consults another for guidance but continues doing the work itself.

Example: Scout β†’ Advisor: "I built feature X, should I add Y next or focus on Z?"

Delegation transfers responsibility; advisory transfers knowledge.

Can agents see each other's conversations?

Expand this answer when you need the long-form detail.

βŒ„

No. Each agent has its own conversation history and working memory. Agents are isolated by default.

However, agents can share information explicitly via:

  • Bridge messages β€” Direct communication with full context in the message payload
  • Shared knowledge base (Recall) β€” Agents write to and search the same QMD documents
  • Observability events β€” All agents emit telemetry that's centrally logged

This isolation prevents context pollution and keeps token costs manageable.

πŸ—οΈ Infrastructure & Deployment

Where does the agent network run?

Expand this answer when you need the long-form detail.

βŒ„

The entire network runs on Jake's Mac mini at his home office in Austin, TX. The Mac mini is connected to a Tailscale mesh VPN for secure remote access.

Deployment architecture:

  • Each agent runs in a Docker container (managed via docker-compose)
  • Currykit services run as separate containers or host processes
  • Dev servers (Atlas, Watchtower) run inside Scout's container with ports mapped
  • Tailnet-only access via Tailscale machine hostname for authenticated team members

Open Infrastructure & Deployment

What is Currykit?

Expand this answer when you need the long-form detail.

βŒ„

Currykit is Lambda Curry's infrastructure monorepo β€” shared services that power the agent network:

  • Recall (port 8790) β€” RAG search engine with QMD embeddings
  • Observability Collector (port 18801) β€” Telemetry and event logging
  • Bridge β€” Agent-to-agent communication CLI/HTTP service
  • Kokoro Proxy (internal service on port 8787) β€” Local TTS service; the old host-facing 18803 mapping now fronts Meg's Atlas preview instead
  • Currybox (port 18800) β€” Cloud sandbox proxy (Vercel microVMs), part of the active shared-service surface in the Apr 14 audit
  • RAG Sync β€” Notion/Jira/Linear sync pipelines for knowledge base
  • QMD Public Proxy (port 18790) β€” Scoped proxy that filters QMD access to approved indexes and collections for external callers

All agents use these services. They're maintained in the lambda-curry/saffron monorepo under packages/, published as @lambda-curry/currykit-* to GitHub Packages.

Open Infrastructure & Deployment

How do dev servers work inside Docker?

Expand this answer when you need the long-form detail.

βŒ„

Dev servers (like Atlas and Watchtower) run inside Scout's Docker container, and some are additionally mirrored through Meg's preview range. Key details:

  • Port mapping: Container ports are mapped to host in docker-compose.yml so they're reachable on the Tailscale network
  • Host binding: Servers must bind to 0.0.0.0 (not localhost) to be reachable from outside the container
  • Allowed hosts: Vite requires allowedHosts: true to accept Tailscale hostname requests
  • Access: Apps are accessible to the LC team via the Tailscale mesh using the machine hostname
  • Current remaps: Atlas still lives on Scout at 18797 and Watchtower at 5175, while Meg now mirrors them on 18803 and 5181 for preview-oriented access
  • Current caveat: Bridge is now represented as its own OpenClaw agent surface, while Currybox remains a distinct shared sandbox service on port 18800

Example Vite config for any Scout sub-project:

  • Pick a unique port for the dev server
  • Vite config: host: '0.0.0.0', allowedHosts: true
  • Port must be added to docker-compose.yml and entrypoint.sh (host files β€” Jake's responsibility)

How are secrets managed?

Expand this answer when you need the long-form detail.

βŒ„

Secrets are managed via environment variables in docker-compose.yml:

  • API keys: OpenAI, Z.AI, Slack, etc. injected at container start
  • Tokens: Observability-surface credentials, gateway auth tokens
  • Access control: Agent-specific env vars (e.g., Scout doesn't get production tokens)

Secrets are never committed to git. Jake manages the docker-compose.yml file on the host.

Agents have different secret access levels based on their role and isolation requirements.

Open Infrastructure & Deployment

πŸ“š Knowledge & Memory

How does RAG (Retrieval-Augmented Generation) work?

Expand this answer when you need the long-form detail.

βŒ„

The Saffron Network uses Recall as its RAG search engine:

  1. Ingestion: RAG Sync pipelines pull content from Notion, Jira, Linear, meeting notes
  2. Embedding: Text is chunked and embedded using OpenAI's text-embedding-3-small model
  3. Storage: Embeddings stored in QMD (Quantized Memory Database) β€” fast, local vector DB
  4. Search: Agents query Recall with natural language β†’ semantic similarity β†’ top K results
  5. Context injection: Retrieved snippets added to agent prompts as additional context

Example: Jake asks "What did we decide about caching?" β†’ Clawdy searches Recall β†’ finds meeting notes from 2 months ago β†’ uses that context to answer accurately.

What is QMD?

Expand this answer when you need the long-form detail.

βŒ„

QMD (Quantized Memory Database) is the vector database powering Recall. It's optimized for:

  • Speed: Fast similarity search on millions of vectors
  • Efficiency: Quantization reduces memory footprint
  • Local deployment: Runs on the Mac mini, no external service dependencies
  • Multi-collection: Separate indexes for lc-notes, lc-team, etc.

Recall (HTTP service, port 8790) wraps QMD and provides the search API used by agents.

What gets synced to the knowledge base?

Expand this answer when you need the long-form detail.

βŒ„

The RAG Sync service pulls content from:

  • Notion: Meeting notes, project docs, decisions, retros
  • Jira: Issue descriptions, comments, sprint notes
  • Linear: Task context, feature specs
  • Agent memory: Important decisions, milestones, learnings

Content is synced every 15 minutes. Agents always have access to the latest team knowledge.

Collections: lc-notes (meeting notes), lc-team (team info)

Can agents write to the knowledge base?

Expand this answer when you need the long-form detail.

βŒ„

Yes. Agents write to MEMORY.md and memory/*.md files in their workspace. These files are:

  • Indexed by Recall (searchable via semantic queries)
  • Version-controlled via git (full history)
  • Visible to other agents via search (but not direct file access)

Pattern: Scout completes a cycle β†’ appends summary to memory/progress-log.md β†’ Recall indexes it β†’ Clawdy can later search "What did Scout work on last week?"

That memory is excellent for what happened or what was decided; it is not a guarantee of what is true right now. For current runtime status, use live observability tools instead.

πŸ“Š Observability & Monitoring

What is the observability stack now?

Expand this answer when you need the long-form detail.

βŒ„

Atlas now treats observability as a layered system instead of a single SQLite-first collector:

  • OpenObserve: primary live telemetry source for current events and service evidence
  • Watchtower: operator surface that reads OpenObserve and applies expected-state context
  • Legacy collector docs: older Atlas API examples kept only as historical request-shape context

If the question is what is true right now, start with Watchtower or the observability district. Do not treat the old SQLite collector examples as the live source-of-truth model.

Best route: Observability

How do I debug an agent issue?

Expand this answer when you need the long-form detail.

βŒ„

Follow the 5-step debugging process:

  1. Check Watchtower β€” View recent events and agent activity dashboards
  2. Query the current observability source β€” Use the OpenObserve-backed surface for live traces, then fall back to legacy collector docs only if you explicitly need the older API shape
  3. Inspect agent logs β€” docker logs <agent> for container output
  4. Test in isolation β€” Call services directly (curl) to rule out dependencies
  5. Follow the chain β€” Trace requests through Bridge using correlation IDs

Full guide: Troubleshooting

What services emit telemetry?

Expand this answer when you need the long-form detail.

βŒ„

All Currykit services automatically emit telemetry that Atlas now treats as OpenObserve-first live evidence:

  • bridge β€” Agent-to-agent communication (calls, sessions, timeouts)
  • recall β€” Knowledge search queries (embeddings, results, latency)
  • currybox-proxy β€” Sandbox operations (exec, status, errors)
  • kokoro-proxy β€” TTS requests (generation, output)
  • delegation β€” Task handoffs to Codex or other agents

Agents can also emit custom events (e.g., Scout logs cycle start/end).

How long is telemetry data retained?

Expand this answer when you need the long-form detail.

βŒ„

Atlas does not publish a single fixed retention promise for live telemetry anymore.

  • Current live path: retention belongs to the current OpenObserve deployment and can change with operator configuration
  • Atlas guarantee: Atlas explains which surface owns live truth versus legacy API context
  • Legacy SQLite examples: historical context only, not a current storage contract

If retention matters operationally, verify the current Watchtower/OpenObserve configuration with the owning observability docs and operators instead of relying on a hard-coded FAQ number.

πŸ› οΈ Development & Skills

What are agent skills?

Expand this answer when you need the long-form detail.

βŒ„

Skills are specialized instruction sets that agents can load dynamically based on task type. Each skill is a directory containing:

  • SKILL.md β€” Instructions and context for the agent
  • Helper scripts, config files, or templates
  • Reference documentation and examples

Example skills: coding-agent (Codex integration), github (gh CLI usage),weather (forecast API), session-logs (log analysis)

Skills are automatically discovered and matched to tasks. Agents read the relevant SKILL.md at runtime.

Open Agent Capabilities

How does Codex CLI work?

Expand this answer when you need the long-form detail.

βŒ„

Codex CLI is a coding agent (gpt-5.3-codex) that Scout delegates implementation work to. Workflow:

  1. Scout identifies a coding task (e.g., "add FAQ page")
  2. Scout writes a detailed prompt with requirements
  3. Scout runs codex exec "prompt" in the project directory
  4. Codex reads project context (ai-rules, files, etc.)
  5. Codex makes changes, runs tests, verifies build
  6. Scout reviews git diff and commits if approved

This keeps Scout focused on planning/coordination while Codex handles implementation details.

What are AI rules?

Expand this answer when you need the long-form detail.

βŒ„

AI rules are project-specific instructions for coding agents. Stored in ai-rules/ directories:

  • Universal rules: /app/ai-rules/ (apply to all projects globally)
  • Project rules: projects/atlas/ai-rules/ (specific to that project)

Example rules: coding style, testing requirements, build verification, architecture constraints.

Codex CLI automatically discovers and includes relevant rules in its context before making changes.

How do I add a new skill?

Expand this answer when you need the long-form detail.

βŒ„

To create a new skill:

  1. Create directory: skills/my-skill/
  2. Write SKILL.md with clear instructions, examples, and constraints
  3. Add helper scripts or templates as needed
  4. Test by prompting an agent with a task that matches the skill description

Skills are automatically discovered based on their <description> tag in the skill registry. Agents scan available skills and load the most relevant one for each task.

For complex skills, use the skill-creator skill to help structure the new skill properly.

πŸ”’ Security & Access

What are the access boundaries for each agent?

Expand this answer when you need the long-form detail.

βŒ„

Agents have different permission levels based on their role:

Clawdy (Full Access):
  • Arbitrary command execution
  • Read/write all files in Jake's workspace
  • Access to production secrets and API keys
  • Can deploy, restart services, modify configs
Scout (Sandboxed):
  • Read/write only in projects/ subdirectories
  • No production secrets (dev/test tokens only)
  • Cannot modify host system or other agent workspaces
  • Limited to internal tools and documentation projects
Advisor (Read-Only):
  • Knowledge base search only (no command execution)
  • Cannot modify files or trigger actions
  • Can Slack Jake for human intervention

Open Agent Capabilities

How is Atlas access controlled?

Expand this answer when you need the long-form detail.

βŒ„

Atlas and Watchtower are still tailnet-first internal apps. The network now has a selective Tailscale Funnel ingress layer for services like Bridge, hooks, Oracle, Linear Agent, Samwise, and QMD, but those public paths do not make Atlas or Watchtower general-public sites.

  • Access is primarily limited to devices signed into approved LC team Tailscale accounts
  • The canonical app URLs still use the tailnet hostname (for example, http://main-mini:18797/ for Atlas and http://main-mini:5175/ for Watchtower)
  • Meg also mirrors Atlas and Watchtower on preview-oriented tailnet ports 18803 and 5181
  • No broad public website endpoint is published for Atlas or Watchtower

Team access is managed at the network layer (Tailscale ACL + device auth), with optional app-level guards where needed.

This keeps Atlas discoverable for collaborators while avoiding public exposure.

Can agents access the internet?

Expand this answer when you need the long-form detail.

βŒ„

Yes, but access varies by agent:

  • Clawdy: Full internet access (web search, fetch, API calls)
  • Scout: Limited to documented APIs (Observability Collector, Recall, Bridge)
  • Currybot: GitHub API, LC internal services, web search

All outbound requests are logged into the observability stream for audit trails.

Docker networking allows agents to reach host.docker.internal for services running on the Mac mini.

What happens if an agent is compromised?

Expand this answer when you need the long-form detail.

βŒ„

The network is designed with isolation layers to limit blast radius:

  • Sandboxing: Scout can't access production or modify host
  • Secret isolation: Each agent only gets secrets it needs
  • Observability: All actions are logged; anomalies are detectable
  • Network isolation: Containers can't reach arbitrary services

Mitigation: Stop the container β†’ review logs β†’ rotate secrets β†’ redeploy from known-good image

Current risk is low: agents run on a private Mac mini (not public cloud), with no external write access.

πŸ’° Cost & Resources

What are the model costs?

Expand this answer when you need the long-form detail.

βŒ„

The network uses a tiered model strategy to balance capability and cost:

  • GLM-5.3 (Scout) β€” Scout's gateway runs the newer GLM release as its primary model, ahead of the network default
  • GLM-5.2 (Atticus, Meg, Grafton, Samwise, Currybot) β€” network default model; used for autonomous cycles, routine tasks, and team coding support
  • Codex CLI (Scout's coding delegate) β€” specialized coding model; cost-effective for implementation work
  • OpenAI Embeddings β€” very low cost per token; used for RAG indexing

Cost optimization: Use GLM-5.2 for routine work, GPT-5.4 for complex reasoning. Delegate coding to Codex to reduce token burn on the primary agents.

How is token usage tracked?

Expand this answer when you need the long-form detail.

βŒ„

Token usage is tracked in multiple layers:

  • Per-request: OpenClaw gateways log input/output tokens for every API call
  • Per-session: /status command shows cumulative token usage
  • Per-agent: OpenObserve-backed observability surfaces aggregate usage across sessions
  • Budget alerts: Codex has a 5-hour rolling window limit to prevent runaway costs

Watchtower displays live token usage and cost projections.

How do you optimize model usage?

Expand this answer when you need the long-form detail.

βŒ„

Several strategies reduce token costs:

  • Task routing: Send routine tasks to GLM-5.2, complex reasoning to GPT-5.4
  • Delegation: Scout delegates coding to Codex (cheaper than full-model turns for implementation)
  • Context pruning: Use memory_search to fetch only relevant snippets (not entire files)
  • Session isolation: Keep conversations focused; spawn sub-agents for tangential work
  • Caching: Reuse RAG search results when possible (Recall has semantic caching)

Scout checks Codex usage before heavy coding sessions to avoid hitting rate limits.

What are the infrastructure costs?

Expand this answer when you need the long-form detail.

βŒ„

The network runs on self-hosted hardware, so infrastructure costs are minimal:

  • Mac mini: One-time hardware purchase (Jake's existing machine)
  • Tailscale: Free tier (under usage limits)
  • Electricity: comparable to leaving a small desktop computer running 24/7
  • Currybox (cloud sandboxes): Pay-per-use via Vercel (rare usage)

No cloud hosting costs (AWS, GCP, etc.). Total infrastructure cost is effectively nothing beyond electricity.

The bulk of operating cost is API usage (GLM, OpenAI), not infrastructure.

πŸ”§ Troubleshooting

Atlas says one thing, but Watchtower says another β€” which should I trust?

Expand this answer when you need the long-form detail.

βŒ„

Trust the surface that matches the kind of truth you need. Atlas is the educational map β€” it explains what a system is, what it is supposed to do, and how it fits into the network. Watchtower is the live operational view β€” it shows what is happening right now.

Example: Atlas may correctly explain that a service normally runs on a given port and feeds events into observability.
If Watchtower shows that service as unhealthy, stale, or silent, that does not mean Atlas is wrong β€” it means the live system is currently off the happy path.
  • Use Atlas to understand the intended architecture, ownership, and expected workflow.
  • Use Watchtower to verify current health, recent events, alerts, and whether the system is actually behaving that way now.
  • Use both together when debugging: Atlas tells you what should be true; Watchtower tells you what is true right now.

Fast rule: when explanation and live status appear to conflict, treat Atlas as the model and Watchtower as the present-state check.

Agent not responding β€” what do I check first?

Expand this answer when you need the long-form detail.

βŒ„
  1. Container status: docker ps | grep <agent> β€” Is it running?
  2. Container logs: docker logs --tail 100 <agent> β€” Any errors?
  3. Gateway health: curl http://localhost:<port>/health β€” Is it reachable?
  4. Watchtower: Check recent events β€” When did it last respond?

Full guide: Troubleshooting

Bridge call times out β€” how do I debug?

Expand this answer when you need the long-form detail.

βŒ„
  1. Check target agent is running (docker ps)
  2. Verify network connectivity: curl http://host.docker.internal:<port>/health
  3. Check observability events: filter by service=bridge to see if call was attempted
  4. Review target agent logs for errors or hangs
  5. Test direct HTTP call to target gateway (bypass Bridge) to isolate issue

Common causes: Target agent hung on a long task, network partition, or timeout too short for complex operations.

I followed an old Atlas link and landed somewhere unexpected β€” what happened?

Expand this answer when you need the long-form detail.

βŒ„

Atlas pages live at canonical β€œstreet” addresses organized by owner and system β€” for example /system/knowledge/network instead of the old short address /network. Short addresses from earlier versions of the map still work: twelve legacy short addresses are kept as part of the page map and server-redirect to their canonical street, so an old bookmark or a link from an older page still arrives at the right content.

If an address does not match any page at all, Atlas serves a real β€œPage Not Found” response β€” not a blank error and not a silent redirect to the home page. The not-found page is a small wayfinding surface in its own right: it points back to the Atlas home, the network map, and the capabilities directory, so a stale link is a signpost rather than a dead end.

  • Followed an old short link: let the redirect finish β€” you land on the canonical street with the same teaching.
  • Hit the not-found page: use its wayfinding rows to get back into the map rather than retrying the same address.
  • Publishing links into Atlas: prefer the canonical street address shown in the browser address bar after a redirect.

Start again from: Network map Β· Capabilities directory

Recall search returns empty results β€” why?

Expand this answer when you need the long-form detail.

βŒ„

Common causes:

  • Index not synced: Wait 15 min for RAG Sync to run, or trigger manual sync
  • Wrong collection: Ensure searching correct collection (lc-notes vs lc-team)
  • Query too specific: Use broader semantic terms (e.g., "caching strategy" not "Redis config")
  • Embedding mismatch: New content may not be embedded yet

Debug: Check Recall logs (docker logs recall), verify QMD has vectors (GET /health)

Dev server not accessible via Tailscale β€” what's wrong?

Expand this answer when you need the long-form detail.

βŒ„

Checklist:

  1. Port mapped in docker-compose.yml? β€” Must expose container port to host
  2. Server binding to 0.0.0.0? β€” Not localhost (won't be reachable)
  3. Vite allowed hosts configured? β€” Set allowedHosts: true in vite.config.ts
  4. Container running? β€” docker ps to verify
  5. Test from host first: curl http://localhost:<port>/ β€” If this fails, it's a server config issue (not Tailscale)

Open Infrastructure & Deployment

Where can I get more help?

Expand this answer when you need the long-form detail.

βŒ„

Resources:

  • Atlas: This site (educational documentation)
  • Watchtower: Live system monitoring and recent events
  • Clawdy: Ask Jake's assistant via WhatsApp/Slack
  • Currybot: LC team questions in #currybot-lab
  • OpenClaw docs: /app/docs or docs.openclaw.ai

For emergencies: Slack Jake directly or restart the relevant Docker container.

Continue Reading

Agent Capabilities

Tool access, model tiers, and what each agent can and cannot do.

Open Agent Capabilities
Coordination Patterns

How agents hand work off to each other and stay in sync.

Open Coordination Patterns
Troubleshooting

Named symptoms and step-by-step fixes for common network problems.

Open Troubleshooting