OpenClaw实战-NAS配置从0到1详细教程及踩坑记录

💡 大家好，我是可夫小子，关注AI编程、AI自动化和自媒体。

我去年在自己Macbook上就已经安装了Openclaw了，当时基本就是一行命令，比较顺利。经过这两个月，Openclaw版本经历了很多更新，当时的安装教程有些过时了。最近，我需要在一台群晖的Nas部署Openclaw，硬是花了两天时间才完成。我把整个详细的部署过程，一些踩坑经历用图文记录下来，就有这篇包含30多张截图的图文。

在Nas安装Openclaw，主要有三种方案来实现

1. 直接通过官方脚本，安装到Nas物理机上
2. 优点：方便，一键安装
3. 缺点：数据风险比较大，可能会导致数据丢失
4. 通过Virtual Machine Manager套件，安装Ubuntu桌面系统
5. 优点：数据隔离，同时也拥有桌面系统
6. 缺点：部署复杂一点，比较吃Nas性能
7. 通过Container Manager安装Docker镜像
8. 优点：方便，一键部署，安全；与物理机隔离；低性能机器
9. 缺点：没有桌面系统，openclaw的能力没法发挥出来

现在市面上的Nas装OpenClaw的教程大多是第2种。但这样比较吃Nas性能，我手头的Nas性能一般。后面我还是选择通过Docker来安装。大概的框架如下

• Nas
• 系统版本：Linux candynas 4.4.302+
• 群晖Nas版本：DSM 7.2.1
• IP：192.168.1.168
• 作用：Docker上运行OpenClaw服务，通过Docker的终端进行OpenClaw的模型、Channel和Gateway配置
• PC
• 系统版本：Windos系统/Mac系统，
• IP：192.168.1.7
• 作用：通过浏览器，访问http://192.168.1.168:18789访问OpenClaw服务

在Nas的进行网页管理界面，套件中心→Container Manager

因为各种原因，官网的镜像很难下载下来，先添加一个国内镜像加速器。

仓库URL填：https://docker.1ms.run

接下来就是可以在镜像仓库里面搜索openclaw，然后下载镜像，我使用的是1panel的openclaw

总共有接近4G，大约一个小时才下载完

进入Nas终端，执行以下命令启动docker

其实，在Nas网页控制台也能启动docker，但没有参数配置的地方，后来我还是通过终端命令行来启动的。

启动完成之后，输入确认目标docker是否运行正常。如下的是正常的信息。

至此，Openclaw也已经在Nas的Docker运行起来了，接下来还我们进入docker，进行Opencalw配置。

在Nasx终端执行如下命令：

然后再输入openclaw status命令查询一下openclaw的状态，如果能正常打印出来信息，就说明openclaw已经运行起来

接下来我们来进行一些基本的配置

因为在国内使用，就不折腾网络环境了，我就选择minimax，说实话最新的MiniMax-M2.5也一般，我这里只做演示，你们自己使用自己熟悉的大模型即可。

1. 首先，进入minimax官网，创建一个API KEY。
2. 仍然进入Docker里面的shell环境，执行然后选择local→model→minimax
3. 重启，然后再进入docker里面的shell，执行命令 进入openclaw的终端对话框，然后输入任意文本，看大模型是否有回复。如上，有正常回复，到此在docker里面大模型已经配置好。接下来我们配置一个Channel，即聊天工具。因为在国内考虑网络环境，选择飞书。

进入https://open.feishu.cn/app，创建企业自建应用，输入名称和描述

添加应用能力→机器人

权限这块的坑最多，网上教程大都过时，一些权限都已经改名了，找不到。就我实践来说，主要给「通讯录」和「消息与群组」两大块都授权

• 通讯录
• 消息与群组

为机器人配置一个名字

接下来应该要配置事件与回调，但这个先由openclaw先发起来，否则没办法设置。我先发布版本，然后记录下app id和app secret。然后我们又转到Docker的环境里面

执行命令Local→Chaneel→feishu，然后按照提示把app id和app secret填到里。

或者直接通过TUI终端对话，把app id和app secret输入，让他配置。

这边配置完成之后，我们就来配置飞书的长连接。

第3步添加事件有：

