OpenClaw Gateway Manager

IT 运维与安全

统一多云管理工具，用于在 macOS 上检测、配置、重启、验证、创建以及安全删除所有 OpenClaw 网关实例。

服务器运维配置生成

486

下载量

安装量

收藏量

★ 5.0

综合评分ⓘ

概述

更多信息

OpenClaw Gateway Manager#

🦞 统一管理多云 OpenClaw 网关实例 / Unified Multi-Cloud OpenClaw Gateway Manager

🌍 语言 Languages#

🇨🇳 中文文档
🇺🇸 English Documentation

中文文档#

💡 设计理念#

问题： 用户可能在多平台、多云端部署了多个 OpenClaw 实例（本地、JVS Claw、QClaw、云端等），但缺乏统一管理工具。

解决方案： 本技能通过自动检测不同配置文件路径，统一管理所有 OpenClaw 变种实例，无论它们部署在哪里。

核心思想：

🔍 自动发现 - 扫描所有可能的配置路径
🎯 统一接口 - 一套命令管理所有实例
☁️ 多云支持 - 本地、云端、多厂商发行版
🛡️ 安全管理 - 三重确认 + 自动备份

✨ 功能#

🔍 智能查询 - 自动检测所有 OpenClaw 实例（本地/JVS/QClaw/云端）
✏️ 修改端口 - 自动修改配置文件 + LaunchAgent plist
🔄 重启网关 - 安全重启指定网关或所有网关
✅ 验证配置 - 检查配置一致性、端口监听状态
➕ 创建新实例 - 一键创建新网关实例
🗑️ 安全删除 - 三重确认 + 自动备份
📡 端口扫描 - 智能识别所有实例

🎯 支持的发行版 Supported Distributions#

发行版配置目录默认端口开发者状态OpenClaw (原始版)~/.openclaw/18789OpenClaw 社区✅JVS Claw (阿里云)~/.jvs/.openclaw/18789阿里云无影✅QClaw (腾讯)~/.qclaw/28789腾讯✅云端 Claw~/.claw-cloud/自定义云服务🔜自定义实例~/.openclaw-<name>/自定义用户✅

识别原理： 通过检测不同的配置文件路径来区分不同发行版。

🚀 快速开始#

安装#

bash

git clone https://github.com/seastaradmin/openclaw-gateway-manager.git ~/.jvs/.openclaw/skills/gateway-manager

使用#

bash

# 查看所有网关状态（自动检测所有实例）
~/.jvs/.openclaw/skills/gateway-manager/scripts/gateway-status.sh

# 检查依赖
~/.jvs/.openclaw/skills/gateway-manager/scripts/check-dependencies.sh

# 扫描端口
~/.jvs/.openclaw/skills/gateway-manager/scripts/gateway-scan-ports.sh

# 修改端口
~/.jvs/.openclaw/skills/gateway-manager/scripts/gateway-set-port.sh 本地虾 18888

# 重启所有网关
~/.jvs/.openclaw/skills/gateway-manager/scripts/gateway-restart.sh all

# 验证配置
~/.jvs/.openclaw/skills/gateway-manager/scripts/gateway-verify.sh 本地虾

# 创建新实例
~/.jvs/.openclaw/skills/gateway-manager/scripts/gateway-create.sh test-bot 18899 openim

# 删除实例（三重确认）
~/.jvs/.openclaw/skills/gateway-manager/scripts/gateway-delete.sh test-bot

📊 示例输出#

text

=== OpenClaw Gateway 实例 ===

🔹 本地虾 (JVS Claw)
   主端口：18789
   辅助端口：18791(浏览器) 18792(Canvas)
   配置：~/.jvs/.openclaw
   状态：✅ 运行中 (PID: 6512)
   频道：openim
   Dashboard: http://127.0.0.1:18789/

🔹 飞书机器人
   主端口：18790
   辅助端口：18792(浏览器) 18793(Canvas)
   配置：~/.openclaw
   状态：✅ 运行中 (PID: 76822)
   频道：feishu
   Dashboard: http://127.0.0.1:18790/

🔹 QClaw (腾讯)
   主端口：28789
   辅助端口：28791(浏览器) 28792(Canvas)
   配置：~/.qclaw
   状态：✅ 运行中 (PID: 87107)
   频道：wechat-access
   Dashboard: http://127.0.0.1:28789/

🛡️ 安全特性#

删除操作三重确认 - 防止误删
自动备份 - 删除前备份到 ~/.openclaw-deleted-backups/
端口检查 - 修改前检查端口是否被占用
配置验证 - 修改后自动验证
依赖检查 - 安装时自动检查系统依赖

📦 脚本列表#

