在过去几年里,越来越多的人开始尝试把 AI 助手从“云端工具”变成“自己的基础设施”。相比在个人电脑上运行,或者租用云服务器,在家中或办公室的群晖 NAS 上部署一个长期在线的 AI 助手,既稳定,又便宜,也更容易与本地数据结合。

本文记录一次完整的实战过程:在一台群晖 NAS(Synology DS224+)上部署 Clawdbot,并配置 Telegram 与 WhatsApp 作为对话入口,同时实现 7×24 小时运行、自动重启和新闻搜索能力。文章以工程实践为主,尽量覆盖真实部署中会遇到的细节与坑。


部署环境

本次部署使用的环境如下:

  • 设备:Synology DS224+
  • CPU 架构:x86_64(Intel)
  • 系统:DSM 7.x
  • Node.js:22.x
  • Clawdbot:2026.1.24-3
  • SSH 端口:1048

之所以强调 CPU 架构,是因为 Clawdbot 及其部分依赖在 ARM 机型上兼容性较差,新手不建议从 ARM 机型开始。


为什么选择 NAS 作为运行平台

相比云服务器或个人电脑,NAS 有几个天然优势:

  • 全天候在线,适合做长期运行的服务
  • 功耗低,维护成本小
  • 可直接访问本地文件系统
  • 数据不必离开内网
  • 稳定性远高于个人电脑

这使它非常适合承担“家庭 AI 服务器”或“内部自动化助手”的角色。


开启 SSH 并连接 NAS

在 DSM 后台启用 SSH:

控制面板 → 终端机和 SNMP → 启用 SSH

假设端口设置为 1048,用户名为 pithyard,在本地电脑执行:

ssh -p 1048 [email protected]

登录成功后会看到类似:

pithyard@useless_nas:~$

安装 Node.js

推荐通过群晖「套件中心」安装 Node.js 22 LTS 版本。安装完成后验证:

node -v
npm -v

确保 Node.js 版本在 18 以上,22 更佳。


安装 Clawdbot

使用官方脚本安装:

curl -fsSL https://clawd.bot/install.sh | bash

安装完成后,二进制文件位于:

/var/services/homes/pithyard/.npm-global/bin/clawdbot

为了在任何终端中直接使用,建议加入 PATH:

echo 'export PATH="/var/services/homes/pithyard/.npm-global/bin:$PATH"' >> ~/.profile
source ~/.profile

验证:

clawdbot --help

初始化配置

执行初始化向导:

clawdbot onboard

推荐配置选择:

  • Gateway:Local
  • Workspace:默认
  • Skills 管理器:npm
  • Channels:Telegram + WhatsApp

向导会自动生成配置文件:

~/.clawdbot/clawdbot.json

配置 Telegram 机器人

创建机器人

在 Telegram 中搜索 @BotFather,执行:

/newbot

获得 Bot Token。

配置渠道

运行:

clawdbot configure --section channels

选择 Telegram,填入 Token。

配对授权

首次聊天时,机器人会返回:

  • Telegram user id
  • Pairing code

在 NAS 上执行:

clawdbot pairing approve telegram <配对码>

也可以直接改为白名单模式:

clawdbot config set channels.telegram.dmPolicy allowlist
clawdbot config set channels.telegram.allowFrom "[你的user_id]"

配置 WhatsApp

使用官方方式登录 WhatsApp Web:

clawdbot channels login

扫码即可。

注意:自己给自己发消息通常不会触发机器人,建议使用第二个号码或群聊测试。


配置新闻搜索(Brave Search API)

Clawdbot 的 web_search 工具默认使用 Brave Search API。

申请地址:

https://brave.com/search/api/

配置:

clawdbot configure --section web

建议选择:

  • Enable web_search → Yes
  • 填入 API Key
  • Enable web_fetch → Yes

这样可以同时获得搜索结果与网页全文抓取能力。


让 Clawdbot 在群晖上 7×24 小时运行

群晖系统没有 systemd,因此不能使用:

clawdbot gateway restart

正确方式是使用「任务计划器」作为守护进程。

创建任务

DSM → 控制面板 → 任务计划器 → 新增 → 触发的任务 → 用户自定义脚本

常规设置:

  • 名称:clawdbot
  • 用户:pithyard
  • 事件:开机

脚本内容(推荐)

export PATH="/var/services/homes/pithyard/.npm-global/bin:$PATH"

while true; do
  /var/services/homes/pithyard/.npm-global/bin/clawdbot gateway --port 18789
  sleep 5
done

该脚本实现:

  • 开机自动启动
  • 进程异常退出后自动重启
  • SSH 断开不影响运行

保存后右键任务 → 运行测试一次。

验证:

clawdbot status

应看到 Gateway 为 reachable。


运维与维护

查看状态

clawdbot status

查看日志

clawdbot logs --follow

重启服务(群晖方式)

pkill -f clawdbot

任务计划器会自动拉起新进程。


常见问题

1. 关闭 SSH 后机器人停止

说明未使用任务计划器或 tmux 后台方式。

2. gateway restart 报 systemctl 错误

群晖没有 systemd,属正常现象。

3. fetch failed 错误

通常是 DNS 或外网访问异常,建议测试:

curl https://www.google.com

最终效果

完成部署后,你将拥有:

  • Telegram AI 助手
  • WhatsApp AI 助手
  • 自动新闻搜索与抓取
  • 多语言翻译
  • 本地文件访问能力
  • 自动重启与长期运行

一台真正属于自己的私有 AI 服务节点。


总结

在群晖 NAS 上部署 Clawdbot,并不只是“跑一个聊天机器人”,而是构建一套长期可维护的私有智能服务基础设施。

关键经验总结:

  • 选择 x86 架构机型
  • 正确处理 PATH
  • 使用任务计划器做守护
  • 避免依赖 systemd
  • 明确网络与 DNS 可达性

完成这些步骤后,系统几乎可以长期无人值守运行。

如果后续需要扩展到:

  • 群聊管理
  • 客服自动化
  • 本地知识库
  • 多 Agent 系统
  • Docker 容器化

也都可以在此基础上逐步演进。


本文基于真实部署过程整理,适用于大多数 DSM 7.x + x86 群晖机型。

Clawdbot:一套可长期运行的私有 AI 助手实践