NAS 上部署 OpenClaw 实战指南：从零起步 + 避坑全记录（新手收藏）

<div class="entry themeform"

在折腾 NAS 的过程中，我始终在寻找一套能真正实现“自动化与效率提升”的工具。直到接触 OpenClaw，才发现许多原本需要手动完成的操作，其实完全可以被解放出来。但问题在于：网上几乎没有一份完整、可直接落地的 NAS 部署指南，要么步骤不完整，要么关键配置一笔带过，新手很容易在半路卡住。

<img src="https://www.foxnan.com/wp-content/uploads/2026/06/4b371ce56127fb9.webp" alt="synology plus drive2" width="873" height="502" class="wp-image-23542 aligncenter" decoding="async"</p
<p data-start="202" data-end="372"这篇文章，我会从 <strong data-start="211" data-end="250"0 到 1 手把手带你完成 OpenClaw 在 NAS 上的完整部署</strong，包括环境准备、Docker 配置、网络访问、以及 Telegram 对接等关键步骤。同时，我也会把自己在实际部署过程中踩过的坑全部整理出来，比如镜像拉取失败、权限问题、端口无法访问、机器人无响应等常见问题，并给出可直接复现的解决方案。</p
<p data-start="374" data-end="397"如果你符合以下情况，这篇文章会对你非常有帮助：</p
<ul data-start="399" data-end="517"
<li data-section-id="da8tp4" data-start="399" data-end="433"第一次在 NAS 上部署 OpenClaw，不知道从哪里开始

虽然部署成功，但部分功能（比如 Telegram）无法正常运行

频繁遇到各类报错，却不知道根源在哪里

希望搭建一套能够长期稳定运行的自动化系统

与零散教程不同，这篇内容更偏向“实战复盘”，不仅告诉你如何操作，更重要的是让你了解为什么会出现问题，以及如何规避。

接下来，我们从最基础的环境准备开始，正式进入正题。

<div class="video-container"

部署步骤：

1、在 NAS 中安装 Docker 管理器

套件中心 → Container Manager

2、下载并安装 OpenClaw 安装包

在镜像仓库中搜索关键词：openclaw，然后下载镜像，推荐选择 1panel openclaw。

<img src="https://www.foxnan.com/wp-content/uploads/2026/06/e6a5b183d1606eb.webp" alt="2026 03 25 203706" width="852" height="312" class="wp-image-23545 aligncenter" decoding="async"</p
<p data-start="583" data-end="606" data-is-last-node="" data-is-only-node=""<span style="color: #ff0000;"<strong注意：</strong</span如果你在中国大陆，建议通过国内加速镜像进行下载，否则下载速度会很慢！设置步骤：左侧的镜像仓库 – 设置 – 新增: 镜像仓库名称：随便自定义，加速的镜像仓库URL填：<span class="invisible"https://</span<span class="visible"docker.1ms.run</span</p
<p data-start="583" data-end="606" data-is-last-node="" data-is-only-node=""<img src="https://www.freedidi.com/wp-content/uploads/2026/03/2026-03-25-203839.webp" alt="2026 03 25 203839" width="504" height="497" class="wp-image-23546 aligncenter" decoding="async"</p
<h3 data-start="583" data-end="606"<strong3、安装并运行OpenClaw 容器</strong</h3

在映像中，选中刚才下载好的 1panel/openclaw 镜像，用鼠标右键点击运行。

<img src="https://www.foxnan.com/wp-content/uploads/2026/06/85013b95f2a080b.webp" alt="2026 03 25 204226" width="1977" height="610" class="alignnone size-full wp-image-23547" decoding="async"</p
<p data-start="583" data-end="606" data-is-last-node="" data-is-only-node=""配置容器</p
<p data-start="583" data-end="606" data-is-last-node="" data-is-only-node=""<img src="https://www.freedidi.com/wp-content/uploads/2026/03/2026-03-25-204356.webp" alt="2026 03 25 204356" width="581" height="462" class="wp-image-23548 aligncenter" decoding="async"</p
<p data-start="583" data-end="606" data-is-last-node="" data-is-only-node=""这一步要做18789的端口映射，及容器空间设置，如下图所示：</p
<p data-start="583" data-end="606" data-is-last-node="" data-is-only-node=""<img src="https://www.freedidi.com/wp-content/uploads/2026/03/2026-03-25-204532.webp" alt="2026 03 25 204532" width="572" height="454" class=" wp-image-23549 aligncenter" decoding="async"</p
<p data-start="583" data-end="606" data-is-last-node="" data-is-only-node=""网络由bridge改成host，否则后续无法在其它或外网访问Nas里的Openclaw</p
<p data-start="583" data-end="606" data-is-last-node="" data-is-only-node=""<img src="https://www.freedidi.com/wp-content/uploads/2026/03/2026-03-25-204657.webp" alt="2026 03 25 204657" width="583" height="457" class=" wp-image-23550 aligncenter" decoding="async"</p
<p data-start="583" data-end="606" data-is-last-node="" data-is-only-node=""使用高权限执行容器，并在执行命令后面填写下方的代码：</p
<pre class="EnlighterJSRAW" data-enlighter-language="generic"openclaw gateway --allow-unconfigured</pre