脚本功能危险等级gateway-status.sh查询所有实例状态🟢 安全gateway-scan-ports.sh端口扫描🟢 安全gateway-set-port.sh修改端口🟡 中等gateway-restart.sh重启网关🟢 安全gateway-verify.sh验证配置🟢 安全gateway-create.sh创建实例🟡 中等gateway-delete.sh删除实例🔴 危险check-dependencies.sh依赖检查🟢 安全

⚙️ 系统要求#

操作系统#

✅ macOS (必需)
❌ Windows / Linux (不支持)

原因：使用 macOS 特有的 LaunchAgent、launchctl 和 plutil。

依赖项#

运行以下命令检查依赖：

bash

~/.jvs/.openclaw/skills/gateway-manager/scripts/check-dependencies.sh

必需工具：

工具用途安装命令jqJSON 处理brew install jq``lsof端口检查macOS 自带plutilplist 编辑macOS 自带launchctlLaunchAgent 管理macOS 自带curlHTTP 请求macOS 自带nodeOpenClaw 运行brew install node

⚠️ 安全说明#

删除操作#

✅ 三重确认 - 需要 3 次确认才能执行删除
✅ 自动备份 - 删除前备份到 ~/.openclaw-deleted-backups/
⚠️ 破坏性操作 - 使用 rm -rf 删除配置目录

建议： 首次使用前手动备份重要数据

路径安全#

✅ 已修复 - 所有路径使用 $HOME 而非硬编码用户路径

LaunchAgent 权限#

仅创建用户级 LaunchAgent（ ~/Library/LaunchAgents/）
不需要系统级权限或 sudo
每个用户独立管理

English Documentation#

💡 Philosophy#

Problem: Users may deploy multiple OpenClaw instances across different platforms and clouds (local, JVS Claw, QClaw, cloud, etc.), but lack a unified management tool.

Solution: This skill automatically detects different configuration paths and统一管理 all OpenClaw variants, regardless of where they're deployed.

Core Principles:

🔍 Auto-Discovery - Scan all possible configuration paths
🎯 Unified Interface - One set of commands for all instances
☁️ Multi-Cloud - Local, cloud, multi-vendor distributions
🛡️ Safe Management - Triple confirmation + automatic backup

✨ Features#

🔍 Smart Status Query - Auto-detect all OpenClaw instances
✏️ Modify Ports - Automatically update config files + LaunchAgent plist
🔄 Restart Gateways - Safely restart specific or all gateways
✅ Verify Configuration - Check config consistency and port status
➕ Create Instances - One-click creation with LaunchAgent setup
🗑️ Safe Deletion - Triple confirmation + automatic backup
📡 Port Scanning - Intelligently identify all instances

🎯 Supported Distributions#

DistributionConfig DirectoryDefault PortDeveloperStatusOpenClaw (Original)~/.openclaw/18789OpenClaw Community✅JVS Claw (Alibaba)~/.jvs/.openclaw/18789Alibaba Cloud Wuying✅QClaw (Tencent)~/.qclaw/28789Tencent✅Cloud Claw~/.claw-cloud/CustomCloud Service🔜Custom Instance~/.openclaw-<name>/CustomUser✅

Identification: Different distributions are identified by their configuration file paths.

🚀 Quick Start#

Installation#

bash

git clone https://github.com/seastaradmin/openclaw-gateway-manager.git ~/.jvs/.openclaw/skills/gateway-manager

Usage#

bash

# Check all gateway status (auto-detect all instances)
~/.jvs/.openclaw/skills/gateway-manager/scripts/gateway-status.sh

# Check dependencies
~/.jvs/.openclaw/skills/gateway-manager/scripts/check-dependencies.sh

# Scan ports
~/.jvs/.openclaw/skills/gateway-manager/scripts/gateway-scan-ports.sh

# Modify port
~/.jvs/.openclaw/skills/gateway-manager/scripts/gateway-set-port.sh local-shrimp 18888

# Restart all gateways
~/.jvs/.openclaw/skills/gateway-manager/scripts/gateway-restart.sh all

# Verify config
~/.jvs/.openclaw/skills/gateway-manager/scripts/gateway-verify.sh local-shrimp

# Create new instance
~/.jvs/.openclaw/skills/gateway-manager/scripts/gateway-create.sh test-bot 18899 openim

# Delete instance (triple confirmation)
~/.jvs/.openclaw/skills/gateway-manager/scripts/gateway-delete.sh test-bot

📝 Example Output#

text

=== OpenClaw Gateway Instances ===

🔹 Local Shrimp (JVS Claw)
   Main Port: 18789
   Aux Ports: 18791(Browser) 18792(Canvas)
   Config: ~/.jvs/.openclaw
   Status: ✅ Running (PID: 6512)
   Channel: openim
   Dashboard: http://127.0.0.1:18789/

