RingClaw

English

简体中文

English

简体中文

Appearance

Docker ​

All RingClaw configuration lives in ~/.ringclaw/config.json — mount the directory into the container and the file is shared with the host. The previously supported -e RC_* / -e OPENCLAW_GATEWAY_* environment variables are no longer honored.

Build ​

bash
docker build -t ringclaw .

Prepare Config ​

On the host, run ringclaw setup (or edit manually) so that ~/.ringclaw/config.json exists. See Configuration for the full schema.

Run ​

bash
docker run -d --name ringclaw \
  -v ~/.ringclaw:/root/.ringclaw \
  ringclaw

The container reads /root/.ringclaw/config.json on startup.

View Logs ​

bash
docker logs -f ringclaw

Quick Start with GHCR ​

bash
docker run -it -v ~/.ringclaw:/root/.ringclaw \
  ghcr.io/ringclaw/ringclaw start

Agent Binaries

ACP and CLI agents require the agent binary inside the container. The Docker image ships only RingClaw itself. For ACP/CLI agents, mount the binary or build a custom image. HTTP agents work out of the box.