> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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 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, then start ByteRover onboarding from inside your project.

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

## Setup flow

<Steps>
  <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="Start ByteRover onboarding">
    ```text theme={null}
    onboard with byterover
    ```

    The agent will guide ByteRover setup and begin using durable memory after onboarding.
  </Step>
</Steps>

<Note>
  If the agent asks you to sign in, open the URL it prints, approve the request in your browser, then return to the agent and type `approved`.
</Note>

## 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, and start onboarding.
  </Card>

  <Card title="Hermes" icon="bot" href="/v4/agents/hermes">
    Install the skill, restart Hermes, 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>
</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.

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
```