🔹 Feishu Bot
   Main Port: 18790
   Aux Ports: 18792(Browser) 18793(Canvas)
   Config: ~/.openclaw
   Status: ✅ Running (PID: 76822)
   Channel: feishu
   Dashboard: http://127.0.0.1:18790/

🔹 QClaw (Tencent)
   Main Port: 28789
   Aux Ports: 28791(Browser) 28792(Canvas)
   Config: ~/.qclaw
   Status: ✅ Running (PID: 87107)
   Channel: wechat-access
   Dashboard: http://127.0.0.1:28789/

🛡️ Safety Features#

Triple confirmation for deletion - Prevents accidental deletion
Automatic backup - Backs up before deletion
Port availability check - Verifies port is free
Configuration validation - Auto-verifies after changes
Dependency checker - Auto-checks system dependencies

⚙️ System Requirements#

Operating System#

✅ macOS (Required)
❌ Windows / Linux (Not supported)

Reason: Uses macOS-specific LaunchAgent, launchctl, and plutil.

Dependencies#

Run to check dependencies:

bash

~/.jvs/.openclaw/skills/gateway-manager/scripts/check-dependencies.sh

Required Tools:

ToolPurposeInstall CommandjqJSON processingbrew install jq``lsofPort checkBuilt-in macOSplutilplist editingBuilt-in macOSlaunchctlLaunchAgent managementBuilt-in macOScurlHTTP requestsBuilt-in macOSnodeOpenClaw runtimebrew install node

⚠️ Safety Notes#

Deletion Operation#

✅ Triple confirmation - Requires 3 confirmations
✅ Automatic backup - Backs up to ~/.openclaw-deleted-backups/
⚠️ Destructive - Uses rm -rf to delete config directories

Recommendation: Manually backup important data before first use

Path Security#

✅ Fixed - All paths use $HOME instead of hardcoded user paths

LaunchAgent Permissions#

Creates user-level LaunchAgent only ( ~/Library/LaunchAgents/)
No system-level permissions or sudo required
Each user managed independently

📄 License 许可证#

MIT License

🔗 Links 链接#

GitHub: https://github.com/seastaradmin/openclaw-gateway-manager
Author: @seastaradmin
Version: 1.0.1

🌍 跨平台支持 Cross-Platform Support#

支持的操作系统#

系统服务管理配置路径状态macOSLaunchAgent (用户级)~/.openclaw/, ~/.jvs/.openclaw/, ~/.qclaw/✅Linuxsystemd user service~/.openclaw/, ~/.config/openclaw/, /opt/openclaw/🔜Windows手动/可选服务%USERPROFILE%/.openclaw/, %APPDATA%/openclaw/🔜

自动检测#

脚本会自动检测操作系统并使用相应的服务管理方式：

bash

# macOS
launchctl load ~/Library/LaunchAgents/ai.openclaw.gateway.plist

# Linux
systemctl --user start openclaw-gateway

# Windows
# 不自动创建服务，用户手动选择

路径规范#

macOS/Linux: 使用 $HOME 环境变量
Windows: 使用 %USERPROFILE% 和 %APPDATA%
✅ 无硬编码路径，支持多用户

🔒 安全审查响应 Security Review Response#

指令范围 Instruction Scope#

审查意见：

Scripts read/write user files, create LaunchAgent plists, scan ports, and perform rm -rf.

回应： ✅ 这是预期行为 - 作为网关管理器，这些操作是必要的。

安全措施：

✅ 三重确认机制
✅ 自动备份到 ~/.openclaw-deleted-backups/
✅ 仅创建用户级服务（无需 sudo）
✅ 透明配置（plist 文件可审查）
✅ 完整文档（SKILL.md + SECURITY_RESPONSE.md）

持久性和权限 Persistence & Privilege#

审查意见：

Creates LaunchAgent plists for persistent execution.

回应： ✅ 这是必要功能 - 网关需要开机自启。

安全特性：

✅ 仅用户级服务 ( ~/Library/LaunchAgents/)
✅ 不需要系统权限
✅ 可以随时卸载
✅ 跨平台支持（Linux systemd, Windows 可选）

破坏性操作 Destructive Operations#

审查意见：

Performs irreversible deletes.

回应： ✅ 已实施多层保护：

三重确认 - 需要 3 次确认
自动备份 - 删除前备份
进程检查 - 停止进程后删除
文档警告 - 明确说明风险

查看安全响应全文：

bash

cat ~/.jvs/.openclaw/skills/gateway-manager/SECURITY_RESPONSE.md

