mirror of
https://github.com/openclaw/openclaw.git
synced 2026-03-13 19:10:39 +00:00
c18452598a
* docs: restructure Get Started tab and improve onboarding flow - Flatten nested Onboarding group into linear First Steps flow - Add 'What is OpenClaw?' narrative section to landing page - Split wizard.md into streamlined overview + full reference (reference/wizard.md) - Move Pairing to Channels > Configuration - Move Bootstrapping to Agents > Fundamentals - Move macOS app onboarding to Platforms > macOS companion app - Move Lore to Help > Community - Remove duplicate install instructions from openclaw.md - Mirror navigation changes in zh-CN tabs - No content deleted — all detail preserved or relocated * docs: move deployment pages to install/, fix Platforms tab routing, clarify onboarding paths - Move deployment guides (fly, hetzner, gcp, macos-vm, exe-dev, railway, render, northflank) from platforms/ and root to install/ - Add 'Hosting and deployment' group to Install tab - Slim Gateway & Ops 'Remote access and deployment' down to 'Remote access' - Swap Platforms tab before Gateway & Ops to fix path-prefix routing - Move macOS app onboarding into First steps (parallel to CLI wizard) - Rename sidebar titles to 'Onboarding: CLI' / 'Onboarding: macOS App' - Add redirects for all moved paths - Update all internal links (en + zh-CN) - Fix img tag syntax in onboarding.md
102 lines
2.1 KiB
Markdown
102 lines
2.1 KiB
Markdown
---
|
||
read_when:
|
||
- 查找 Linux 配套应用状态时
|
||
- 规划平台覆盖或贡献时
|
||
summary: Linux 支持 + 配套应用状态
|
||
title: Linux 应用
|
||
x-i18n:
|
||
generated_at: "2026-02-03T07:52: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](/install/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 service**。
|
||
|
||
修复/迁移：
|
||
|
||
```
|
||
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
|
||
```
|