5676a6b38d
What: switch to 你/你的 tone; standardize Skills/Gateway网关/local loopback/私信 wording Why: align zh-CN docs with issue 6995 feedback + idiomatic tech style Tests: pnpm docs:build
100 lines
2.2 KiB
Markdown
100 lines
2.2 KiB
Markdown
---
|
||
read_when:
|
||
- 查找 Linux 伴侣应用状态
|
||
- 规划平台覆盖范围或贡献
|
||
summary: Linux 支持 + 伴侣应用状态
|
||
title: Linux 应用
|
||
x-i18n:
|
||
generated_at: "2026-02-01T21:32:18Z"
|
||
model: claude-opus-4-5
|
||
provider: pi
|
||
source_hash: a9bbbcecf2fd522a2f5ac8f3b9068febbc43658465bfb9276bff6c3e946789d2
|
||
source_path: platforms/linux.md
|
||
workflow: 15
|
||
---
|
||
|
||
# Linux 应用
|
||
|
||
Gateway网关在 Linux 上完全受支持。**推荐使用 Node 作为运行时**。
|
||
不建议将 Bun 用于 Gateway网关（WhatsApp/Telegram 存在 bug）。
|
||
|
||
原生 Linux 伴侣应用已在计划中。如果你想帮助构建，欢迎贡献。
|
||
|
||
## 新手快速路径（VPS）
|
||
|
||
1. 安装 Node 22+
|
||
2. `npm i -g openclaw@latest`
|
||
3. `openclaw 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](/platforms/exe-dev)
|
||
|
||
## 安装
|
||
|
||
- [快速开始](/start/getting-started)
|
||
- [安装与更新](/install/updating)
|
||
- 可选流程：[Bun（实验性）](/install/bun)、[Nix](/install/nix)、[Docker](/install/docker)
|
||
|
||
## Gateway网关
|
||
|
||
- [Gateway网关运维手册](/gateway)
|
||
- [配置](/gateway/configuration)
|
||
|
||
## Gateway网关服务安装（CLI）
|
||
|
||
使用以下任一方式：
|
||
|
||
```
|
||
openclaw onboard --install-daemon
|
||
```
|
||
|
||
或：
|
||
|
||
```
|
||
openclaw gateway install
|
||
```
|
||
|
||
或：
|
||
|
||
```
|
||
openclaw configure
|
||
```
|
||
|
||
出现提示时选择 **Gateway网关服务**。
|
||
|
||
修复/迁移：
|
||
|
||
```
|
||
openclaw doctor
|
||
```
|
||
|
||
## 系统控制（systemd 用户单元）
|
||
|
||
OpenClaw 默认安装 systemd **用户**服务。对于共享或常驻服务器，请使用**系统**服务。完整的单元示例和指南请参阅 [Gateway网关运维手册](/gateway)。
|
||
|
||
最小化设置：
|
||
|
||
创建 `~/.config/systemd/user/openclaw-gateway[-<profile>].service`：
|
||
|
||
```
|
||
[Unit]
|
||
Description=OpenClaw 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
|
||
```
|