这样两边都配置好，就差最后一步配对。前行在飞书里面发走消息，会提示要求配对，并提供配对命令和配对码

复制这个命令，进入Docker的终端，执行：

看到Approved，即完成飞书配置。

现在我们把飞书的私聊已经完成了配置，那么飞书可以加入群聊，和小伙伴一起玩耍呢？我找了一圈，最后在官方文档上找到答案了

好吧， 也算有个结论了，我们这种非认证的个人用户，就放弃好了。

完成Openclaw的基本配置，接下来就是配置一个webui的gateway，也就是通过网页访问的方式。因为是docker，不是本机，这里面的网络配置坑最多。以下是我完成的过程

正常情况下，如果你使用我前面的docker run参数，是不会有问题的。我们再确认一下，在Nas的终端执行

如果看到PORTS里面，已经监听了0.0.0.0:18789，说明Docker的出口端口是正确的。

通过前面的命令，进入docker终端，执行看一下

看到Dashboard这是一个回环地址：127.0.0.1，没办法在局域网其他机器上访问，这个地址要改一下，通过修改bind mode

改bind mode为lan模式，如下：

再查看一下信息：

现在显示宿主机地址了。

现在访问地址已经配置好，还需要一个token才能访问，通过命令读取token，记录下来备用

在局域网其他电脑浏览器：http://192.168.1.168.18789，可以看已经看到久违的页面了，但仍然还不是正常对话，第一步先填入token

概览→网关访问

发布并没有如期完成配置，接下来还要解决三个问题:

1. 跨域的问题

提示错误信息：

解决方案：

需要在openclaw的配置文件中加入192.168.1.168这个地址。

1. https的问题

提示的信息信息：

解决方案

这个问题最坑，全网就gemini回答正确，答案更新更及时。

1. 重新获得访问令牌

错误信息：

解决方案：

按照提示，在nask 执行一下命令，重新获得授权。

然后把命令的返回URL，复制出来，改成局域网地址访问即可

到此，gateway webui配置完成，可以在局域网任意一台PC上访问openclaw服务。

现在好不容易配置好了docker，但openclaw经常会把自己搞挂，所以我们要及时备份。主要有两种方案，我现在使用的是方案一。

方案一：使用群晖图形界面备份（最推荐，简单直观）

在群晖DSM openclaw docker 教程 7.2.1中，Docker应用已经升级并更名为 Container Manager。它自带了非常方便的导入/导出功能，相当于给容器打快照。

1. 登录您的群晖NAS（192.168.1.168）。
2. 打开 Container Manager 套件。
3. 在左侧菜单点击 容器 (Container)，找到正在运行的 容器。
4. 先将容器停止 (Stop)（为了保证数据一致性）。
5. 选中该容器，点击上方的 操作 (Action) -> 导出 (Export)。
6. 在弹出的窗口中，您可以选择：

• 仅导出容器设置

  （仅备份运行参数，体积小）。

• 导出容器设置和内容

  （连同容器内部状态一起打包为 压缩包，这就是您要的“快照”）。

8. 选择保存路径到您的NAS共享文件夹中即可。

方案二：使用Docker命令行打快照（适合极客或自动化）

如果您更习惯用SSH终端（Linux命令行）操作，可以使用 和 命令来把当前容器的状态打包成一个镜像快照。

1. 将当前容器状态保存为新镜像 (Commit):

这相当于给当前容器拍了一张“快照”，生成了一个名为 标签为 的本地镜像。

2. 将新镜像导出为压缩包文件 (Save):

如何恢复 (Load)😗*如果以后需要恢复这个快照，只需运行：

整个过程完成是我自己的真实记录，没有任何AI生成的内容。我认为写的还是比较详细，收藏一下吧，说不定哪天也要用到。

我的《AI编程与自动化》2026训练营正式开营，以AI编程为驱动，让每个个体都拥有自己的小产品、小生意。训练营已积累了我过去三年200篇+的教程和案例。都是我自己实操总结，都是使用心得，并非复制网上过时的信息。现在以每周至少三篇的更新频率，让你获得最新、最接地气的AI资讯和教程。

知识库模块

📎 keeepdance，备注：AI编程。