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.

​
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 22.5 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, adds the supported Clawdi MCP entry, installs the bundled Clawdi Skill, and starts background sync by default.
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. Start a new Agent Session and ask what Clawdi tools are available, or add a Memory from the CLI with clawdi memory add "I prefer concise status updates".

​
Next steps

Connect another local Agent

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

Learn the core concepts

Understand the canonical objects that stay consistent across Agent workflows.

Use shared capabilities

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 August 2, 2026