OpenClaw 小龙虾部署教程：把 24 小时在线的 AI Agent 跑到服务器上

前几篇我们一直围绕 Hermes Agent：先把 Agent 部署到服务器，再接 API，再接 Telegram 和 QQ 群。

这一篇换一个同类应用：OpenClaw，也就是很多人昵称里的“小龙虾”。

它的定位很直接：不是再开一个聊天网页，而是把一个 AI Agent 常驻在你的服务器上，让它可以连接工具、浏览器、终端、消息入口和工作流，像一个长期在线的数字员工一样处理任务。

这篇会按一个比较稳的 VPS 部署思路来写：

• 为什么建议先部署到 VPS，而不是直接放在主力电脑；
• 如何安装 Node/npm 和 OpenClaw CLI；
• 如何完成 openclaw onboard；
• 如何接入 OpenAI 兼容模型 API；
• 如何访问本地 Web UI；
• 如何接 Telegram 或其他聊天入口；
• 如何用 systemd 让它长期运行；
• 如何控制 token 成本和安全边界。

其中模型 API 的部分会自然接到 Nbility：因为 OpenClaw 这类 Agent 不是“一问一答”的网页聊天，它会持续调用模型、工具和自动化流程，token 入口的稳定性很重要。

OpenClaw 是什么？

你可以把 OpenClaw 理解成一个“给大模型装上身体”的 Agent 运行层。

普通聊天工具通常是：

你打开网页 -> 输入问题 -> 得到文字 -> 自己复制粘贴执行 -> 关闭网页

OpenClaw 更像：

你发任务 -> Agent 理解目标 -> 调用工具 -> 运行命令/浏览网页/整理资料 -> 持续在线等下一次任务

它本身不是一个模型。你仍然需要接入 Claude、OpenAI、Gemini、本地模型，或者 OpenAI 兼容 API。OpenClaw 负责的是：

• 运行 Agent；
• 管理配置和 onboarding；
• 连接工具和消息渠道；
• 维持长期在线状态；
• 让 Agent 记住上下文、处理工作流。

为什么建议先部署到 VPS？

理论上 OpenClaw 可以跑在本地电脑、Mac mini、云主机或容器里。但如果你是第一次部署 24 小时在线的 Agent，我更建议先用 VPS。

原因很简单：

1. 更像真实生产环境：服务长期运行、网络固定、方便接 Telegram/Discord/QQ 桥接。
2. 更安全：Agent 不直接碰你主力电脑里的浏览器历史、个人文件和密码。
3. 更容易重装：玩坏了就重建服务器，不影响本机环境。
4. 更适合自动化：定时任务、Webhook、消息平台都更依赖常在线机器。

最低配置不用太夸张：1～2 核 CPU、2～4GB 内存可以先试水；如果你要跑浏览器自动化、多个 Agent、长期日志和数据库，再往上加。

准备条件

下面以 Ubuntu VPS 为例。

你需要：

• 一台 Ubuntu 服务器；
• 一个普通 SSH 登录用户或 root；
• Node.js / npm；
• 一个模型 API Key；
• 可选：Telegram Bot Token；
• 可选：域名、反向代理、HTTPS。

先更新系统：

sudo apt update
sudo apt upgrade -y

安装基础工具：

sudo apt install -y curl git ca-certificates build-essential

安装 Node.js。建议用 NodeSource 或 nvm，这里用 NodeSource 举例：

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
node -v
npm -v

第一步：安装 OpenClaw CLI

如果你使用 npm 管理 Node 环境，可以直接装：

sudo npm i -g openclaw

然后确认命令可用：

openclaw --help

如果你用的是官方安装脚本或云厂商一键模板，也可以跳过 npm 安装这一步，直接进入 onboarding。

注意：不同 OpenClaw 版本的命令可能会变化。正式部署前建议先跑 openclaw --help 和 openclaw onboard --help，以当前 CLI 输出为准。

第二步：准备模型 API

OpenClaw 需要一个“脑子”。常见选择是：

