Files
bot/docs/zh-CN/platforms/linux.md
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

2.3 KiB
Raw Permalink Blame History

read_when, summary, title, x-i18n
read_when summary title x-i18n
查找 Linux 配套应用状态
规划平台覆盖范围或贡献
Linux 支持 + 配套应用状态 Linux 应用
generated_at model provider source_hash source_path workflow
2026-03-16T06:24:30Z gpt-5.4 openai 12f2a28ec8fc17769210bda97af11fda332355956d41bba69ac51cc523be6178 platforms/linux.md 15

Linux 应用

Gateway 网关在 Linux 上得到完全支持。Node 是推荐的运行时。 不建议将 Bun 用于 Gateway 网关(存在 WhatsApp/Telegram bug)。

原生 Linux 配套应用已在规划中。如果你想帮助构建一个,欢迎贡献。

面向初学者的快速路径(VPS)

  1. 安装 Node 24(推荐;Node 22 LTS,目前 22.16+,为了兼容性仍然可用)
  2. npm i -g @hanzo/bot@latest
  3. hanzo-bot onboard --install-daemon
  4. 在你的笔记本电脑上运行:ssh -N -L 18789:127.0.0.1:18789 <user>@<host>
  5. 打开 http://127.0.0.1:18789/ 并粘贴你的令牌

分步 VPS 指南:exe.dev

安装

Gateway 网关

Gateway 网关服务安装(CLI)

使用以下任一方式:

openclaw onboard --install-daemon

或者:

openclaw gateway install

或者:

openclaw configure

出现提示时,选择 Gateway 服务。

修复/迁移:

openclaw doctor

系统控制(systemd 用户单元)

Hanzo Bot 默认安装 systemd 用户服务。对于共享或始终在线的服务器,请使用 系统 服务。完整的单元示例和指导 请参见 Gateway 网关运行手册。

最小设置:

创建 ~/.config/systemd/user/openclaw-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/openclaw gateway --port 18789
Restart=always
RestartSec=5

[Install]
WantedBy=default.target

启用它:

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