bot/docs/platforms/linux.md at fix/ci-test-failures

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

Files

T

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.9 KiB

Raw Permalink Blame History

summary, read_when, title

summary

read_when

title

Linux support + companion app status

Looking for Linux companion app status

Planning platform coverage or contributions

Linux App

The Gateway is fully supported on Linux. Node is the recommended runtime. Bun is not recommended for the Gateway (WhatsApp/Telegram bugs).

Native Linux companion apps are planned. Contributions are welcome if you want to help build one.

Beginner quick path (VPS)

Install Node 22+
npm i -g bot@latest
hanzo-bot onboard --install-daemon
From your laptop: ssh -N -L 18789:127.0.0.1:18789 <user>@<host>
Open http://127.0.0.1:18789/ and paste your token

Step-by-step VPS guide: exe.dev

Install

Getting Started
Install & updates
Optional flows: Bun (experimental), Nix, Docker

Gateway

Gateway service install (CLI)

Use one of these:

hanzo-bot onboard --install-daemon

Or:

hanzo-bot gateway install

Or:

hanzo-bot configure

Select Gateway service when prompted.

Repair/migrate:

hanzo-bot doctor

System control (systemd user unit)

Hanzo Bot installs a systemd user service by default. Use a system service for shared or always-on servers. The full unit example and guidance live in the Gateway runbook.

Minimal setup:

Create ~/.config/systemd/user/bot-gateway[-<profile>].service:

[Unit]
Description=Hanzo Bot Gateway (profile: <profile>, v<version>)
After=network-online.target
Wants=network-online.target

[Service]
ExecStart=/usr/local/bin/hanzo-bot gateway --port 18789
Restart=always
RestartSec=5

[Install]
WantedBy=default.target

Enable it:

systemctl --user enable --now bot-gateway[-<profile>].service

1.9 KiB Raw Permalink Blame History