> ## Documentation Index > Fetch the complete documentation index at: https://docs.claw.boo/llms.txt > Use this file to discover all available pages before exploring further. # Org chart and team graphs > See how your agents are organized, on the Org chart or a team graph beside a chat, and give them routes, skills and connectors by dragging. The Org chart draws every agent you have, on every team, around Boo Zero. Each agent appears as a Boo, a small mascot, with lines for how work flows between agents and, when you open one, the skills and connectors it has. Use it to see how your teams are organized and what each agent is doing, and to give agents routes, skills and connectors by dragging. The same canvas appears in smaller places: as a **Team graph** card beside a team's chat (**Room graph** in a room), and as the **Graph** card on an agent's page. ![The Org chart in its Tree layout with team halos on: Boo Zero at the top, each team's badge with a count of running and idle agents, and each team's Boos in a row inside its halo](https://mintcdn.com/privatedocs/6H-VHke03QIa-oHL/images/ghost-graph.png?fit=max\&auto=format\&n=6H-VHke03QIa-oHL\&q=85\&s=34b71bf37bb52bcf2ad5ea30a3ffa335) ## Where the graph appears | Graph | What it draws | Where to find it | | - | - | - | | **Org chart** | Every agent on every team, around Boo Zero | **Org chart** in the sidebar, or `Cmd+1` (`Ctrl+1` on Windows and Linux) | | **Team graph** card | One team's agents and Boo Zero | Beside the team's General chat. See [Team chat](https://docs.claw.boo/using/team-chat.md) | | **Room graph** card | One room's members and Boo Zero | Beside the room's chat | | **Graph** card | One agent with its skills, connectors and model | On the agent's page. See [Agents](https://docs.claw.boo/using/agents.md) | Right-clicking the Boo Zero mascot at the top of the team rail and choosing **Show all agents** also opens the Org chart. The Org chart ignores the team selected in the sidebar and keeps that selection for when you come back. Only the Org chart has the layout switch, team halos, the Activity dock and the agent browser. Beside a chat, Activity and the browser are cards of their own. Each graph keeps its own saved positions, so arranging a room's graph never moves the team's graph or the Org chart. ![A team's Team graph card, maximized: Boo Zero above the team's badge, Ada below the badge, and four teammates under Ada](https://mintcdn.com/privatedocs/6H-VHke03QIa-oHL/images/team-graph.png?fit=max\&auto=format\&n=6H-VHke03QIa-oHL\&q=85\&s=c0b2e3f7364ad35416269aa5f4d133f1) ## Read the graph * **Boos** are your agents. Boo Zero sits at the root, a little larger than the others and in its own red. Under each name, a Boo shows its status and a count such as `12 capabilities · 1 route`. Point at the count to see what kinds they are. A small badge on each Boo shows its runtime. * **Teams** hang from Boo Zero through a junction that wears the team's badge, the same icon as in the team rail. Point at a badge to see the team's name: its Boos light up and the rest dim. On the Org chart, a pill beside each badge counts the team's agents by status, for example **2 running** and **3 idle**. * **Routes** are the red lines with arrowheads between Boos. Each means "this agent hands work to that one", and each is a line in the first agent's AGENTS.md file. See [What a route does](#what-a-route-does). * **Skills and connectors** circle a Boo when you click it, along with the model it runs on. See [Open a Boo](#open-a-boo). * **Thought bubbles** appear while an agent works. The bubble shows what it is doing: its latest words, its reasoning, or the tool it is using, with three pulsing dots. Before anything arrives it says "thinking". After an error the bubble stays, so you can read the reason. * **Status glows**: a running Boo glows mint, a Boo with an error glows red, and a sleeping Boo looks faded. Hovering a Boo dims everything not connected to it, which is the quick way to read one agent's links in a busy graph. The count beside a graph's title, such as `3 Boos · 1 skill`, counts skills only, not tools or connectors. ### What a route does A route is a line such as `- Route to @Sage for delegated tasks.` in the first agent's AGENTS.md file. OpenClaw agents read that file, so a route tells an OpenClaw agent whom to hand work to. Agents on Clawboo Native, Claude Code, Codex and Hermes do not read AGENTS.md: for them a route only draws the line. Those agents can hand work to any member of the chat they work in (see [How a team works](https://docs.claw.boo/intro/how-it-works.md)). ## Open a Boo Click a Boo to fan out its skills (mint), connectors (violet) and model around it. Click it again to fold them. Several Boos can be open at once, and the view zooms to fit what is open. * On a team graph, a room graph and an agent's **Graph** card, a Boo shows every capability it has. * Five or more read-only items of one kind fold into one group tile, such as `41 plugins`. Click the tile to list them. * The Org chart draws at most 24 tiles per Boo and counts the rest on one overflow tile. Open the agent's own **Graph** card to see all of them. With the keyboard, move between Boos with **Tab** and press **Enter** or **Space** to open or fold one. ## Add routes, skills, connectors and agents Every graph that draws a Boo works the same way: pull a thread out of a Boo and let go where you want it to end. **1. Find the port** Point at a Boo. A small disc with a plus, its port, appears on its right edge with the hint **Drag to connect**. On a touch screen the port is always shown. **2. Pull a thread** Drag from the port. Every Boo the thread can reach shows a dashed docking ring. **3. Let go** Drop on another Boo to add a route from the first agent to the second. Drop on empty canvas to open a picker of what the thread can end in: **Connectors**, **Skills** or **New agent**. You should see the new route drawn at once, or the picker open. You can also click a port and then click another Boo. If the route is already there, a message says so and nothing changes. In the picker, type to search every kind at once; the last row offers a new agent with the name you typed. What you pick goes to the agent you pulled from: * A skill is installed on that agent. * A connector is turned on if it is not running yet (with a sign-in, if it has one), and the agent gets Write access to it. Risky calls still ask you first. * **New agent** creates an agent on the same team, already routed from the one you pulled from. On a room's graph it joins the room too. A thread from Boo Zero gives the new agent the graph's team, or on the Org chart the team selected in the sidebar (or your first team). The **New agent** row names the team. A new agent runs on OpenClaw while Clawboo is connected to an OpenClaw Gateway, and on Clawboo Native otherwise, the same as **Create Boo** (see [Agents](https://docs.claw.boo/using/agents.md)). A connector that needs a key or a folder is listed but greyed, with the reason: set it up in [Connectors](https://docs.claw.boo/using/connectors.md) first. ### The + button Every graph's toolbar starts with **+**, labelled **Add a connector, skill or agent** (on an agent's **Graph** card, **Add a connector or skill**). It opens the same picker with no agent behind it, so what you pick lands on the canvas as a loose tile marked **Not attached**. A new agent picked here joins the graph's team, and the room on a room's graph. On the Org chart it joins the team selected in the sidebar, or your first team. To attach a loose tile, point at it: a port appears with **Drag onto an agent** beside it. Drag from the port and let go on a Boo: that agent gets the skill, or the connector at Write access with risky calls still asking first. Point at a loose tile for an **x** that takes it off the canvas. Loose tiles stay after a reload. Each graph keeps its own, and a room's graph shares its team's. ### Give a second agent a skill or connector To install a skill on another agent too, drag from the small handle on the right edge of its tile and let go on that agent's Boo. You can also point at a skill and click **Install →**, then pick an agent. To share a connector, drag from the small handle on the right edge of its tile and let go on another Boo. A dialog opens to share it. The second agent gets its own access, and the first keeps its own. Pick a level: | Level | What the agent can do | | - | - | | **Read** | The default. Only the connector's tools marked as read-only: look things up | | **Write** | Create and update. Risky calls ask you first | | **Admin** | Settings and deletion too | Connecting a connector in **Connectors** gives no agent access by itself: you attach it to agents here. See [Connectors](https://docs.claw.boo/using/connectors.md). ## Take things back Click a line to open its panel at the bottom of the canvas, then click **Remove Connection**. Or select the line and press **Backspace** or **Delete**, as long as you are not typing in a field. * Removing a skill's line takes the skill off that agent. * Removing a share's line ends that agent's access, with an **Undo** for 8 seconds. **Stop sharing** on the connector tile does the same. **Turn off** on the tile stops the connector itself. * Removing a route deletes every line in the first agent's AGENTS.md that mentions the second agent. Removing a route needs the dashboard connected to an OpenClaw Gateway. Without that connection, **Remove Connection** on a route does nothing. Edit the agent's AGENTS.md instead: on its page, open **Details**, then **Agent Files**, then **AGENTS**, and delete the route line. Some lines cannot be removed, and the panel says why: a capability that came with the agent's runtime, and the model tile, which is part of the Boo. **Backspace** never deletes an agent; deleting is on the right-click menu. ## Right-click a Boo Right-click a Boo, or focus it and press the Menu key, **Shift+F10** or **Alt+Enter**, to open its menu: * **Open agent** opens the agent's page, with its chat, files and personality. * **Delete** deletes the agent at once. It works without an OpenClaw Gateway. > [!WARNING] > > **Delete** on the graph does not ask first, and it cannot be undone. If the Boo is still there afterwards, the delete failed without a message. Delete it from the all-agents list instead to see why: right-click the Boo Zero mascot, choose **Show all agents**, and use the agent's trash icon. ## Layouts and tools on the Org chart ### Tree and Radial The **Tree** and **Radial** switch in the Org chart's toolbar picks the layout: * **Radial**, the default, puts Boo Zero in the center with the teams around it. Each team's Boos fan out from its badge, spaced so that no Boo, name or bubble lands on a neighbor. * **Tree** puts Boo Zero at the top and the teams in a row beneath it. Your browser remembers the choice, and each layout keeps its own saved positions. ### Arrange and re-layout Drag Boos to arrange any graph, and Clawboo saves where you put them. **Re-layout** in the toolbar, shown once the first layout has run, drops that graph's saved positions and lays it out again. Use it when Boos overlap or the lines look tangled. ### Team halos **Team halos**, on the Org chart only, draws a colored outline around each team's Boos. A team with one agent gets none. Halos are off each time the app loads. ### Activity and the agent browser * **Activity**, the terminal icon in the Org chart's header, opens a live feed of every team's tool calls, results and errors at the right edge. Close it with the same icon, its close button, or **Escape**. * **Agent browser**, the globe at the end of the toolbar, shows the page an agent is looking at. Tabs pick a team (or **No team** for agents such as Boo Zero), and faces pick an agent. It opens on the agent that captured a page most recently. Only one of the two is open at a time. In the Radial layout, opening the agent browser or picking a team in it turns the chart around Boo Zero to bring that team beside it. Picking an agent steps it forward while its teammates make room. Picking another team, or closing the browser, settles the team back. The turn is saved with the layout; the focus is not. ### Move around the canvas The controls at the bottom right zoom out, zoom in, **Fit to view**, lock the canvas, and show the minimap, which is hidden at first. **Lock canvas** freezes positions, hides the ports and stops drops until you unlock it. | Key | What it does | | - | - | | **Tab** | Move between Boos | | **Enter** or **Space** | Open or fold the focused Boo | | Arrow keys | Move the selected Boo | | Menu key, **Shift+F10** or **Alt+Enter** | Open the right-click menu for the focused Boo | | **Backspace** or **Delete** | Remove the selected line | Drawing a route and dragging a tile need a pointer. ## Reduced motion When your system's reduce motion setting is on, the graph skips its animations. Tiles appear at once when you open a Boo, and Boos land straight on their final positions. On the Org chart, turns and focus happen without moving through the motion, and the docks open without sliding. The dots in a thought bubble hold still. ## What is not on the canvas Creating a team, adding your own MCP server, entering a key, choosing a folder, and editing a personality each need a form. They live in the [Marketplace](https://docs.claw.boo/using/marketplace.md), [Connectors](https://docs.claw.boo/using/connectors.md), and the agent's page. An agent's runtime cannot be changed after the agent is created. ## Troubleshooting > [accordion] Boos pile up or the layout looks broken > > Saved positions from an earlier arrangement can cover only part of the current graph. Click **Re-layout** to drop them and lay the graph out again. > [accordion] A Boo shows no port, or a thread will not land > > The canvas is probably locked: unlock it with the padlock at the bottom right. If the thread lands but a **Failed to save routing** message appears, the agent's file could not be written. For an OpenClaw agent, check that Clawboo is connected to its OpenClaw Gateway. > [accordion] Remove Connection on a route does nothing > > Removing a route needs the dashboard connected to an OpenClaw Gateway. Without one, delete the route line from the agent's AGENTS.md on its page instead. See [Take things back](#take-things-back). > [accordion] A route I drew does not change who gets the work > > Only OpenClaw agents read routes. Agents on other runtimes can hand work to any member of their chat, whatever the graph shows. See [What a route does](#what-a-route-does). > [accordion] The Org chart says No agents yet > > There are no agents to draw. Deploy a team from the [Marketplace](https://docs.claw.boo/using/marketplace.md), or click **Create Boo** in the sidebar. > [accordion] Under the hood > > * Drawing a route appends `- Route to @ for delegated tasks.` to the first agent's AGENTS.md and, best-effort, turns on agent-to-agent messaging in the OpenClaw Gateway's config. > * Positions are saved on the server through `/api/graph-layout`, per graph: one set per Org chart layout, one per team graph, and one per room graph. The layout choice is kept in the browser under `clawboo.atlas.layout`. > * Installing a skill goes through `POST /api/capabilities/install`. Sharing a connector creates a grant for that agent; see [Capabilities](https://docs.claw.boo/using/capabilities.md). ## Next steps * [Team chat](https://docs.claw.boo/using/team-chat.md): give the team work and watch its graph card light up. * [Agents](https://docs.claw.boo/using/agents.md): open an agent's page to edit its files and personality. * [Connectors](https://docs.claw.boo/using/connectors.md): connect the apps and tools you then attach on the graph. * [Capabilities](https://docs.claw.boo/using/capabilities.md): see every skill, tool and connector across your agents. * [Observability](https://docs.claw.boo/using/observability.md): the live activity behind the Activity dock and the thought bubbles. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.