← Back to Skills Marketplace
gmoranxyz

Umbrel Proxy Manager

by G · GitHub ↗ · v1.0.3 · MIT-0
cross-platform ⚠ suspicious
117
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install umbrel-proxy
Description
Efficiently manage and interact with Umbrel proxy services for Docker containers. Automatically discovers running services, maps internal Docker IPs to acces...
Usage Guidance
This skill appears to do what it says, but review and exercise standard caution before running: 1) Inspect the scripts (they are bundled) — they call docker, openclaw, curl/requests and write umbrel_services.json/connectivity results. 2) Run discovery and use update scripts with --dry-run first (update_openclaw_config.py supports dry-run) to see planned changes. 3) Backup your OpenClaw config (~/.openclaw/openclaw.json or your system path) before allowing automatic updates. 4) Run as a local admin user; avoid running in environments where container names or the mapping JSON could be attacker-controlled (the scripts use shell execution and have limited input sanitization). 5) Ensure Docker and OpenClaw binaries are trusted and on your system PATH. If you want higher assurance, run the discovery scripts only, inspect umbrel_services.json, then run updates manually.
Capability Analysis
Type: OpenClaw Skill Name: umbrel-proxy Version: 1.0.3 The skill automates Umbrel and OpenClaw integration by discovering Docker containers and updating configurations. It exhibits high-risk behavior by executing shell commands via subprocess.run(shell=True) in discover_umbrel_services.py and update_openclaw_config.py, creating a shell injection vulnerability where container names or configuration values are used to construct commands. While the intent appears benign and aligned with the documentation, the combination of broad system access (Docker) and insecure coding practices warrants a suspicious classification.
Capability Assessment
Purpose & Capability
Name/description match the included scripts: discovery (docker ps/inspect), mapping proxy→localhost, connectivity tests (curl/requests), and OpenClaw config updates (openclaw CLI). No unrelated credentials, binaries, or external services are required.
Instruction Scope
SKILL.md and scripts instruct the agent to run local shell commands (docker, openclaw, curl/systemctl) and read/write local JSON files (umbrel_services.json, connectivity_results.json). This is appropriate for the stated goal, but the scripts run shell commands via subprocess with shell=True and perform CLI invocations without explicit input sanitization — acceptable for local admin use but worth reviewing before running in environments with untrusted container names or modified mapping files.
Install Mechanism
No install spec or remote downloads; the skill is instruction-only with bundled scripts. No archives or external installers are fetched, minimizing supply-chain risk.
Credentials
The skill declares no environment variables, no credentials, and no config paths beyond local skill files. It performs OpenClaw CLI operations (expected) and accesses Docker locally; requested access is proportional to the task.
Persistence & Privilege
always:false (not force-included). The skill does modify OpenClaw configuration via the openclaw CLI when run — this is within scope but is a persistent change to the user's OpenClaw config and may require a gateway restart to apply. Autonomous invocation is allowed by platform default; combine with user caution if you permit autonomous runs.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install umbrel-proxy
  3. After installation, invoke the skill by name or use /umbrel-proxy
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
Final privacy cleanup. Clarified that network addresses are standard Umbrel defaults, not personal information. Automatically discovers Umbrel Docker proxy services, maps internal IPs to accessible ports, and updates OpenClaw config.
v1.0.2
Fresh publication after privacy cleanup. Previous versions deleted to remove personal information. Automatically discovers Umbrel Docker proxy services, maps internal IPs to accessible ports, and updates OpenClaw config.
v1.0.1
Privacy update: Removed personal information from documentation. Changed specific IPs to patterns, removed personal paths, generalized examples.
v1.0.0
Initial release: Automatic Umbrel Docker proxy service discovery, mapping, and OpenClaw config synchronization. Solves Docker networking/IP mapping for Umbrel services.
Metadata
Slug umbrel-proxy
Version 1.0.3
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 4
Frequently Asked Questions

What is Umbrel Proxy Manager?

Efficiently manage and interact with Umbrel proxy services for Docker containers. Automatically discovers running services, maps internal Docker IPs to acces... It is an AI Agent Skill for Claude Code / OpenClaw, with 117 downloads so far.

How do I install Umbrel Proxy Manager?

Run "/install umbrel-proxy" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Umbrel Proxy Manager free?

Yes, Umbrel Proxy Manager is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Umbrel Proxy Manager support?

Umbrel Proxy Manager is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Umbrel Proxy Manager?

It is built and maintained by G (@gmoranxyz); the current version is v1.0.3.

💬 Comments