diff --git a/docs/zh-CN/install/hostinger.md b/docs/zh-CN/install/hostinger.md new file mode 100644 index 000000000..28374a12d --- /dev/null +++ b/docs/zh-CN/install/hostinger.md @@ -0,0 +1,101 @@ +--- +read_when: + - 在 Hostinger 上设置 OpenClaw + - 正在寻找适用于 OpenClaw 的托管 VPS + - 使用 Hostinger 一键安装 OpenClaw +summary: 在 Hostinger 上托管 OpenClaw +title: Hostinger +x-i18n: + generated_at: "2026-04-13T13:14:20Z" + model: gpt-5.4 + provider: openai + source_hash: cf173cdcf6344f8ee22e839a27f4e063a3a102186f9acc07c4a33d4794e2c034 + source_path: install/hostinger.md + workflow: 15 +--- + +# Hostinger + +通过 **一键安装** 托管部署或 **VPS** 安装，在 [Hostinger](https://www.hostinger.com/openclaw) 上运行持久化的 OpenClaw Gateway 网关。 + +## 前提条件 + +- Hostinger 账户（[注册](https://www.hostinger.com/openclaw)） +- 大约 5-10 分钟 + +## 选项 A：一键安装 OpenClaw + +最快的入门方式。Hostinger 会处理基础设施、Docker 和自动更新。 + + + + 1. 在 [Hostinger OpenClaw 页面](https://www.hostinger.com/openclaw) 上，选择一个托管 OpenClaw 套餐并完成结账。 + + + 在结账过程中，你可以选择 **Ready-to-Use AI** 积分，这些积分已预先购买，并会立即在 OpenClaw 内集成——无需其他提供商的外部账户或 API 密钥。你可以立刻开始聊天。或者，你也可以在设置过程中提供你自己的 Anthropic、OpenAI、Google Gemini 或 xAI 密钥。 + + + + + + 选择一个或多个要连接的渠道： + + - **WhatsApp** —— 扫描设置向导中显示的二维码。 + - **Telegram** —— 粘贴来自 [BotFather](https://t.me/BotFather) 的机器人令牌。 + + + + + 点击 **Finish** 以部署实例。准备就绪后，可从 hPanel 中的 **OpenClaw Overview** 访问 OpenClaw 仪表板。 + + + + +## 选项 B：在 VPS 上运行 OpenClaw + +对你的服务器拥有更多控制权。Hostinger 会通过 Docker 在你的 VPS 上部署 OpenClaw，而你可通过 hPanel 中的 **Docker Manager** 进行管理。 + + + + 1. 在 [Hostinger OpenClaw 页面](https://www.hostinger.com/openclaw) 上，选择一个 OpenClaw on VPS 套餐并完成结账。 + + + 你可以在结账过程中选择 **Ready-to-Use AI** 积分——这些积分已预先购买，并会立即在 OpenClaw 内集成，因此你无需任何外部账户或其他提供商的 API 密钥即可开始聊天。 + + + + + + VPS 配置完成后，填写以下配置字段： + + - **Gateway token** —— 自动生成；请保存以便后续使用。 + - **WhatsApp number** —— 带国家区号的你的号码（可选）。 + - **Telegram bot token** —— 来自 [BotFather](https://t.me/BotFather)（可选）。 + - **API keys** —— 仅当你在结账时未选择 Ready-to-Use AI 积分时才需要。 + + + + + 点击 **Deploy**。运行后，在 hPanel 中点击 **Open** 打开 OpenClaw 仪表板。 + + + + +日志、重启和更新均可直接在 hPanel 的 Docker Manager 界面中管理。要更新，请在 Docker Manager 中点击 **Update**，这将拉取最新镜像。 + +## 验证你的设置 + +在你已连接的渠道中向你的助手发送“Hi”。OpenClaw 会回复你，并引导你完成初始偏好设置。 + +## 故障排除 + +**仪表板无法加载** —— 等待几分钟，让容器完成配置。检查 hPanel 中 Docker Manager 的日志。 + +**Docker 容器持续重启** —— 打开 Docker Manager 日志，查看是否存在配置错误（缺少令牌、API 密钥无效）。 + +**Telegram 机器人没有响应** —— 直接通过 Telegram 将你的配对代码消息发送到 OpenClaw 聊天中，以完成连接。 + +## 后续步骤 + +- [渠道](/zh-CN/channels) —— 连接 Telegram、WhatsApp、Discord 等 +- [Gateway 网关配置](/zh-CN/gateway/configuration) —— 所有配置选项 diff --git a/docs/zh-CN/vps.md b/docs/zh-CN/vps.md index 0288a2666..044364043 100644 --- a/docs/zh-CN/vps.md +++ b/docs/zh-CN/vps.md @@ -1,75 +1,78 @@ --- read_when: - 你想在 Linux 服务器或云 VPS 上运行 Gateway 网关 - - 你需要一份托管指南的快速地图 - - 你想了解适用于 OpenClaw 的通用 Linux 服务器调优 + - 你需要一份托管指南的快速导航图 + - 你想了解适用于 OpenClaw 的通用 Linux 服务器调优】【。 sidebarTitle: Linux Server -summary: 在 Linux 服务器或云 VPS 上运行 OpenClaw——提供商选择、架构与调优 +summary: 在 Linux 服务器或云 VPS 上运行 OpenClaw —— 提供商选择器、架构与调优 title: Linux 服务器 x-i18n: - generated_at: "2026-04-05T10:13:02Z" + generated_at: "2026-04-13T13:14:20Z" model: gpt-5.4 provider: openai - source_hash: 7f2f26bbc116841a29055850ed5f491231554b90539bcbf91a6b519875d494fb + source_hash: e623f4c770132e01628d66bfb8cd273bbef6dad633b812496c90da5e3e0f1383 source_path: vps.md workflow: 15 --- # Linux 服务器 -在任意 Linux 服务器或云 VPS 上运行 OpenClaw Gateway 网关。本页将帮助你选择提供商，解释云部署的工作方式，并介绍适用于各种环境的通用 Linux 调优。 +在任何 Linux 服务器或云 VPS 上运行 OpenClaw Gateway 网关。本页可帮助你 +选择提供商，说明云部署如何工作，并介绍适用于各种环境的通用 Linux +调优方法。 ## 选择提供商 - 一键部署，浏览器设置 - 一键部署，浏览器设置 + 一键式浏览器安装 + 一键式浏览器安装 简单的付费 VPS - 永久免费 ARM 层级 + 永久免费 ARM 套餐 Fly Machines - 在 Hetzner VPS 上运行 Docker + 在 Hetzner VPS 上使用 Docker + 支持一键安装的 VPS Compute Engine - Linux VM - 带 HTTPS 代理的 VM + Linux 虚拟机 + 带 HTTPS 代理的虚拟机 ARM 自托管 -**AWS（EC2 / Lightsail / 免费层）** 也运行良好。 -社区视频演示可见： +**AWS（EC2 / Lightsail / 免费套餐）** 也非常适合。 +社区视频演示可见 [x.com/techfrenAJ/status/2014934471095812547](https://x.com/techfrenAJ/status/2014934471095812547) -（社区资源——未来可能无法访问）。 +（社区资源——未来可能失效）。 -## 云端部署如何工作 +## 云端部署的工作方式 -- **Gateway 网关运行在 VPS 上**，并持有状态和工作区。 -- 你通过 **Control UI** 或 **Tailscale/SSH** 从笔记本电脑或手机连接。 -- 请将 VPS 视为真实来源，并定期**备份**状态和工作区。 -- 安全默认：将 Gateway 网关保持在 loopback 上，并通过 SSH 隧道或 Tailscale Serve 访问。 - 如果你绑定到 `lan` 或 `tailnet`，请要求使用 `gateway.auth.token` 或 `gateway.auth.password`。 +- **Gateway 网关运行在 VPS 上**，并负责状态和工作区。 +- 你可通过 **Control UI** 或 **Tailscale/SSH** 从笔记本电脑或手机连接。 +- 将 VPS 视为唯一真实来源，并定期**备份**状态和工作区。 +- 默认安全做法：将 Gateway 网关绑定在 loopback 上，并通过 SSH 隧道或 Tailscale Serve 访问。 + 如果你绑定到 `lan` 或 `tailnet`，请务必启用 `gateway.auth.token` 或 `gateway.auth.password`。 -相关页面：[Gateway 网关远程访问](/zh-CN/gateway/remote)、[平台中心](/zh-CN/platforms)。 +相关页面：[Gateway 远程访问](/zh-CN/gateway/remote)、[平台总览](/zh-CN/platforms)。 -## 在 VPS 上运行共享公司 agent +## 在 VPS 上为公司团队共享一个智能体 -当所有用户都处于相同信任边界内，且该 agent 仅用于业务时，为团队运行单个 agent 是一种有效的部署方式。 +当所有用户都处于同一信任边界内，且该智能体仅用于业务场景时，为团队运行单个智能体是一种可行的方案。 -- 请将其放在专用运行环境中（VPS/VM/container + 专用 OS 用户/账户）。 -- 不要让该运行环境登录个人 Apple/Google 账户，或个人浏览器/密码管理器配置文件。 -- 如果用户彼此对抗，请按 gateway/主机/OS 用户拆分。 +- 将它放在专用运行环境中（VPS/VM/容器 + 专用 OS 用户/账号）。 +- 不要让该运行环境登录个人 Apple/Google 账号，或个人浏览器/密码管理器配置。 +- 如果用户彼此之间存在对抗风险，请按 Gateway 网关/主机/OS 用户进行隔离。 安全模型详情请参阅：[安全](/zh-CN/gateway/security)。 -## 在 VPS 上使用节点 +## 在 VPS 中配合节点使用 -你可以将 Gateway 网关保留在云端，并在本地设备 -（Mac/iOS/Android/headless）上配对**节点**。节点提供本地屏幕/摄像头/canvas 和 `system.run` +你可以将 Gateway 网关保留在云端，并在本地设备上配对**节点** +（Mac/iOS/Android/无头设备）。节点可提供本地屏幕/摄像头/canvas 和 `system.run` 能力，而 Gateway 网关仍保留在云端。 文档：[节点](/zh-CN/nodes)、[节点 CLI](/cli/nodes)。 -## 小型 VM 和 ARM 主机的启动调优 +## 面向小型 VM 和 ARM 主机的启动调优 -如果在低性能 VM（或 ARM 主机）上 CLI 命令感觉较慢，请启用 Node 的模块编译缓存： +如果在低性能 VM（或 ARM 主机）上 CLI 命令感觉较慢，可启用 Node 的模块编译缓存： ```bash grep -q 'NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache' ~/.bashrc || cat >> ~/.bashrc <<'EOF' @@ -80,25 +83,25 @@ EOF source ~/.bashrc ``` -- `NODE_COMPILE_CACHE` 可提升重复命令的启动速度。 +- `NODE_COMPILE_CACHE` 可提升重复执行命令时的启动速度。 - `OPENCLAW_NO_RESPAWN=1` 可避免自重启路径带来的额外启动开销。 -- 第一次运行命令会预热缓存；之后运行会更快。 -- 关于 Raspberry Pi 的具体内容，请参阅 [Raspberry Pi](/zh-CN/install/raspberry-pi)。 +- 首次执行命令会预热缓存；后续执行会更快。 +- 关于 Raspberry Pi 的具体说明，请参阅 [Raspberry Pi](/zh-CN/install/raspberry-pi)。 -### systemd 调优检查清单（可选） +### `systemd` 调优清单（可选） 对于使用 `systemd` 的 VM 主机，可考虑： -- 为服务添加环境变量，以获得稳定的启动路径： +- 为服务添加环境变量，以获得更稳定的启动路径： - `OPENCLAW_NO_RESPAWN=1` - `NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache` -- 让重启行为保持显式： +- 明确设置重启行为： - `Restart=always` - `RestartSec=2` - `TimeoutStartSec=90` -- 优先使用 SSD 支持的磁盘用于状态/缓存路径，以减少随机 I/O 冷启动惩罚。 +- 状态/缓存路径尽量使用 SSD 支持的磁盘，以减少随机 I/O 冷启动带来的性能损失。 -对于标准的 `openclaw onboard --install-daemon` 路径，请编辑用户 unit： +对于标准的 `openclaw onboard --install-daemon` 路径，请编辑用户单元： ```bash systemctl --user edit openclaw-gateway.service @@ -113,9 +116,9 @@ RestartSec=2 TimeoutStartSec=90 ``` -如果你有意安装的是 system unit，请改用 +如果你是有意安装为系统单元，请改为通过 `sudo systemctl edit openclaw-gateway.service` 编辑 `openclaw-gateway.service`。 -关于 `Restart=` 策略如何帮助自动恢复： -[systemd can automate service recovery](https://www.redhat.com/en/blog/systemd-automate-recovery)。 +关于 `Restart=` 策略如何帮助自动恢复，请参阅： +[systemd 可自动执行服务恢复](https://www.redhat.com/en/blog/systemd-automate-recovery)。