详细图文教程

Linux / VPS 从零安装小龙虾,按这 5 步走

这页按最常见的 Ubuntu / Debian 服务器 路线来写:连上 SSH → 复制官方安装脚本 → 准备 DeepSeek Key → 完成 onboarding → 验证 Gateway 并打开控制台

如果你不是远程 VPS,而是本地 Linux 桌面,也能照着这页做。区别只是你不需要 SSH,直接打开本机终端就行。

开始前先准备好这 4 样

Linux 环境里最容易卡住的是权限和连接。只要这四样到位,后面就能稳很多。

你需要准备

  • 1. 一台 Linux 主机或 VPS
  • 2. 可登录的用户和服务器 IP
  • 3. 一个 DeepSeek API Key
  • 4. 有 sudo 权限或 root 权限

这页的真实顺序

  1. 1. 先连上服务器或打开终端
  2. 2. 再复制官方 Linux 安装命令
  3. 3. 再把 DeepSeek Key 准备好
  4. 4. 然后完成安装和 onboarding
  5. 5. 最后验证 Gateway,并用隧道打开控制台

第 1 步,先把 Linux 终端准备好

如果你装在 VPS 上,这一步通常就是 SSH;如果你是本地 Linux 桌面,直接打开终端即可。

1

先连上 SSH,看到服务器提示符再继续

最常见的 VPS 登录命令是:

ssh your_user@your_server_ip
  • - 把 your_user 改成你的服务器账号
  • - 把 your_server_ip 改成你的服务器 IP
  • - 看到图里第 3 个标注指向的提示符以后,再继续往下做
Linux 通过 SSH 登录服务器
如果你是本地 Linux 桌面,这一步可以理解成:先打开终端并确认自己已经在正确的系统里。

第 2 步,先确认你抄的是官方 Linux 安装命令

Linux、macOS、WSL2 用的是同一条 install.sh。先在官方页面认准,再回到终端执行。

2

打开官方安装页,复制 Linux 命令

浏览器里打开:

https://docs.openclaw.ai/install/index
  • - 看图里 1,认准 macOS / Linux / WSL2 标签
  • - 看图里 2,复制下面这条安装命令
curl -fsSL https://openclaw.ai/install.sh | bash
OpenClaw 官方安装页 Linux 命令
这条官方 install.sh 是最稳的主流程。它会自动处理 Node、OpenClaw 和 onboarding。

第 3 步,把 DeepSeek API Key 先准备好

Linux 端装到一半再去找 Key,最容易让终端窗口和浏览器来回切,零基础会特别容易乱。先准备好。

3

先拿到 DeepSeek Key,再回到 Linux 终端

  • - 先进入 API Keys 页面
  • - 创建新的 Key
  • - 看到完整 Key 后立刻复制,并先贴到本地记事本临时保存
DeepSeek API Keys 页面示意图
先进入 API Keys 页面,再点 Create API Key。
DeepSeek 复制 API Key 示意图
完整 Key 一般只显示一次。Linux 服务器上更建议先把它保存到你本地电脑的临时文本里。

第 4 步,回到 Linux 终端完成安装和 onboarding

这一步会把 OpenClaw 真正装进你的 Linux 机器。前面准备好的 SSH、安装命令和 Key,都会在这里用上。

4

先运行安装脚本,再完成 DeepSeek onboarding

回到 Linux 终端,粘贴刚才复制的安装命令并回车:

curl -fsSL https://openclaw.ai/install.sh | bash
Linux 终端执行 OpenClaw 安装脚本
第一次跑 install.sh 时,不要急着 Ctrl+C。等它自己完成依赖检查和安装。

正常情况下,安装脚本会继续进入 onboarding。如果没有自动继续,就手动执行:

openclaw onboard --install-daemon
OpenClaw 官方 Getting Started 的 onboarding 命令
官方 onboarding 命令就在 Getting Started 里。没自动继续时,直接手动跑它。
Linux onboarding 选择 DeepSeek 的示意图
平台选 DeepSeek,粘贴刚才保存的 Key,默认模型先用 deepseek-chat。

第 5 步,验证是否真的装好了

Linux 上最容易误判的是:服务已经起来了,但你没有正确地从本机打开控制台。所以这一步要分成两半:先查 Gateway,再处理控制台访问。

5

先查 Gateway,再决定如何打开控制台

openclaw gateway status
openclaw dashboard
OpenClaw 官方文档里的 gateway status 和 dashboard 命令
官方顺序依然是:先看 gateway status,再尝试 dashboard。
Linux 终端验证 Gateway 并建立 SSH 隧道
如果你装在 VPS 上,通常要在你自己的电脑上开 SSH 隧道,才能把服务器上的 18789 映射到本地浏览器。

如果你已经把 18789 通过 SSH 隧道映射到本地浏览器,或者你本来就是 Linux 桌面本机安装,那么控制台打开以后,直接发第一条测试消息就行。

OpenClaw 控制台发送第一条测试消息
真正的成功标准不是“命令没报错”,而是你发出测试消息后,控制台真的给你回了一条 AI 回复。