Skip to main content
This is the Connected Agent quickstart. Use it when Agent software already runs on your computer and needs access to that computer or its local tools.
Most new users should start with the Cloud Agent quickstart, which does not require a local installation.
For a guided dashboard entry, open Ask your agent and copy its setup prompt into your local Agent. Complete authorization yourself and verify the result. The manual steps below give you control over each stage.

​
Before you begin

  • Review System requirements. On macOS or Linux, the native installer does not require Node.js. On Windows, or for an npm-managed installation, install Node.js 24 or newer.
  • Install at least one supported Agent software option if you want clawdi setup to detect it automatically.

​
Steps

1

Install the Clawdi CLI

The native installer selects a release for your operating system and CPU architecture. It installs to ~/.local by default.
Confirm the command is available:
2

Sign in

Clawdi opens a browser for sign-in. On SSH or a headless machine, use clawdi auth login --no-open instead. See Authentication for the callback and local credential safeguards.
3

Connect the Agent

Select the detected Agent software you want to connect. Setup registers an Agent and starts background sync by default. It also adds the Clawdi MCP entry and bundled Skill where supported. Pi and OpenCode sync Sessions only; see the support table.
4

Check the setup

A healthy setup reports successful checks for authentication, API reachability, registered Agents, Vault metadata, and Clawdi MCP. Agent software not installed on this computer can appear as unavailable without preventing an installed Agent from working.
Your Connected Agent is ready. Open Sessions in the dashboard to check its synced history. For integrations with MCP setup, start a new Agent Session and ask what Clawdi tools are available.

​
Next steps

Connect another local Agent

Select a specific Agent software option and verify its local integration.

Learn the core concepts

Understand the objects that stay consistent across Agent workflows.

Browse guides

Follow task guides for Projects, Memories, Sessions, Skills, Vaults, Connectors, Channels, and AI Providers.

Keep the CLI current

Check for a release and update through the same installation owner.
Last modified on September 10, 2026