<img src="https://www.foxnan.com/wp-content/uploads/2026/06/fc83f022d0e05de.webp" alt="20260325 1774432299" width="629" height="495" class="wp-image-23553 aligncenter" decoding="async"</pre <p data-start="583" data-end="606" data-is-last-node="" data-is-only-node=""接着点击完成来创建Openclaw 的容器</p <p data-start="583" data-end="606" data-is-last-node="" data-is-only-node=""<img src="https://www.freedidi.com/wp-content/uploads/2026/03/20260325_1774432351.webp" alt="20260325 1774432351" width="627" height="495" class="wp-image-23554 aligncenter" decoding="async"</p <h3 data-start="583" data-end="606"<strong4、在Nas里开启SSH远程访问权限</strong</h3

在控制面板中找到：终端机和 SNMP。

进入后，勾选其中的“启用 SSH 功能”，这样我们才能通过 SSH 客户端连接到 NAS。

<img src="https://www.foxnan.com/wp-content/uploads/2026/06/cbf497dfb2efcc3.webp" alt="20260325 1774432491" width="811" height="457" class="wp-image-23556 aligncenter" decoding="async"</p <h3 data-start="583" data-end="606"</h3 <h3 data-start="583" data-end="606"<strong5、下载安装SSH远程终端连接器</strong</h3

你可以下载这款完全免费的

🔒 下载链接仅对登录用户可见，请登录或注册后查看。

来进行连接操作。【🔒 下载链接仅对登录用户可见，请登录或注册后查看。
】或【备用打包下载】

连接地址：NAS 群晖的 IP 地址，例如我的是：192.168.1.113

端口：22

用户名：NAS 登录账号

密码：NAS 登录密码

登录后，通过命令 sudo -i 提升到管理员权限，然后输入命令：docker ps 来查看当前已安装的 OpenClaw 容器。

<img src="https://www.foxnan.com/wp-content/uploads/2026/06/85e18341cbfa32c.webp" alt="20260325 1774432942" width="841" height="485" class="wp-image-23558 aligncenter" decoding="async"</p <h3 data-start="583" data-end="606"</h3 <h3 data-start="583" data-end="606"<strong6、进入Openclaw 容器进行配置</strong</h3

输入命令：

sudo docker exec -it openclaw bash

进入 OpenClaw 容器。注意：如果你之前自定义的容器名称不是 openclaw，则需将上方命令中的 openclaw 改为你自定义的名称。

进入容器后，再执行命令：

openclaw onboard

进行后续配置，具体操作请参考零度的视频教程演示！

如果你选择对接 Telegram 机器人，则需要打开 @BotFather 创建机器人并进行配对。

<img src="https://www.foxnan.com/wp-content/uploads/2026/06/7cb81b7a9c88da8.webp" alt="20260325 1774433294" width="810" height="467" class="wp-image-23561 aligncenter" decoding="async"</p
<h3 data-start="583" data-end="606"</h3
<h3 data-start="583" data-end="606"<strong7、在其它电脑/外网上访问 Openclaw </strong</h3

在 OpenClaw 容器中执行命令：

openclaw config

将 Gateway 模型由 bind mode 改为 LAN 模式，如下：

修改后，OpenClaw 的面板地址会从原来的 127.0.0.1 变为 NAS 的访问地址，比如我的是：192.168.1.113。这一步非常关键！它决定了你在 NAS 中部署的 OpenClaw 能否在其他电脑或外网上访问控制面板。

当然，第一次访问时会出现以下错误信息：

origin not allowed (open the ControlUI from the gateway host or allow it in gateway.controlUi.allowedOrigins) openclaw

这主要是跨域导致的权限问题。现在，我们可以在容器中一键执行以下命令来解决这个错误：

docker exec openclaw node openclaw.mjs config set gateway.controlUi.allowedOrigins '["http://192.168.1.113:18789","http://localhost:18789"]'

注意：请将上方命令中的 IP 替换为你自己的 NAS IP 地址。

执行命令后稍等片刻，它会自动重启容器。但重启后访问时，可能还会出现错误，要求通过 HTTPS 协议访问后台，错误信息如下：

control ui requires device identity (use HTTPS or localhost secure context)

这个错误不必慌张，我们可以通过以下命令解除限制：

