OpenClaw 的分布式集群功能

📝 前言：为什么需要技能同步？

在使用 OpenClaw 进行 AI 自动化开发时，你是否遇到过这些痛点？

• 本地开发的技能需要手动复制到云服务器
• 云服务器新增的技能无法自动同步到本地
• 多设备切换时技能库版本不一致导致运行异常

OpenClaw 的分布式集群功能完美解决了这些问题！通过 "网关 - 节点" 架构，实现云端与本地技能自动双向同步，让你随时随地在任何设备上开发和运行技能，无需手动干预，真正实现 "一处修改，处处生效"。

本文将以最简洁高效的方式，带你完成从环境准备到集群搭建的全过程，让你轻松掌握 OpenClaw 技能同步的核心技术。

🛠️ 前置条件（必做 2 条）

在开始搭建集群前，请确保完成以下准备工作，这是成功的基础：

1. 环境版本统一

本地电脑和云服务器都需安装最新版 OpenClaw，确保版本一致避免兼容性问题：

bash

运行

# 全局安装/更新OpenClaw（Windows/macOS/Linux通用） npm install -g openclaw

提示：安装过程中若出现npm warn deprecated node-domexception@1.0.0警告，无需担心，这只是依赖包的弃用提示，不影响 OpenClaw 正常使用。

2. 网络端口放行

云服务器安全组 / 防火墙必须放行18780 端口（TCP 协议），这是 OpenClaw 集群通信的默认端口：

• 阿里云 ECS：在 "安全组规则" 中添加入方向规则，端口范围 18780，授权对象 0.0.0.0/0
• 腾讯云 CVM：在 "防火墙" 中添加规则，协议 TCP，端口 18780，允许所有 IP 访问
• Linux 服务器：若开启了 ufw/iptables 防火墙，执行以下命令放行端口

  bash

  运行

  # ufw防火墙 sudo ufw allow 18780/tcp # iptables防火墙 sudo iptables -A INPUT -p tcp --dport 18780 -j ACCEPT

🚀 三步搭建分布式集群（核心操作）

🔧 步骤 1：云服务器启动集群网关（核心中枢）

云服务器作为集群的 "大脑"，需要启动网关服务，负责技能同步、权限管理和任务分发。

方式 1：测试用（前台运行，适合调试）

bash

运行

# 自动生成随机Token，启动网关并输出关键信息 TOKEN=$(openssl rand -hex 8) && echo "=== 你的网关Token: $TOKEN ===" && openclaw gateway start --host 0.0.0.0 --port 18780 --cluster enabled --gateway-token $TOKEN

方式 2：生产用（后台常驻，适合长期运行）

bash

运行

# 生成Token并后台启动网关，日志输出到文件 TOKEN=$(openssl rand -hex 8) && echo "=== 你的网关Token: $TOKEN ===" && nohup openclaw gateway start --host 0.0.0.0 --port 18780 --cluster enabled --gateway-token $TOKEN > openclaw-gateway.log 2>&1 &

关键操作：执行后请务必记录输出的 Token 和云服务器公网 IP，这是本地连接集群的凭证。

获取公网 IP 快捷命令：

bash

运行

# 云服务器执行，快速获取公网IP curl -s ifconfig.me

🔗 步骤 2：本地机器连接集群并开启同步

本地电脑作为集群的 "节点"，需要连接到云端网关并启用技能同步功能，只需一行命令即可完成：

bash

运行

# 替换【云服务器公网IP】和【步骤1生成的Token】 openclaw stop && openclaw node join --gateway ws://云服务器公网IP:18780 --token 你的Token --sync-skills && openclaw node start

命令解析：

1. openclaw stop：停止本地已运行的 OpenClaw 服务，避免端口冲突
2. openclaw node join：加入云端集群，指定网关地址、认证 Token 并启用技能同步
3. openclaw node start：启动本地节点服务，开始与云端同步技能

