> ## 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. # Quickstart > Start Clawboo, connect an AI provider with an API key, a ChatGPT sign-in or Ollama, deploy a ready-made team and give it its first job. In this quickstart you start Clawboo, connect one AI provider, deploy a ready-made team and give it its first job. After the first command, everything happens in your browser. ## Before you begin * **Node.js 22.12 or newer.** Run `node --version` to check. [Install](https://docs.claw.boo/getting-started/installation.md) covers Node and the other ways to run Clawboo. * **One way to reach an AI model:** * an API key from OpenAI, Anthropic, OpenRouter, Google, xAI, Groq, Mistral, Together, Cerebras or Moonshot, * a ChatGPT subscription, or * [Ollama](https://ollama.com) running on this computer with a chat model pulled. * **No Clawboo account.** Clawboo is free; the provider you connect bills the model usage. ## Steps **1. Start Clawboo** Run this in a terminal: ```bash theme={"theme":{"light":"github-dark","dark":"github-dark"}} npx clawboo@latest ``` Clawboo starts a local server and opens your browser. Prefer a lasting `clawboo` command? Install it globally instead; see [Install](https://docs.claw.boo/getting-started/installation.md). **You should see** the welcome screen, "Your AI agents, visible.", with a **Get Started** button. Click it. **2. Connect your AI provider** The **Connect your AI provider** screen sets up the AI your team runs on. Pick one path: > [tab] API key > > 1. Click **OpenAI**, **Anthropic** or **OpenRouter**, or open **More providers** for Google, xAI, Groq, Mistral, Together, Cerebras or Moonshot. For OpenAI, also click the **API key** card: the screen starts on **Sign in with ChatGPT**. > 2. Paste your key into **API Key**. No key yet? **Get a key** opens the provider's key page. > 3. Optional: choose the **Model** for your team's lead. Teammates you add default to a faster, cheaper model. > 4. Click **Continue**. Clawboo checks the key with the provider (**Verifying…**), then saves it in its encrypted vault on your computer (**Connecting…**). > > ![The Connect your AI provider screen with OpenRouter selected: the provider cards, the API key field and the model picker for the team's lead](https://mintcdn.com/privatedocs/6H-VHke03QIa-oHL/images/onboarding-connect-provider.png?fit=max\&auto=format\&n=6H-VHke03QIa-oHL\&q=85\&s=ed89bb116c838cbd989115481e9227d7) > [tab] Sign in with ChatGPT > > 1. Keep **OpenAI** and **Sign in with ChatGPT** selected. Both are selected when the screen opens. > 2. If the panel asks you to install the Codex CLI first, click **Install Codex**. > 3. Click **Sign in with ChatGPT** and finish signing in on the page that opens in your browser. Already signed in to Codex? Click **Already signed in? Re-check**. > 4. When the panel says your team will run on your ChatGPT subscription, click **Continue**. > > Your team runs on Codex, with no API key. This path has no model picker. > [tab] Ollama > > 1. Make sure Ollama is running and has a chat model. If it has none, run `ollama pull llama3.2`. > 2. Click **Ollama**. > 3. Choose a **Model** from the ones your Ollama has pulled. It runs every agent on the team, the lead and the specialists alike. Skip models marked "(can't use tools)": agents use tools on most turns. > 4. Click **Continue**. > > No key is needed, and the model runs on your computer. **You should see** the **Add more runtimes** screen. If a check fails, the reason appears on the screen instead; see [If something goes wrong](#if-something-goes-wrong). **3. Skip the extra runtimes** **Add more runtimes** lists Codex, Claude Code, Hermes and OpenClaw. Connecting them is optional, and you can do it later from **Settings → Runtimes**. Click **Continue**. If you want them later: Claude Code also needs the Claude Agent SDK installed with Clawboo (see [Install](https://docs.claw.boo/getting-started/installation.md)), and **Set up OpenClaw** installs and starts a local OpenClaw Gateway for you (see [OpenClaw](https://docs.claw.boo/runtimes/openclaw.md)). **You should see** **Choose your first team**. **4. Deploy a team** The **Create a team** window opens by itself. If you close it, **Browse teams** brings it back. 1. Find a team that fits your work, such as a marketing or research team, and click **Deploy** on its card. **Details** shows who is on it first. 2. In **Customize team**, change the name, badge or colors if you like. Every teammate runs on what you connected in step 2 unless you pick another runtime or model for it here. 3. Click **Deploy team**. **You should see** a progress count while each agent is created, then **Team deployed!**, then **Your team is ready** with your agents and a "Led by" badge naming Boo Zero, the leader that coordinates the team. On the ChatGPT path, one of the team's own agents takes the Boo Zero role. **5. Introduce yourself** Click **Open my dashboard**. Your team's chat, **General**, opens on a one-time introduction screen. Write a line about who you are and what you're working on (at least 5 characters), then click **Continue to Team Space**. Clawboo saves it to the team's context. **You should see** the team chat, with your introduction and a short acknowledgement from Boo Zero. The first time, a tour may offer to show you around; **Skip tour** closes it. **6. Give your team its first job** Paste this into the message box at the bottom, or write your own request, and press Enter: ```text theme={"theme":{"light":"github-dark","dark":"github-dark"}} Plan a launch for our new budgeting app: write a short announcement, draft three social posts, and list five questions customers will ask first. ``` **You should see** task cards appear in the chat as Boo Zero hands the parts to teammates. Each card moves from **Queued** to **Working** to **Done**, and the **Tasks** card beside the chat lists the same tasks. When the teammates finish, Boo Zero posts one summary of what the team produced. A quick question gets a direct answer instead of tasks. If Boo Zero answers a request with several parts by itself, ask it to hand the parts to the team. ## What you should see Your team's chat on the left, with the **Team graph** and **Tasks** cards on the right. Task cards in the chat show who is working on what, and each one opens on the [Board](https://docs.claw.boo/using/board.md). ![A team chat in Clawboo: teammates' updates and two task cards marked Working on the left, and on the right the Team graph card, with Boo Zero above the team lead and four specialists, and the Tasks card, with one task that needs you and five in progress](https://mintcdn.com/privatedocs/6H-VHke03QIa-oHL/images/team-space.png?fit=max\&auto=format\&n=6H-VHke03QIa-oHL\&q=85\&s=c6bed9e50135bba92df482a1ddf6cd8d) Every message uses your provider's tokens, and a team's hand-offs add model runs of their own. [Budgets and spend](https://docs.claw.boo/using/budgets-and-spend.md) shows how to watch spend and set a limit. ## If something goes wrong > [accordion] Invalid API key. > > The provider rejected the key. Copy it again from the provider's key page, check that you picked the matching provider, and click **Continue** again. > [accordion] Could not reach the provider > > The message reads like "Could not reach openai." This computer could not reach the provider within 8 seconds, often because of a proxy, a firewall or no network. Fix the connection and try again. If you are sure the key is right, **Continue anyway** saves it without the check. > [accordion] Ollama isn't answering. > > Start Ollama (open the Ollama app, or run `ollama serve`), then click **Continue** again. Don't have Ollama? The screen links to its download. > [accordion] Ollama is running, but has no chat model yet. > > Run `ollama pull llama3.2`, then click **Check again**. Embedding-only models can't run agents. If the screen says Ollama doesn't have the model you picked, run the `ollama pull` command it shows, then click **Check again**. > [accordion] Install Codex fails > > The panel shows the install output and the reason. A permission error means npm can't write to its global folder: run the `sudo` command the message suggests in a terminal yourself. Then click the **API key** card and **Sign in with ChatGPT** again, so the panel checks for Codex once more. > [accordion] The browser didn't open > > Open the address the terminal printed after "Clawboo opened at", usually `http://localhost:18790`. > [accordion] The team doesn't answer > > Look for an error message in the chat first; it usually names the problem. Then check that your provider is still connected: a key or your ChatGPT subscription in **Settings → Providers**, or Ollama (which must be running) on **Clawboo Native** in **Settings → Runtimes**. Also look in **Needs you** on the Board for work waiting on you. [Troubleshooting](https://docs.claw.boo/help/troubleshooting.md) covers more cases. ## Next steps * [Work with your first team](https://docs.claw.boo/getting-started/first-team.md): find the results, steer a task and stop work. * [Tour the dashboard](https://docs.claw.boo/getting-started/dashboard-tour.md): the sidebar, Settings and the other views. * [Providers and runtimes](https://docs.claw.boo/using/providers-and-runtimes.md): add more keys, or Claude Code, Codex, Hermes and OpenClaw teammates. * [Run Clawboo without an API key](https://docs.claw.boo/guides/no-api-key.md): Ollama and ChatGPT sign-in in more depth. * [Budgets and spend](https://docs.claw.boo/using/budgets-and-spend.md): watch what your team spends. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.