docker exec openclaw node openclaw.mjs config set gateway.controlUi.dangerouslyDisableDeviceAuth true

执行并重启容器后，稍等片刻即可正常访问 OpenClaw 的后台。

<img src="https://www.foxnan.com/wp-content/uploads/2026/06/f6749df77185c42.webp" alt="20260325 1774434043 scaled" width="787" height="443" class="wp-image-23564 aligncenter" decoding="async"</p
<div class="donation-container"
<button class="donation-main-btn" id="donationMainBtn"
<span class="dashicons dashicons-heart"</span 打赏支持 </button

<div class="donation-modal" id="donationModal"
<div class="donation-modal-content"
<span class="donation-close"×</span

感谢您的支持

<img src="https://www.foxnan.com/wp-content/uploads/2026/06/11c254db930eb75-9.png" alt="alipay" class="payment-icon" decoding="async"</div
<span支付宝</span
</div
<div class="donation-option" data-type="wechat"
<div class="payment-icon-wrapper"<img src="https://www.freedidi.com/wp-content/plugins/donation-button/images/wechat.png" alt="wechat" class="payment-icon" decoding="async"</div
<span微信支付</span
</div
<div class="donation-option" data-type="bitcoin"
<div class="payment-icon-wrapper"<img src="https://www.freedidi.com/wp-content/plugins/donation-button/images/bitcoin.png" alt="bitcoin" class="payment-icon" decoding="async"</div
<spanBitcoin</span
</div
<div class="donation-option" data-type="usdt"
<div class="payment-icon-wrapper"<img src="https://www.freedidi.com/wp-content/plugins/donation-button/images/usdt.png" alt="usdt" class="payment-icon" decoding="async"</div
<spanUSDT</span
</div
</div

<div class="qrcode-display" id="qrcodeDisplay"
<div class="qr-container"

</div
<p id="qrcodeText"</p

<div id="donationAddressArea" style="display:none;"
<div class="address-box"
<input type="text" id="walletAddress" readonly
<button type="button" id="copyBtn"复制</button
</div
<span id="copyMsg" style="font-size:12px; color:#26A17B; display:none;"已复制!</span
</div

