Clawdbot 绿联nas部署全流程教程
复旦四米大
编辑于 2026年01月28日 14:05

写在最前面

前置条件,绿联nas上开个虚拟机。对资源要求不高。虚拟机用ubantu,官方下个iso就行。

场景: 位于上海 NAS 上的 Ubuntu 虚拟机(无公网 IP),位于杭州的客户端电脑。

核心方案: Tailscale 组网 + SSH 隧道穿透 + Node.js 22 + 智谱 API。


第一阶段:虚拟机网络配置 (Tailscale)

目标:让这台没有公网 IP 的虚拟机能被远程访问。

登录虚拟机控制台

通过 NAS 网页后台的 VNC/控制台登录 Ubuntu 终端。

安装 Tailscale

代码块
PlainText
自动换行
复制代码
curl -fsSL https://tailscale.com/install.sh | sh
复制成功

启动并绑定账号

代码块
PlainText
自动换行
复制代码
sudo tailscale up
复制成功

复制屏幕上出现的https://tailscale.com/a/...链接。

在任意浏览器打开该链接,登录你的 Tailscale 账号授权。

关键点: 授权成功后,记录下分配给这台虚拟机的 Tailscale IP(通常以 100. 开头)。


第二阶段:环境准备 (Node.js & Git)

目标:解决 Ubuntu 默认软件源版本过旧和 GitHub 连接被拒的问题。

更换 Git 下载协议(解决 npm 安装报错)

由于新机器没有配置 SSH Key,强制让 npm/git 走 HTTPS 协议下载依赖:

代码块
PlainText
自动换行
复制代码
git config --global url."https://github.com/".insteadOf ssh://git@github.com/
复制成功

安装 Node.js 22 (LTS)

Clawdbot 强制要求 Node.js 20+,Ubuntu 默认的 v18 会报错,必须手动升级:

代码块
PlainText
自动换行
复制代码
# 1. 移除旧版本(如果有)
sudo apt remove -y nodejs npm && sudo apt autoremove -y

# 2. 添加 Node.js 22 官方源
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

# 3. 安装新版本
sudo apt install -y nodejs

# 4. 验证(必须显示 v22.x.x)
node -v
复制成功

第三阶段:安装与初始化 Clawdbot

目标:部署程序并写入正确配置。

安装 Clawdbot

代码块
PlainText
自动换行
复制代码
sudo npm i -g clawdbot
复制成功

初始化配置(Onboard 向导)

执行 clawdbot onboard,请严格按照以下选项选择:

Setup? $\rightarrow$ Local gateway (this machine)

Model? $\rightarrow$ http://Z.AI (GLM-4-Flash)

理由:Flash 模型速度极快,数据包小,最适合 SSH 隧道环境,避免前端超时白屏。

API Key? $\rightarrow$ 粘贴你的智谱 API Key

Gateway bind? $\rightarrow$ LAN (0.0.0.0)

理由:必须选这个,否则 SSH 隧道无法转发流量。

Gateway auth? $\rightarrow$ Token

Tailscale exposure? $\rightarrow$ Off

Select a channel? $\rightarrow$ Finished

设置访问密码

代码块
PlainText
自动换行
复制代码
clawdbot config set gateway.auth.token "你的自定义密码"
复制成功

启动服务

代码块
PlainText
自动换行
复制代码
clawdbot gateway --force
复制成功

看到日志滚动且无报错,即为启动成功。


第四阶段:客户端远程连接 (SSH 隧道)

目标:在杭州电脑上通过浏览器访问上海的服务。

清理旧指纹(仅限重装过系统后)

在杭州电脑终端执行:

代码块
PlainText
自动换行
复制代码
ssh-keygen -R <上海虚拟机的Tailscale IP>
复制成功

建立 SSH 隧道

在杭州电脑终端执行(不要关闭窗口):

代码块
PlainText
自动换行
复制代码
ssh -L 18789:localhost:18789 用户名@<上海虚拟机的Tailscale IP>
复制成功

浏览器访问

在杭州电脑浏览器访问以下完整地址:

代码块
PlainText
自动换行
复制代码
http://localhost:18789/?token=你的自定义密码
复制成功

附:常见问题急救手册 (Troubleshooting)

报错 Port already in use 或 Gateway already running

原因:服务卡死或未彻底关闭。

解决:

代码块
PlainText
自动换行
复制代码
systemctl --user stop clawdbot-gateway.service
pkill -f clawdbot
# 如果是重装,记得运行 systemctl --user reset-failed
复制成功

网页能打开但发消息不回(白屏/超时)

原因:模型响应太慢,导致 WebSocket 连接在隧道中超时断开。

解决:切换到极速模型。

代码块
PlainText
自动换行
复制代码
clawdbot config set defaultModel zai/glm-4-flash
clawdbot gateway --force
复制成功

安装时 npm 报错 Permission denied (publickey)

原因:Git 试图用 SSH 协议下载依赖。

解决:执行第二阶段第 1 步的 git config 命令。


最后分享下体验,软件的权限自身给的非常高,所以你几乎可以让他做任何事,甚至包括把自己改造一下。体验好的地方是继集成了大量成熟的AI工具,体验不好的是,整个网络环境过于崎岖,会容易出各种奇怪的问题。真的想玩我觉得租个服务器比较好,现在也有很多几块钱租一年的。租个国外的服务器效果更佳。

本人正在魔改一个适合国内网络环境的版本,感兴趣的环境关注、点赞、收藏。有进展会第一时间通知。