Skip to main content

NanoClaw Setup and First Run

1. What installation actually gives you​

The upstream quick start is:

git clone https://github.com/nanocoai/nanoclaw.git nanoclaw-v2
cd nanoclaw-v2
bash nanoclaw.sh

The README says nanoclaw.sh installs missing prerequisites, registers credentials through OneCLI, builds the agent container, and helps pair the first channel.

2. Why the installer is opinionated​

NanoClaw is designed to get you from a fresh machine to:

  • one named agent,
  • one containerized runtime,
  • one working provider path,
  • and one first channel or local CLI surface.

That is more ambitious than a normal package install, but it fits the project well.

3. What a successful first run looks like​

A good first run should prove:

  1. Docker works,
  2. the host process and container can talk,
  3. the credential path is healthy,
  4. one agent is reachable through one surface.

Start with the local CLI or one low-risk messaging channel. Add more channels only after you understand the isolation model and per-agent boundaries.

5. Why not to over-customize first​

NanoClaw encourages customization through code, but that is best done after the stock host-container flow works cleanly.