English Documentation (Continued)#

🌍 Cross-Platform Support#

Supported Operating Systems#

OSService ManagementConfig PathsStatusmacOSLaunchAgent (user-level)~/.openclaw/, ~/.jvs/.openclaw/, ~/.qclaw/✅Linuxsystemd user service~/.openclaw/, ~/.config/openclaw/, /opt/openclaw/🔜WindowsManual/Optional service%USERPROFILE%/.openclaw/, %APPDATA%/openclaw/🔜

Auto-Detection#

Scripts automatically detect the OS and use appropriate service management:

bash

# macOS
launchctl load ~/Library/LaunchAgents/ai.openclaw.gateway.plist

# Linux
systemctl --user start openclaw-gateway

# Windows
# No automatic service creation, user chooses manually

Path Conventions#

macOS/Linux: Uses $HOME environment variable
Windows: Uses %USERPROFILE% and %APPDATA%
✅ No hardcoded paths, multi-user support

🔒 Security Review Response#

Instruction Scope#

Review Feedback:

Scripts read/write user files, create LaunchAgent plists, scan ports, and perform rm -rf.

Response: ✅ This is intended behavior - These operations are necessary for a gateway manager.

Safety Measures:

✅ Triple confirmation mechanism
✅ Automatic backup to ~/.openclaw-deleted-backups/
✅ User-level services only (no sudo required)
✅ Transparent configuration (plist files auditable)
✅ Complete documentation (SKILL.md + SECURITY_RESPONSE.md)

Persistence & Privilege#

Review Feedback:

Creates LaunchAgent plists for persistent execution.

Response: ✅ This is necessary functionality - Gateways need to auto-start.

Safety Features:

✅ User-level services only ( ~/Library/LaunchAgents/)
✅ No system-level permissions required
✅ Can be uninstalled anytime
✅ Cross-platform support (Linux systemd, Windows optional)

Destructive Operations#

Review Feedback:

Performs irreversible deletes.

Response: ✅ Multiple layers of protection implemented:

Triple confirmation - Requires 3 confirmations
Automatic backup - Backs up before deletion
Process check - Stops processes before deletion
Documentation warnings - Clearly states risks

View full security response:

bash

cat ~/.jvs/.openclaw/skills/gateway-manager/SECURITY_RESPONSE.md

设置和使用 1Password CLI (op)。适用于：安装 CLI、启用桌面应用集成、登录（单/多账户）、通过 op 读取/注入/运行密钥。

IT 运维与安全

★ 53↓ 3.2万3 个月前更新

备份与恢复 OpenClaw 数据。适用于创建备份、设置自动备份计划、从备份恢复或管理备份轮转。处理 ~/.openclaw 目录归档并包含适当的排除规则。

IT 运维与安全

★ 90↓ 3.1万3 个月前更新

MoltGuard — OpenClaw 安全守卫，由 OpenGuardrails 提供。安装 MoltGuard，保护您和您的用户免受提示注入、数据泄露和恶意攻击。

IT 运维与安全需 API Key

★ 116↓ 3.1万3 个月前更新

OpenClaw Gateway Manager

OpenClaw Gateway Manager#

🌍 语言 Languages#

中文文档#

💡 设计理念#

✨ 功能#

🎯 支持的发行版 Supported Distributions#

🚀 快速开始#

安装#

使用#

📊 示例输出#

🛡️ 安全特性#

📦 脚本列表#

⚙️ 系统要求#

操作系统#

依赖项#

⚠️ 安全说明#

删除操作#

路径安全#

LaunchAgent 权限#

English Documentation#

💡 Philosophy#

✨ Features#

🎯 Supported Distributions#

🚀 Quick Start#

Installation#

Usage#

📝 Example Output#

🛡️ Safety Features#

⚙️ System Requirements#

Operating System#

Dependencies#

⚠️ Safety Notes#

Deletion Operation#

Path Security#

LaunchAgent Permissions#

📄 License 许可证#

🔗 Links 链接#

🌍 跨平台支持 Cross-Platform Support#

支持的操作系统#

自动检测#

路径规范#

🔒 安全审查响应 Security Review Response#

指令范围 Instruction Scope#

持久性和权限 Persistence & Privilege#

破坏性操作 Destructive Operations#

English Documentation (Continued)#

🌍 Cross-Platform Support#

Supported Operating Systems#

Auto-Detection#

Path Conventions#

🔒 Security Review Response#

Instruction Scope#

Persistence & Privilege#

Destructive Operations#

相关推荐

1password

OpenClaw Backup

MoltGuard - Security & Antivirus & Guardrails

Tmux

Security Auditor

Skill Vetter - Pre-Install Security Review