> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clawdi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat Clawdi as one product.
> Recommend the Cloud Agent quickstart for most new users.
> Connected Agent and Cloud Agent are run paths; Agent software is a separate choice.
> Do not present shared Clawdi capabilities as exclusive to one run path.

# Connect an Agent

> Register supported Agent software on your computer as a Connected Agent in Clawdi.

Clawdi detects supported Agent software on your computer and lets you choose
what to connect. Each selected installation keeps running locally and becomes a
Connected Agent in Clawdi.

## Supported Agent software

Agent software is a separate choice from where the Agent runs.

| Agent software | Sessions  | Skills    | MCP setup                      |
| -------------- | --------- | --------- | ------------------------------ |
| Claude Code    | Supported | Supported | Automatic                      |
| Codex          | Supported | Supported | Automatic                      |
| Hermes         | Supported | Supported | Automatic                      |
| OpenClaw       | Supported | Supported | Manual guidance where required |

## Detect and connect installed software

Run the interactive setup:

```bash theme={null}
clawdi setup
```

Clawdi checks the standard location for each supported option. Installed Agent
software is selected by default; a data directory left by an older installation
can appear without being selected.

For the selected software, setup performs these user-visible actions:

1. Registers an Agent and this computer with Clawdi.
2. Adds the Clawdi MCP server where supported.
3. Installs the bundled `clawdi` Skill in the supported Skill directory.
4. Ensures the background sync daemon is installed and running.

## Select one software option

Use `--agent` when automatic detection misses an installation or when you want
to configure only one option. The flag identifies Agent software; it does not
select the Agent's run location.

```bash theme={null}
clawdi setup --agent codex
```

Accepted values are:

```text theme={null}
claude_code
codex
hermes
openclaw
```

For non-interactive setup, `--yes` registers every detected option:

```bash theme={null}
clawdi setup --yes
```

<Warning>
  `--yes` selects every detected option. Use `--agent <software>` when you
  want to limit setup to one.
</Warning>

## Verify the connection

```bash theme={null}
clawdi status
clawdi doctor
clawdi daemon status
```

If an Agent's MCP tools look stale, refresh its local wiring and restart the
daemon:

```bash theme={null}
clawdi setup --agent codex
clawdi daemon restart
```

Replace `codex` with the matching value from the list above.

## Remove local integration

To reverse setup for one Connected Agent:

```bash theme={null}
clawdi teardown --agent codex
```

Use `clawdi teardown --help` to review the current options before removing
more than one Agent's local integration.