Files
bot/docs/start/onboarding-overview.md
zeekay 08582cc303 Rebrand OpenClaw → Hanzo Bot across entire codebase
Complete rename of all OpenClaw/OPENCLAW/openclaw references to
Hanzo Bot/BOT/bot naming convention:

- Env vars: OPENCLAW_* → BOT_* (18 patterns)
- Config: ~/.openclaw/ → ~/.bot/, openclaw.json → bot.json
- Packages: @openclaw/* → @hanzo/bot-*
- Domains: openclaw.ai → hanzo.bot
- Mobile: OpenClawKit → BotKit, bundle IDs ai.openclaw → ai.hanzo.bot
- mDNS: _openclaw-gw._tcp → _bot-gw._tcp
- Docker: CMD hanzo-bot.mjs, BOT_PREFER_PNPM, BOT_DOCKER_APT_PACKAGES
- CI: docker-release.yml adds :latest tag on main branch
2026-02-11 11:13:08 -08:00

1.4 KiB

summary, read_when, title, sidebarTitle
summary read_when title sidebarTitle
Overview of Hanzo Bot onboarding options and flows
Choosing an onboarding path
Setting up a new environment
Onboarding Overview Onboarding Overview

Onboarding Overview

Hanzo Bot supports multiple onboarding paths depending on where the Gateway runs and how you prefer to configure providers.

Choose your onboarding path

  • CLI wizard for macOS, Linux, and Windows (via WSL2).
  • macOS app for a guided first run on Apple silicon or Intel Macs.

CLI onboarding wizard

Run the wizard in a terminal:

hanzo-bot onboard

Use the CLI wizard when you want full control of the Gateway, workspace, channels, and skills. Docs:

macOS app onboarding

Use the Hanzo Bot app when you want a fully guided setup on macOS. Docs:

Custom Provider

If you need an endpoint that is not listed, including hosted providers that expose standard OpenAI or Anthropic APIs, choose Custom Provider in the CLI wizard. You will be asked to:

  • Pick OpenAI-compatible, Anthropic-compatible, or Unknown (auto-detect).
  • Enter a base URL and API key (if required by the provider).
  • Provide a model ID and optional alias.
  • Choose an Endpoint ID so multiple custom endpoints can coexist.

For detailed steps, follow the CLI onboarding docs above.