• Claude / Anthropic；
• OpenAI；
• Gemini；
• Ollama 本地模型；
• OpenAI 兼容 API。

如果你想少折腾，多数 Agent 应用都可以先用 OpenAI 兼容 API 跑起来。Nbility 的优势就在这里：你可以把 Base URL、API Key、模型名统一配置给 Agent 应用，后面 Hermes、OpenClaw、Dify、NextChat 等都可以沿用同一个 token 体系。

示例配置思路：

Base URL: https://api.nbility.dev/v1
API Key:  sk-xxxxxxxxxxxxxxxx
Model:    选择你在 Nbility 可用的模型

文档和截图里不要写真实 Key。教程、配置样例、配图里统一写：

[REDACTED]

第三步：运行 onboarding

安装完成后，运行：

openclaw onboard

onboarding 一般会引导你完成：

• 选择模型 provider；
• 输入 API Key；
• 选择交互方式；
• 生成本地配置；
• 连接 Web UI 或聊天渠道；
• 初始化运行环境。

如果它支持 OpenAI 兼容 provider，就按下面思路填：

Provider: OpenAI-compatible / Custom OpenAI endpoint
Base URL: https://api.nbility.dev/v1
API Key: [REDACTED]
Model:   你的模型名

如果当前版本的 onboarding 没有直接显示“OpenAI-compatible”，就先选 OpenAI，再在配置文件里查看是否能修改 Base URL。不同版本的 OpenClaw 配置路径可能不同，所以这里不要盲改，先用命令查：

openclaw --help
openclaw config --help

第四步：打开 Web UI

很多教程会提到 OpenClaw 本地 UI 默认在：

http://localhost:18789

服务器上可以先本地测试：

curl -I http://127.0.0.1:18789

如果你从自己电脑访问远程服务器，不建议一上来就把端口裸露到公网。更安全的方式是 SSH 隧道：

ssh -L 18789:127.0.0.1:18789 root@你的服务器IP

然后在本机浏览器打开：

http://127.0.0.1:18789

如果你确实要公网访问，再考虑 Nginx 反向代理、Basic Auth、HTTPS 和 IP 白名单。

第五步：连接 Telegram 或其他消息入口

一个 24 小时在线 Agent 最好不要只活在网页里。接 Telegram、Discord、Slack 或你自己的桥接层，才更像“随叫随到”。

以 Telegram 为例，大致流程是：

1. 找 BotFather 创建 bot；
2. 拿到 Bot Token；
3. 在 OpenClaw onboarding 或配置里填入；
4. 启动 gateway；
5. 给 bot 发一句测试消息。

这里的成本点也很清楚：用户每发一次任务，Agent 可能不止调用一次模型。它可能先规划，再调用工具，再总结结果。接入聊天入口后，因为使用频率更高，token 消耗也会比单纯网页聊天更明显。

第六步：用 systemd 常驻运行

如果你只是 SSH 进去手动运行 OpenClaw，断开终端后服务可能会停。生产里建议用 systemd。

先确认启动命令。不同版本可能是：

openclaw gateway run

或：

openclaw run

以实际 openclaw --help 为准。假设你的启动命令是 openclaw gateway run，可以创建：

sudo tee /etc/systemd/system/openclaw.service >/dev/null <<'EOF'
[Unit]
Description=OpenClaw AI Agent
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/root
Environment=HOME=/root
Environment=PATH=/usr/local/bin:/usr/bin:/bin
ExecStart=/usr/bin/env openclaw gateway run
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF

启动并查看：

sudo systemctl daemon-reload
sudo systemctl enable --now openclaw
sudo systemctl status openclaw --no-pager -l
journalctl -u openclaw -n 100 --no-pager

如果 systemd 找不到 openclaw，先查命令路径：

which openclaw

然后把 ExecStart 改成绝对路径。

第七步：做一次端到端验证

部署 Agent 不要只看“进程在不在”，要做端到端验证。

建议按这个顺序：

# 1. CLI 是否可用
openclaw --help

# 2. 配置是否存在
openclaw config --help || true

# 3. Web UI 是否可访问
curl -I http://127.0.0.1:18789 || true