✅ 步骤 3：云端批准节点接入（安全验证）

为保障集群安全，本地节点加入请求需要云端手动批准：

1. 查看待批准的节点请求，获取requestId：

   bash

   运行

   openclaw nodes pending

   输出示例：

   plaintext

   [ { "requestId": "abcdef12-3456-7890-abcd-ef1234567890", "nodeName": "ToBe-PC", "ip": "123.123.123.123", "timestamp": "2026-04-06T15:30:00Z" } ]

2. 批准节点接入（替换为实际的requestId）：

   bash

   运行

   openclaw nodes approve abcdef12-3456-7890-abcd-ef1234567890

🔍 验证同步效果（1 秒确认）

完成上述步骤后，如何确认技能同步是否成功？只需在本地和云端分别执行以下命令，查看技能列表是否一致：

bash

运行

# 查看当前节点的技能列表 openclaw skill list

同步成功标志：本地和云端显示的技能名称、版本、描述完全一致，后续新增 / 修改 / 删除技能会自动双向同步，无需手动操作。

💡 日常使用指南：无需同时开机也能同步

很多用户会问："必须同时打开云端和本地才能同步吗？" 答案是NO！这正是分布式集群的优势所在：

表格

核心优势：云服务器作为集群中枢一直运行，本地电脑想开就开、想关就关，开机自动同步，完全符合日常使用习惯。

❌ 退出同步 vs 暂停同步（别搞混！）

很多用户对 "退出同步" 有误解，这里特别澄清两个概念：

1. 暂停同步（日常临时操作）

如果只是想临时断开连接，后续还需恢复同步，只需停止本地节点服务：

bash

运行

# 本地执行，暂停同步但保留集群配置 openclaw node stop

恢复同步时只需重新启动节点：

bash

运行

openclaw node start

2. 退出同步（彻底断开集群）

只有当你不再需要同步功能时，才执行以下命令彻底退出集群，恢复独立运行模式：

bash

运行

# 本地执行：停止节点服务，退出集群，恢复独立运行 openclaw node stop && openclaw start # 云端执行：停止网关服务（如需彻底关闭集群） pkill -f "openclaw gateway start"

🚨 常见问题与解决方案

表格

🎯 总结与进阶建议

通过本文的步骤，你已经成功搭建了 OpenClaw 分布式集群，实现了云服务器与本地技能的自动同步。这不仅提升了开发效率，还为多设备协同开发、远程部署提供了基础。

进阶优化建议：

1. Token 安全管理：生成的 Token 是集群的 "钥匙"，建议定期更换，避免泄露
2. 持久化运行：云服务器可使用systemd或pm2管理网关服务，实现开机自启

   bash

   运行

   # 使用pm2管理网关服务（推荐） npm install -g pm2 TOKEN=$(openssl rand -hex 8) pm2 start openclaw --name "openclaw-gateway" -- gateway start --host 0.0.0.0 --port 18780 --cluster enabled --gateway-token $TOKEN

3. 多节点扩展：可添加更多本地设备到集群，只需重复 "步骤 2 + 步骤 3"，实现多设备间技能同步

📚 后续学习方向

1. 技能权限管理：学习如何设置技能访问权限，实现不同节点的技能隔离与共享
2. 集群监控：使用 OpenClaw 内置命令监控集群状态：openclaw gateway status、openclaw nodes list
3. 高级同步策略：配置技能同步白名单 / 黑名单，只同步特定技能

🔚 结语

OpenClaw 的分布式集群功能是提升 AI 自动化开发效率的利器，通过本文的指南，你已经掌握了核心的搭建方法。记住，集群搭建的关键在于版本统一、端口放行、安全认证这三个核心要点，只要遵循步骤操作，就能轻松实现技能自动同步。

希望本文对你有所帮助，如果你在实践过程中遇到任何问题，欢迎在评论区留言讨论，一起探索 OpenClaw 的无限可能！