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

# Agents

> Connect OpenClaw, Hermes, and VPS CLI agents to ByteRover V4 with the published skill, authentication, and onboarding prompt.

ByteRover V4 connects agents through the published ByteRover skill. Install the skill in the same environment where the agent runs, restart the agent, authenticate ByteRover, then start onboarding from inside your project.

<img src="https://mintcdn.com/demo-a750c123/LcC02bNs7AlzliOm/v4/assets/byterover_x_openclaw.avif?fit=max&auto=format&n=LcC02bNs7AlzliOm&q=85&s=ca5566bb4a61d957c7e4551adea5cdf9" alt="ByteRover and OpenClaw agent integration" width="760" data-path="v4/assets/byterover_x_openclaw.avif" />

## Setup flow

<Steps>
  <Step title="Optional step 0: Remove old V3 CLI, connectors, and integrations">
    If this environment still has the old V3 CLI, connectors, OpenClaw integration, or Hermes memory provider installed, remove them before setting up the V4 skill:

    ```bash theme={null}
    curl -fsSL https://www.byterover.dev/uninstall-v3.sh | sh
    ```

    This removes old V3 command-line tools and connectors. It also removes the old OpenClaw integration and Hermes memory provider when they are detected. It does not migrate V3 memory data.
  </Step>

  <Step title="Install the ByteRover skill">
    Requires Node.js 20 or newer. Node.js includes npm and npx.

    ```bash theme={null}
    npx skills add campfirein/skills
    ```

    This installs the published ByteRover skill bundle from `campfirein/skills`.
  </Step>

  <Step title="Restart the agent">
    Fully quit and reopen the agent so it can load the installed ByteRover skill.
  </Step>

  <Step title="Authenticate with ByteRover">
    ```text theme={null}
    Authenticate with ByteRover.
    ```

    Open the URL the agent prints, approve the request in your browser, then return to the agent and type `approved`.
  </Step>

  <Step title="Start ByteRover onboarding">
    ```text theme={null}
    onboard with ByteRover
    ```

    The agent links the project to the right space and begins using durable memory after onboarding.
  </Step>
</Steps>

## Supported agents

Choose the agent you want to connect.

<CardGroup cols={2}>
  <Card title="OpenClaw" icon="bot" href="/v4/agents/openclaw">
    Install the skill, restart OpenClaw, authenticate, and start onboarding.
  </Card>

  <Card title="Hermes" icon="bot" href="/v4/agents/hermes">
    Install the skill, restart Hermes, authenticate, and start onboarding.
  </Card>

  <Card title="Codex CLI" icon="terminal" href="/v4/agents/codex-cli">
    Use ByteRover from Codex CLI on a VPS or remote development machine.
  </Card>

  <Card title="Claude Code" icon="terminal" href="/v4/agents/claude-code">
    Use ByteRover from Claude Code in a terminal session.
  </Card>

  <Card title="OpenCode CLI" icon="terminal" href="/v4/agents/opencode-cli">
    Use ByteRover from OpenCode CLI on a VPS or local terminal.
  </Card>

  <Card title="V3 to V4 VPS migration" icon="server" href="/v4/agents/migrate-v3-to-v4">
    Move self-managed V3 project memory on a VPS into V4 spaces.
  </Card>
</CardGroup>

## VPS notes

When the agent runs on a VPS, install the ByteRover skill on the VPS, not only on your laptop. The agent reads skills from its own environment.

Authenticate before onboarding. If the agent prints a sign-in URL, open that URL in your browser. After you approve it, return to the VPS terminal and type:

```text theme={null}
approved
```

If the agent cannot find a space for the project, open ByteRover Desktop, create or select the right space, then prompt the agent again:

```text theme={null}
onboard with ByteRover
```

If the VPS already has V3 project memory, migrate it before relying on the project in V4:

<Card title="Migrate V3 VPS data to V4" icon="server" href="/v4/agents/migrate-v3-to-v4">
  Detect V3 projects, preview the migration, create V4 spaces, verify the result, then back up and remove old V3 files.
</Card>