详细图文教程

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 回复。
恭喜,你装好了

发出第一条消息,就算真正完成了

控制台能收到 AI 回复,说明整条链路已经通了。接下来可以换一个模型、接入更多渠道,或者去交流广场把你的安装体验分享出来。

下一步

装好之后,把 API Key 配进去

本地安装走通后,需要给它接一个大模型的 API Key 才能开始对话。先选一家拿 Key。