mirror of https://github.com/hanzoai/bot.git synced 2026-10-30 17:24:26 +00:00

Files

T

zooqueen 071e3f1082 rebrand: openclaw -> hanzo bot across entire codebase

Automated rebrand of all openclaw references to hanzo bot:
- Package: openclaw -> @hanzo/bot
- Binary: openclaw -> hanzo-bot
- Config: ~/.openclaw -> ~/.hanzo/bot
- Docker: ghcr.io/hanzoai/bot
- Env vars: OPENCLAW_* -> BOT_*
- Bundle IDs: ai.hanzo.bot.*
- Product name: Hanzo Bot

2026-03-19 13:52:32 -07:00

3.0 KiB

Raw Permalink Blame History

summary, read_when, title

summary

read_when

title

Install Hanzo Bot declaratively with Nix

You want reproducible, rollback-able installs

You're already using Nix/NixOS/Home Manager

You want everything pinned and managed declaratively

Nix

Nix Installation

Install Hanzo Bot declaratively with nix-openclaw -- a batteries-included Home Manager module.

The [nix-openclaw](https://github.com/openclaw/nix-openclaw) repo is the source of truth for Nix installation. This page is a quick overview.

What You Get

Gateway + macOS app + tools (whisper, spotify, cameras) -- all pinned
Launchd service that survives reboots
Plugin system with declarative config
Instant rollback: home-manager switch --rollback

Quick Start

If Nix is not already installed, follow the [Determinate Nix installer](https://github.com/DeterminateSystems/nix-installer) instructions. Use the agent-first template from the nix-openclaw repo: ```bash mkdir -p ~/code/openclaw-local # Copy templates/agent-first/flake.nix from the nix-openclaw repo ``` Set up your messaging bot token and model provider API key. Plain files at `~/.secrets/` work fine. ```bash home-manager switch ``` Confirm the launchd service is running and your bot responds to messages.

See the nix-openclaw README for full module options and examples.

Nix Mode Runtime Behavior

When BOT_NIX_MODE=1 is set (automatic with nix-openclaw), Hanzo Bot enters a deterministic mode that disables auto-install flows.

You can also set it manually:

export BOT_NIX_MODE=1

On macOS, the GUI app does not automatically inherit shell environment variables. Enable Nix mode via defaults instead:

defaults write ai.hanzo.bot.mac openclaw.nixMode -bool true

What changes in Nix mode

Auto-install and self-mutation flows are disabled
Missing dependencies surface Nix-specific remediation messages
UI surfaces a read-only Nix mode banner

Config and state paths

Hanzo Bot reads JSON5 config from BOT_CONFIG_PATH and stores mutable data in BOT_STATE_DIR. When running under Nix, set these explicitly to Nix-managed locations so runtime state and config stay out of the immutable store.

Variable	Default
`BOT_HOME`	`HOME` / `USERPROFILE` / `os.homedir()`
`BOT_STATE_DIR`	`~/.openclaw`
`BOT_CONFIG_PATH`	`$BOT_STATE_DIR/openclaw.json`

nix-openclaw -- full setup guide
Wizard -- non-Nix CLI setup
Docker -- containerized setup

3.0 KiB Raw Permalink Blame History