← Back to Skills Marketplace
Openclaw Gateway Manager
by
seastaradmin
· GitHub ↗
· v1.0.3
· MIT-0
121
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install openclaw-gateway-manager
Description
Manage OpenClaw gateways: query status, modify ports, restart, verify configs, create, delete instances with backups and port scanning.
Usage Guidance
This package appears coherent for a gateway manager, but it performs destructive and persistent operations — review before use. Specific recommendations:
- Inspect scripts (especially gateway-delete.sh and create_service_file in common.sh) before running; deletion uses rm -rf even though backups are taken.
- Verify the service file content (LaunchAgent plist / systemd unit). Note the LaunchAgent launches node -e with a JS snippet that spawns openclaw; confirm this behavior and that it doesn't embed unexpected network endpoints.
- Ensure openclaw and node binaries invoked are the expected, trusted binaries on your system (check PATH and /usr/local/bin, etc.).
- Understand backups are stored under $HOME/.openclaw-deleted-backups/ and verify retention and restore procedure before deleting production data.
- Run first in a test account/environment and use the --dry-run / inspect pattern advised by the repo (or add your own dry-run) to confirm actions.
- Be aware user-level services will run persistently under your account and will inherit user environment variables; avoid running with sensitive credentials in your environment if you are concerned about process-level exposure.
If you cannot inspect the code yourself, do not grant it automatic execution in sensitive environments; run it manually in a controlled test environment first.
Capability Analysis
Type: OpenClaw Skill
Name: openclaw-gateway-manager
Version: 1.0.3
The bundle provides a management utility for OpenClaw gateways with capabilities for persistence and destructive file operations. Key scripts like `gateway-create.sh` and `gateway-delete.sh` create user-level services (macOS LaunchAgents and Linux systemd) and use `rm -rf` on configuration directories. Although mitigations like triple-confirmation and backups are implemented, the scripts lack input sanitization for instance names used in path construction (e.g., in `common.sh`), which could allow path traversal. These high-risk functions, combined with the instructions in `SKILL.md` for an AI agent to execute them, pose a potential risk if the agent is subjected to prompt injection.
Capability Assessment
Purpose & Capability
Name/description (manage gateways: status, ports, restart, create/delete, port-scan) align with the provided scripts and docs. The scripts operate on OpenClaw configuration directories under $HOME, create user-level service files, start/stop gateway processes, scan ports, and perform backups — all expected for a gateway manager.
Instruction Scope
SKILL.md instructs the agent to run the bundled shell scripts which read and write files under $HOME, create LaunchAgent/systemd user service files, run openclaw via node, scan local ports, and perform rm -rf deletions. Those actions are within the claimed scope but are destructive (deletes, process control) so the user impact is high and the docs correctly surface the risks and confirmation steps.
Install Mechanism
No install spec is provided (instruction-only from runtime perspective) and code is included as plain shell scripts. Nothing is downloaded from arbitrary URLs or installed automatically — lowest-risk install posture given included code, but user should inspect scripts before running.
Credentials
The skill requests no environment variables or external credentials. It does create service files that run Node and spawn openclaw, and those services may inherit user environment variables at runtime. This is expected for a user-level service manager but means any sensitive env vars present in the user's account could be visible to the launched processes — not a flaw of the skill but an operational consideration.
Persistence & Privilege
Scripts create persistent, user-level services (~/Library/LaunchAgents/ and ~/.config/systemd/user/). The skill does not request system (sudo) privileges and documents that it only creates user-level services. Persistent execution is necessary for its purpose but increases blast radius if misused — the skill includes explicit warnings, backups, and an uninstall/delete flow.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install openclaw-gateway-manager - After installation, invoke the skill by name or use
/openclaw-gateway-manager - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
[1.0.2] - 2026-03-23
### Added
- Added a Chinese project README.
- Added `scripts/common.sh` to centralize OS detection, instance resolution, port lookup, and service control helpers.
- Added `SECURITY_RESPONSE.md`.
### Changed
- Clarified installation guidance: normal installation should use the skill system/runtime chosen location; manual cloning is only for local development or debugging.
- Updated `README.md`, `README.en.md`, `SKILL.md`, `README_发布指南.md`, and `ClawHub_上传说明.txt` to distinguish repository location from OpenClaw instance config directories.
- Updated package and metadata versions to `1.0.2`.
- Expanded platform support docs to match current behavior on macOS, Linux, and Windows manual mode.
### Fixed
- Fixed hardcoded installation examples that incorrectly suggested using `~/.jvs/.openclaw/...` as the repository location.
- Fixed script executability by ensuring shell scripts are runnable.
- Fixed macOS Bash 3 compatibility issues in the port scan flow.
- Unified service handling for macOS `LaunchAgent`, Linux `systemd --user`, and manual fallback mode.
v1.0.2
✅ 硬编码 /Users/ping → $HOME
✅ 修正安装目录文档
✅ 增加跨平台公共脚本层
✅ 支持 Linux 用户级服务
✅ 新增中文 README
✅ 元数据与文档版本统一
v1.0.1
✅ 硬编码 /Users/ping → $HOME
✅ 添加 macOS 平台声明
✅ 创建 check-dependencies.sh
✅ 添加 clawhub.json warnings
✅ Node 路径动态检测
✅ SKILL.md 安全说明章节
v0.1.0
- Initial release of openclaw-gateway-manager (v0.1.0)
- Manage OpenClaw gateway instances: query status, modify ports, restart, verify, create, and delete
- Includes smart port scanning, instance-specific commands, and safety checks (triple confirmation for deletions, backup before delete/modify)
- Supports one-click new instance creation and consistent config validation
- CLI scripts provided for each core operation with usage examples
Metadata
Frequently Asked Questions
What is Openclaw Gateway Manager?
Manage OpenClaw gateways: query status, modify ports, restart, verify configs, create, delete instances with backups and port scanning. It is an AI Agent Skill for Claude Code / OpenClaw, with 121 downloads so far.
How do I install Openclaw Gateway Manager?
Run "/install openclaw-gateway-manager" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Openclaw Gateway Manager free?
Yes, Openclaw Gateway Manager is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Openclaw Gateway Manager support?
Openclaw Gateway Manager is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Openclaw Gateway Manager?
It is built and maintained by seastaradmin (@seastaradmin); the current version is v1.0.3.
More Skills