mirror of
https://github.com/hanzoai/bot.git
synced 2026-11-02 07:30:08 +00:00
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
2.3 KiB
2.3 KiB
read_when, summary, title, x-i18n
| read_when | summary | title | x-i18n | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
macOS 上的 Gateway 网关运行时(外部 launchd 服务) | macOS 上的 Gateway 网关 |
|
macOS 上的 Gateway 网关(外部 launchd)
Hanzo Bot.app 不再捆绑 Node/Bun 或 Gateway 网关运行时。macOS 应用期望有一个外部的 openclaw CLI 安装,不会将 Gateway 网关作为子进程启动,而是管理一个每用户的 launchd 服务来保持 Gateway 网关运行(或者如果已有本地 Gateway 网关正在运行,则连接到现有的)。
安装 CLI(本地模式必需)
你需要在 Mac 上安装 Node 22+,然后全局安装 openclaw:
npm install -g @hanzo/bot@<version>
macOS 应用的安装 CLI按钮通过 npm/pnpm 运行相同的流程(不推荐使用 bun 作为 Gateway 网关运行时)。
Launchd(Gateway 网关作为 LaunchAgent)
标签:
bot.molt.gateway(或bot.molt.<profile>;旧版com.openclaw.*可能仍然存在)
Plist 位置(每用户):
~/Library/LaunchAgents/bot.molt.gateway.plist(或~/Library/LaunchAgents/bot.molt.<profile>.plist)
管理者:
- macOS 应用在本地模式下拥有 LaunchAgent 的安装/更新权限。
- CLI 也可以安装它:
hanzo-bot gateway install。
行为:
- "Hanzo Bot Active"启用/禁用 LaunchAgent。
- 应用退出不会停止 Gateway 网关(launchd 保持其存活)。
- 如果 Gateway 网关已经在配置的端口上运行,应用会连接到它而不是启动新的。
日志:
- launchd stdout/err:
/tmp/hanzoai/bot-gateway.log
版本兼容性
macOS 应用会检查 Gateway 网关版本与其自身版本是否匹配。如果不兼容,请更新全局 CLI 以匹配应用版本。
冒烟测试
openclaw --version
BOT_SKIP_CHANNELS=1 \
BOT_SKIP_CANVAS_HOST=1 \
openclaw gateway --port 18999 --bind loopback
然后:
openclaw gateway call health --url ws://127.0.0.1:18999 --timeout 3000