市面上的 AI 助手大多跑在云端，数据上传到别人的服务器，隐私和延迟都是问题。OpenClaw 是一个开源的个人 AI 助手，定位”跑在自己设备上的本地优先 AI 助手”，GitHub 已获 37 万 Star，MIT 协议开源。本文将介绍它的核心功能、两种部署方式，以及在群晖 NAS 上的完整搭建流程。
OpenClaw 是什么
OpenClaw 的架构围绕一个本地 Gateway 展开，Gateway 是”控制面”，AI 助手本身是”产品”。它支持在 24 个以上的聊天平台上与用户交互，包括 WhatsApp、Telegram、Slack、Discord、Signal、iMessage、微信、QQ、飞书、LINE 等。这意味着你可以在日常使用的聊天工具里直接跟 AI 对话，无需打开网页或专用 App。
核心功能一览
| 功能模块 | 说明 |
|---|---|
| 多渠道收件箱 | 接入了 WhatsApp、Telegram、Slack、Discord、Signal、微信、QQ、飞书等 24+ 平台 |
| 多智能体路由 | 不同渠道或联系人可路由到独立的 AI Agent，各自管理独立会话和工作区 |
| 语音交互 | macOS/iOS 支持语音唤醒词，Android 支持连续语音对话模式 |
| Live Canvas | AI Agent 驱动的可视化工作空间，实时展示和处理任务 |
| 技能系统 | 通过 ClawHub 注册中心安装和扩展技能，满足各种场景需求 |
| 浏览器工具 | 内置浏览器操作能力，Agent 可以访问网页获取信息 |
| 安全沙箱 | 基于 Docker 的沙箱后端，非主会话强制隔离运行，防止越权 |
| DM 配对保护 | 陌生人的私聊消息需要配对码验证才能被 AI 处理 |
方法一：npm 全局安装（推荐入门）
这是最简单的部署方式，适合 macOS、Linux 和 Windows(WSL2) 用户。
npm install -g openclaw@latest
openclaw onboard --install-daemononboard命令会逐步引导你完成 Gateway、工作区、渠道和技能的配置，并通过 systemd（Linux）或 launchd（macOS）安装守护进程来保活。要求 Node 24 或 Node 22.19 以上版本。
方法二：Docker Compose 部署
适合服务器或 NAS 场景，核心 docker-compose.yml 组成如下：
services:
openclaw-gateway:
image: openclaw:local
build: .
ports:
- "${OPENCLAW_GATEWAY_PORT:-18789}:18789"
- "${OPENCLAW_BRIDGE_PORT:-18790}:18790"
command: node dist/index.js gateway --bind lan --port 18789
restart: unless-stopped
environment:
- OPENCLAW_GATEWAY_TOKEN=
- TZ=${TZ:-UTC}
volumes:
- ${CONFIG_DIR:-~/.openclaw}:/home/node/.openclaw
- ${WORKSPACE_DIR:-~/.openclaw/workspace}:/home/node/.openclaw/workspace
healthcheck:
test: ["CMD", "node", "-e", "fetch('http://127.0.0.1:18789/healthz')"]
interval: 30s
openclaw-cli:
image: openclaw:local
network_mode: "service:openclaw-gateway"
stdin_open: true
tty: true
entrypoint: node dist/index.js
depends_on:
- openclaw-gateway启动命令：
docker compose build
docker compose up -d
docker compose run openclaw-cli # 进入交互式 CLI群晖 NAS 部署全流程
完全可以。OpenClaw 原生支持 Synology Chat 作为接入渠道，Docker 部署也很契合群晖的 Container Manager。
前置条件
| 项目 | 要求 |
|---|---|
| DSM 版本 | 7.2 及以上（自带 Container Manager），或 6.x 搭配 Docker 套件 |
| CPU | x86_64 机型（Intel/AMD），如 DS920+、DS723+；ARM 机型可能不兼容 |
| 内存 | 建议 4GB 以上，AI Agent 运行时会持续消耗内存 |
| 存储 | 建议使用 SSD 存储卷或 NVMe 缓存机型，AI 读写操作对磁盘有要求 |
部署步骤
1. 安装 Container Manager
在 DSM 套件中心中搜索并安装 “Container Manager”。
2. 通过 SSH 登录群晖
ssh admin@你的群晖IP3. 创建目录并拉取代码
mkdir -p /volume1/docker/openclaw
cd /volume1/docker/openclaw
git clone https://github.com/openclaw/openclaw.git .4. 创建 .env 配置文件
cat > .env << 'EOF'
OPENCLAW_GATEWAY_PORT=18789
OPENCLAW_BRIDGE_PORT=18790
OPENCLAW_CONFIG_DIR=/volume1/docker/openclaw/config
OPENCLAW_WORKSPACE_DIR=/volume1/docker/openclaw/workspace
OPENCLAW_TZ=Asia/Shanghai
EOF5. 创建数据目录并启动
mkdir -p config workspace
docker compose build
docker compose up -d6. 验证状态
docker compose ps
curl http://localhost:18789/healthz群晖部署注意事项
- 持久化路径：config 和 workspace 目录必须映射到 /volume1/ 等存储池路径，系统分区重启即丢失
- Docker 沙箱：如需沙箱隔离功能，需要在 Container Manager 中开放 /var/run/docker.sock 挂载，并在 docker-compose.yml 中取消沙箱相关注释
- 开机自启：restart: unless-stopped 已配置，群晖重启后容器会自动拉起
- 防火墙：确保群晖防火墙未拦截 18789（Gateway）和 18790（Bridge）端口
- 动态 DNS：如需外网访问，建议搭配群晖的 DDNS 服务并配置反向代理
- 内存监控：长时间运行后注意观察 Resource Monitor 中的内存占用，必要时设置容器内存限制
总结
OpenClaw 是目前开源社区中最成熟的个人 AI 助手方案之一。它解决了”AI 助手数据掌控权”这个核心痛点——所有数据留在你自己的设备上，同时保留了跨平台办公能力。Docker 部署方式非常标准，在群晖 NAS 上搭建难度不高，只要 NAS 是 x86_64 机型且内存够用，就能拥有一台 7×24 小时在线、完全私有的个人 AI 助手。
发表回复