# 4. 服务是否常驻
systemctl is-active openclaw || true
journalctl -u openclaw -n 50 --no-pager || true

然后从你接入的聊天入口发一条真实任务：

帮我总结一下你现在能做什么，并列出 3 个适合自动化的任务。

如果模型 API 配错，通常会看到：

• 401 / unauthorized：API Key 错；
• 404 / model not found：模型名错；
• connection refused：Base URL 或网络错；
• rate limit / insufficient quota：额度或限速问题。

token 成本怎么控制？

OpenClaw 这类 Agent 消耗 token 的方式，和普通聊天不太一样。

普通聊天可能是：

用户一句话 -> 模型一次回复

Agent 任务可能是：

用户一句话 -> 规划 -> 工具调用 -> 观察结果 -> 再规划 -> 最终总结

所以要注意：

1. 日常任务用性价比模型；
2. 深度研究、复杂代码再切更强模型；
3. 不要给公开群聊暴露全工具；
4. 定期清理无意义长上下文；
5. 给自动化任务设冷却和预算；
6. 图片生成、浏览器自动化、深度搜索要单独留预算。

这也是我会在教程里推荐 Nbility 的原因：它不是“买个聊天会员”，而是给这类持续运行的 Agent 应用准备一个统一 token 入口。你可以更清楚地管理 API Key、模型、消耗和充值。

安全建议

OpenClaw 这种 Agent 有工具和执行能力，不要当成普通聊天机器人部署。

建议：

• 不要直接跑在装满个人资料的主力电脑上；
• VPS 上只放必要文件和权限；
• API Key 放环境变量或配置文件，不写进文章和截图；
• Web UI 不要裸奔公网；
• 聊天入口加白名单；
• 高风险工具需要确认；
• 定期看日志和费用；
• 先用小任务测试，再逐步放开权限。

常见问题

1. openclaw: command not found

检查 npm 全局 bin 路径：

npm bin -g
which openclaw

如果用 nvm，systemd 里默认找不到 nvm 路径，需要在 Environment=PATH=... 里补上实际路径，或者用绝对路径启动。

2. Web UI 打不开

先在服务器本机测：

curl -I http://127.0.0.1:18789

如果本机都不通，说明服务没起来。先看日志，不要急着改 Nginx。

3. Telegram 没回复

检查三件事：

• Bot Token 是否正确；
• OpenClaw gateway 是否在运行；
• 服务器是否能访问 Telegram API。

4. API Key 明明填了，还是 401

确认你填的是 API Key，不是网页登录 token；确认 Base URL 是：

https://api.nbility.dev/v1

同时确认模型名在你的账号里可用。

5. token 消耗比预期高

这是 Agent 常见现象。先减少工具、缩短上下文、降低自动任务频率，再考虑切模型。

小结

这一篇我们把 OpenClaw 小龙虾部署到了服务器上，并梳理了从 CLI、onboarding、模型 API、Web UI、消息入口到 systemd 常驻运行的完整路径。

这类应用非常适合作为 Nbility 的软推广场景，因为它天然需要：

• 稳定的 OpenAI 兼容 Base URL；
• 可管理的 API Key；
• 持续可充值的 token；
• 可在多个 Agent 应用之间复用的模型入口。

下一篇可以继续写：AI Agent 为什么比普通聊天更消耗 token。这篇可以专门解释规划、工具调用、上下文、图片生成、搜索、失败重试这些成本点，也更适合承接 token 站点的转化。

本文配图提示词

封面图：

A polished tech blog cover illustration. niku, Nbility mascot, cute anime catgirl with black cat ears and black hoodie with orange lightning logo, deploying a cute lobster-shaped OpenClaw AI agent on a VPS server, terminal windows, cloud server panels, token meter, black and orange brand palette, no readable real credentials, leave empty title space.

正文图：

A clean anime-tech illustration showing OpenClaw AI agent running 24/7 on a VPS, connected to Web UI, Telegram chat, model API, tools, and token meter. Include niku as a guide, black and orange colors, no real keys or private data.