← Back to Skills Marketplace
zaixi

Claw Stack Manager

by liyj · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
14
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install claw-stack-manager
Description
Manage the OpenClaw claw Docker stack via Portainer API. Supports pulling new image and redeploying (update) or fast restart without pulling. Trigger on: sta...
README (SKILL.md)

Claw Stack Manager

Manage the claw Docker stack via Portainer's HTTP API.

Modes

Mode What it does Transition
update Pull latest image, then trigger stack redeploy ~20s container transition
restart Quick redeploy without pulling ~20s container transition
pull-only Just pull the latest image No transition

Usage

# Update: pull new image + restart stack
python3 {{SKILL_DIR}}/scripts/manage.py --mode update

# Restart: just restart without pulling
python3 {{SKILL_DIR}}/scripts/manage.py --mode restart

# Pull: download latest image only
python3 {{SKILL_DIR}}/scripts/manage.py --mode pull-only

How it works

  1. Adds a unique REDEPLOY_TS env var to the stack's compose file
  2. Docker Compose detects the environment change and recreates the container
  3. Uses container_name: openclaw-gateway, so there is a brief transition (~20s)
  4. For --mode update, pulls the image first to minimize total downtime

Requirements

  • Portainer API access (set PORTAINER_API_KEY env)
  • PORTAINER_URL (default: http://docker.nas.liyj.cn:2082)
  • CLAW_STACK_ID (default: 89)
  • PORTAINER_ENDPOINT (default: 2)
  • CLAW_IMAGE (default: liyujiang/openclaw:latest)

All configurable via environment variables.

Usage Guidance
Review carefully before installing. Only use this if you own the target Portainer instance and intend to let the agent restart or update the OpenClaw stack. Set PORTAINER_URL explicitly to your HTTPS Portainer endpoint, confirm CLAW_STACK_ID and PORTAINER_ENDPOINT, use a limited API key, and prefer pinned Docker image versions for production updates.
Capability Analysis
Type: OpenClaw Skill Name: claw-stack-manager Version: 1.0.0 The skill is a utility for managing Docker stacks via the Portainer API, specifically designed to pull images and trigger redeploys. The Python script (scripts/manage.py) uses standard libraries to interact with the Portainer HTTP API using a user-provided API key. While it contains a hardcoded default URL (docker.nas.liyj.cn), there is no evidence of data exfiltration, malicious command execution, or intentional prompt injection.
Capability Tags
requires-sensitive-credentials
Capability Assessment
Purpose & Capability
The stated purpose matches the code, but the capability is high-impact: it can pull Docker images and redeploy/restart a Portainer-managed stack.
Instruction Scope
The script requires an explicit --mode, but there is no built-in confirmation, rollback, or target verification before mutating the stack configuration.
Install Mechanism
There is no installer and the Python source is included, but registry metadata does not declare the required Portainer API key/config even though the SKILL and code require it.
Credentials
The skill uses a Portainer API key and defaults PORTAINER_URL to http://docker.nas.liyj.cn:2082, meaning the key would be sent over plaintext HTTP to that host unless overridden.
Persistence & Privilege
There is no background persistence, but it persistently changes the Portainer stack file by adding REDEPLOY_TS and redeploying the stack, with no cleanup or rollback guidance.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install claw-stack-manager
  3. After installation, invoke the skill by name or use /claw-stack-manager
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release - manage OpenClaw stack via Portainer API
Metadata
Slug claw-stack-manager
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Claw Stack Manager?

Manage the OpenClaw claw Docker stack via Portainer API. Supports pulling new image and redeploying (update) or fast restart without pulling. Trigger on: sta... It is an AI Agent Skill for Claude Code / OpenClaw, with 14 downloads so far.

How do I install Claw Stack Manager?

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

Is Claw Stack Manager free?

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

Which platforms does Claw Stack Manager support?

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

Who created Claw Stack Manager?

It is built and maintained by liyj (@zaixi); the current version is v1.0.0.

💬 Comments