Files
bot/docs/zh-CN/start/quickstart.md
zeekay 492633d62a fix: remaining branding cleanup — ~/.bot paths, discord links, lobster in tests
- ~/.bot → ~/.hanzo/bot in all docs (en + zh-CN) and help.ts
- discord.gg/hanzo → discord.gg/XthHQQj in GitHub templates/workflows
- lobster → flow in test fixtures
- @bot/ → @hanzo/bot- in discovery.ts comment
2026-02-13 13:28:43 -08:00

1.9 KiB

read_when, summary, title, x-i18n
read_when summary title x-i18n
你希望以最快的方式从安装到运行一个可用的 Gateway 网关
安装 Hanzo Bot,完成 Gateway 网关新手引导,并配对你的第一个渠道。 快速开始
generated_at model provider source_hash source_path workflow
2026-02-04T17:53:21Z claude-opus-4-5 pi 3c5da65996f89913cd115279ae21dcab794eadd14595951b676d8f7864fbbe2d start/quickstart.md 15
Hanzo Bot 需要 Node 22 或更新版本。

安装

```bash npm install -g bot@latest ``` ```bash pnpm add -g bot@latest ```

新手引导并运行 Gateway 网关

```bash hanzo-bot onboard --install-daemon ``` ```bash hanzo-bot channels login ``` ```bash hanzo-bot gateway --port 18789 ```

完成新手引导后,Gateway 网关将通过用户服务运行。你也可以使用 hanzo-bot gateway 手动启动。

之后在 npm 安装和 git 安装之间切换非常简单。安装另一种方式后,运行 `hanzo-bot doctor` 即可更新 Gateway 网关服务入口点。

从源码安装(开发)

git clone https://github.com/hanzoai/bot.git
cd bot
pnpm install
pnpm ui:build # 首次运行时会自动安装 UI 依赖
pnpm build
hanzo-bot onboard --install-daemon

如果你还没有全局安装,可以在仓库目录中通过 pnpm hanzo-bot ... 运行新手引导。

多实例快速开始(可选)

BOT_CONFIG_PATH=~/.hanzo/bot/a.json \
BOT_STATE_DIR=~/.hanzo/bot-a \
hanzo-bot gateway --port 19001

发送测试消息

需要一个正在运行的 Gateway 网关。

hanzo-bot message send --target +15555550123 --message "Hello from Hanzo Bot"