Debian 上安装 OpenClaw

如果你有一台 Debian VPS,想让一个 AI 助手在后台常驻运行,并且能连上 Telegram / Web / 各种模型接口,那 OpenClaw 是一个很顺手的选择。

这篇文章按“最短路径”带你在 Debian 上把 OpenClaw 装好、跑起来,并顺便把最常见的坑提前避掉。

OpenClaw 在 Debian 上的安装流程

1)准备条件(别跳过)

  • 系统:Debian 11+ / Debian 12
  • Node.js:需要 Node >= 22(如果你不确定,后面我给一条最快的安装方式)
  • 工具:curl(多数服务器默认就有)

检查一下版本

node -v
npm -v

2)一条命令安装(推荐)

官方推荐用安装脚本,它会把 CLI 装好,并引导你完成初始化:

curl -fsSL https://openclaw.ai/install.sh | bash

如果你在服务器上希望“先装好再说,稍后再做引导”,可以跳过引导:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

3)跑引导 + 安装常驻服务(daemon)

装完后,最关键的一步是把网关进程装成常驻服务(这样 SSH 断开也不会停):

openclaw onboard --install-daemon

4)验证是否跑起来

openclaw doctor
openclaw status
openclaw health

然后你可以打开仪表盘:

openclaw dashboard

5)常见坑(90% 的问题都在这里)

  • Node 版本太老:报一堆语法/依赖错误,优先升级到 Node 22+
  • PATH / 非交互环境:某些自动化执行时 PATH 过短会导致 dpkg/系统工具找不到(建议把 /usr/sbin:/sbin 加回 PATH)
  • 端口/防火墙:如果你要远程访问 Dashboard,确认安全组/防火墙放行
  • 权限:安装 daemon 需要足够权限(通常用 root 或有 sudo 的用户)

6)下一步:连接你的模型和渠道

OpenClaw 的价值在于“把模型 + 工具 + 渠道”串起来:你可以选 OpenAI / Anthropic / OpenRouter,也可以接入 OpenAI-compatible 的第三方接口;渠道侧可以接 Telegram、Webhook 等。

如果你对这类“AI 工具链搭建”感兴趣,我会在 wuxing.name 持续更新更实用的上手文章(尽量不写玄学,直接给可跑的最短路径)。

Categorized in:

个人日志,

Last Update: 6 2 月, 2026