在 Linux 服务器上运行 Clawdbot AI 助手，完全支持网关、systemd 服务管理和 VPS 部署。

Clawdbot Linux 概述

Clawdbot 网关在 Linux 上完全支持。Node 是推荐的运行时。由于 WhatsApp/Telegram 的 bug，不推荐使用 Bun 作为网关运行时。

原生 Linux 配套应用正在计划中。欢迎贡献。

初学者快速路径（VPS）

# 安装 Node 22+
npm i -g clawdbot@latest
clawdbot onboard --install-daemon

从您的笔记本电脑：

ssh -N -L 18789:127.0.0.1:18789 <user>@<host>

打开 http://127.0.0.1:18789/ 并粘贴您的令牌。

安装

参见主要安装指南：

可选流程：

Docker
Nix

网关服务安装（CLI）

使用以下方法之一：

# 选项 1：在引导期间
clawdbot onboard --install-daemon

# 选项 2：直接安装
clawdbot gateway install

# 选项 3：交互式配置
clawdbot configure
# 提示时选择"网关服务"

修复/迁移：

clawdbot doctor

系统控制（systemd 用户单元）

Clawdbot 默认安装 systemd 用户服务。对于共享或始终在线的服务器，使用系统服务。

最小设置

创建 ~/.config/systemd/user/clawdbot-gateway.service：

[Unit]
Description=Clawdbot Gateway
After=network-online.target
Wants=network-online.target

[Service]
ExecStart=/usr/local/bin/clawdbot gateway --port 18789
Restart=always
RestartSec=5

[Install]
WantedBy=default.target

启用它：

systemctl --user enable --now clawdbot-gateway.service

服务管理

# 检查状态
systemctl --user status clawdbot-gateway

# 查看日志
journalctl --user -u clawdbot-gateway -f

# 重启
systemctl --user restart clawdbot-gateway

# 停止
systemctl --user stop clawdbot-gateway

启用 Lingering

要在注销后保持服务运行：

sudo loginctl enable-linger $USER

VPS 部署

VPS 部署详细指南：

SSH 隧道用于远程访问
Tailscale 用于安全网络
Docker 用于容器化部署

基本 VPS 设置

在 VPS 上安装 Clawdbot
配置网关
设置 SSH 隧道或 Tailscale
远程访问 Control UI

健康检查

clawdbot status
clawdbot health
clawdbot doctor

下一步

Clawdbot macOS - macOS 设置
Clawdbot Windows - Windows WSL2 设置
Clawdbot 网关 - 网关配置

Clawdbot Linux 设置