<button class="back-btn" id="backBtn"返回选择</button
</div
</div
</div
</div
<div class="code-block code-block-center code-block-1 ai-track" data-ai="WzEsMCwiQmxvY2sgMSIsIiIsMV0="
<div class="ai-wait-for-interaction ai-wait-for-interaction-1" data-code="PGRpdiBjbGFzcz0nbm8tdmlzaWJpbGl0eS1jaGVjayBhaS1jaGVjay0xLTIyNzk5NzM5JyBkYXRhLWluc2VydGlvbi1wb3NpdGlvbj0nYWZ0ZXInIGRhdGEtc2VsZWN0b3I9Jy5haS1jaGVjay0xLTIyNzk5NzM5JyBkYXRhLWNvZGU9J1BHUnBkaUJqYkdGemN6MGlZV2t0WVhSMGNtbGlkWFJsY3lJK0NqeHpjR0Z1SUdOc1lYTnpQU2RoYVMxamFHVmpheTFpYkc5amF5QmhhUzFqWm5BbklHUmhkR0V0WVdrdFlteHZZMnM5SnpFbklHUmhkR0V0WVdrdGJHbHRhWFF0YVcxd0xYQmxjaTEwYVcxbFBTYzFNQ2NnWkdGMFlTMWhhUzFzYVcxcGRDMXBiWEF0ZEdsdFpUMG5NU2NnWkdGMFlTMWhhUzFzYVcxcGRDMWpiR2xqYTNNdGNHVnlMWFJwYldVOUp6SW5JR1JoZEdFdFlXa3RiR2x0YVhRdFkyeHBZMnR6TFhScGJXVTlKekVuSUdSaGRHRXRZV2t0WjJ4dlltRnNMV3hwYldsMExXTnNhV05yY3kxd1pYSXRkR2x0WlQwbk1pY2daR0YwWVMxaGFTMW5iRzlpWVd3dGJHbHRhWFF0WTJ4cFkydHpMWFJwYldVOUp6RW5JR1JoZEdFdFlXa3RZMlp3TFhScGJXVTlKek13Sno0OEwzTndZVzQrQ2p3dlpHbDJQZ284YzJOeWFYQjBJR0Z6ZVc1aklITnlZejBpYUhSMGNITTZMeTl3WVdkbFlXUXlMbWR2YjJkc1pYTjVibVJwWTJGMGFXOXVMbU52YlM5d1lXZGxZV1F2YW5NdllXUnpZbmxuYjI5bmJHVXVhbk0vWTJ4cFpXNTBQV05oTFhCMVlpMHpPVEEzTWpZd05qSTRNVFV5T0RFNElnb2dJQ0FnSUdOeWIzTnpiM0pwWjJsdVBTSmhibTl1ZVcxdmRYTWlQand2YzJOeWFYQjBQZ284SVMwdElHNWxkeklnTFMwK0NqeHBibk1nWTJ4aGMzTTlJbUZrYzJKNVoyOXZaMnhsSWdvZ0lDQWdJSE4wZVd4bFBTSmthWE53YkdGNU9tSnNiMk5ySWdvZ0lDQWdJR1JoZEdFdFlXUXRZMnhwWlc1MFBTSmpZUzF3ZFdJdE16a3dOekkyTURZeU9ERTFNamd4T0NJS0lDQWdJQ0JrWVhSaExXRmtMWE5zYjNROUlqYzJNVFUyTlRFeE9Ua2lDaUFnSUNBZ1pHRjBZUzFoWkMxbWIzSnRZWFE5SW1GMWRHOGlDaUFnSUNBZ1pHRjBZUzFtZFd4c0xYZHBaSFJvTFhKbGMzQnZibk5wZG1VOUluUnlkV1VpUGp3dmFXNXpQZ284YzJOeWFYQjBQZ29nSUNBZ0lDaGhaSE5pZVdkdmIyZHNaU0E5SUhkcGJtUnZkeTVoWkhOaWVXZHZiMmRzWlNCOGZDQmJYU2t1Y0hWemFDaDdmU2s3Q2p3dmMyTnlhWEIwUGc9PScgZGF0YS1mYWxsYmFjay1jb2RlPSdQR1JwZGlCamJHRnpjejBuWVdrdFlXUmlMWE5vYjNjbklITjBlV3hsUFNkMmFYTnBZbWxzYVhSNU9pQm9hV1JrWlc0N0lHUnBjM0JzWVhrNklHNXZibVU3SnlCa1lYUmhMV0ZwTFhSeVlXTnJhVzVuUFNkWGVrVXlURVJCYzBsclNuTmlNazV5U1VSRk1rbHBkMmxKYVhkM1dGRTlQU2NnWkdGMFlTMWhhUzFrWldKMVp6MG5NVFluUGdvOEwyUnBkajRLJyBsaW1pdHMtZmFsbGJhY2s9JzE2JyBmYWxsYmFja19sZXZlbD0nMScgZmFsbGJhY2stdHJhY2tpbmc9J1d6QXNNQ3dpUW14dlkyc2dNVFlpTENJaVhRPT0nIGRhdGEtYmxvY2s9JzEnPjxzcGFuIGNsYXNzPSdhaS1jaGVjay1ibG9jayBhaS1jZnAnIGRhdGEtYWktYmxvY2s9JzEnIGRhdGEtYWktbGltaXQtaW1wLXBlci10aW1lPSc1MCcgZGF0YS1haS1saW1pdC1pbXAtdGltZT0nMScgZGF0YS1haS1saW1pdC1jbGlja3MtcGVyLXRpbWU9JzInIGRhdGEtYWktbGltaXQtY2xpY2tzLXRpbWU9JzEnIGRhdGEtYWktZ2xvYmFsLWxpbWl0LWNsaWNrcy1wZXItdGltZT0nMicgZGF0YS1haS1nbG9iYWwtbGltaXQtY2xpY2tzLXRpbWU9JzEnIGRhdGEtYWktY2ZwLXRpbWU9JzMwJz48L3NwYW4+PC9kaXY+CjwhLS0gQUlfSlMgLS0+PHNjcmlwdD4KICBhaV9ydW5fNzg2NzQ3NDcxNDMzID0gZnVuY3Rpb24oKXsvKiBBSV9KUyAqL2FpX2NoZWNrX2FuZF9pbnNlcnRfYmxvY2sgKDEsICdhaS1jaGVjay0xLTIyNzk5NzM5Jyk7LyogQUlfSlMgKi99OwogIGlmIChkb2N1bWVudC5yZWFkeVN0YXRlID09PSAnY29tcGxldGUnIHx8IChkb2N1bWVudC5yZWFkeVN0YXRlICE9PSAnbG9hZGluZycgJiYgIWRvY3VtZW50LmRvY3VtZW50RWxlbWVudC5kb1Njcm9sbCkpIGFpX3J1bl83ODY3NDc0NzE0MzMgKCk7IGVsc2UgZG9jdW1lbnQuYWRkRXZlbnRMaXN0ZW5lciAoJ0RPTUNvbnRlbnRMb2FkZWQnLCBhaV9ydW5fNzg2NzQ3NDcxNDMzKTsKPC9zY3JpcHQ+PCEtLSBBSV9KUyAtLT4K" data-class="Y29kZS1ibG9jaw=="</div
</div

<div class="clear"</div