← 返回 Skills 市场
umag

swamp

作者 Magistr · GitHub ↗ · v0.2.0
cross-platform ⚠ suspicious
637
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install swamp
功能描述
Model any API with Swamp, test it, and enrich *Claw with new capabilities — full lifecycle from idea to working integration
安全使用建议
This skill largely does what it says (it documents how to use the 'swamp' CLI to model APIs and export models into new *Claw skills), but there are a few things to check before installing or running it: - Verify the 'swamp' binary: ensure it comes from a trusted source (e.g., the official GitHub repo mentioned) and is the version you expect. The skill requires that binary to exist on PATH. - Review .claude/settings.local.json: the file that ships with the skill only whitelists a few swamp subcommands but the SKILL.md expects broad use of many commands. Confirm what commands your agent will actually be allowed to run and reconcile any permission gaps. - Be cautious with authentication flows: 'swamp auth login' may open a browser or accept username/password flags. Avoid entering credentials into unfamiliar registries; prefer browser/OAuth flows and verify the SWAMP_CLUB_URL before logging in. - Audit generated artifacts: the workflow explicitly instructs exporting models and generating SKILL.md (new skills) and pushing/pulling extensions. Always review any generated SKILL.md, extension manifest, or packaged extension before installing or publishing — these artifacts can add new capabilities to your agent. - Use least privilege and sandboxing: run initial experiments in a sandboxed environment or VM, and avoid granting broad system access or persistent install rights until you have validated the tool and its outputs. If you want a stronger conclusion, provide the actual 'swamp' binary source (checksums or install instructions) and the agent's runtime permission policy so I can re-evaluate the whitelist/permission mismatch and the potential blast radius of auto-published extensions.
功能分析
Type: OpenClaw Skill Name: swamp Version: 0.2.0 The skill is classified as suspicious due to the broad capabilities granted to the AI agent, specifically the ability to interact with a remote extension registry. While the `.claude/settings.local.json` file restricts the agent to only `swamp auth` and `swamp extension` commands, these still pose significant risks. `swamp auth login` allows network communication for authentication, potentially exposing credentials if misused. More critically, `swamp extension pull` enables the agent to download arbitrary content from a remote server, and `swamp extension push` allows the agent to publish content to a public registry, creating a direct supply chain attack vector if the agent is prompted to upload malicious extensions. The `SKILL.md` also describes highly privileged operations like executing arbitrary shell commands via `swamp model method run` and publishing new skills to ClawHub, which are not currently permitted but highlight the inherent power and potential for misuse of the underlying `swamp` tool.
能力评估
Purpose & Capability
Name/description match the instructions: the SKILL.md is a CLI-focused guide for modeling APIs with the 'swamp' binary and converting models into *Claw skills. Requiring the 'swamp' binary is expected. However, the included .claude/settings.local.json only whitelists a small subset of swamp commands (swamp --version, swamp auth:*, swamp extension:*), while the instructions expect broad use of many other swamp commands (model create/edit/validate/method run, workflow run, data commands). That mismatch is an incoherence to be aware of.
Instruction Scope
The SKILL.md contains many commands that create, edit, test, and publish models and extensions—and explicitly describes exporting Swamp models to generate new SKILL.md files and pushing extensions to a registry. Generating and publishing new agent skills/extensions is powerful (it can expand an agent's capabilities and add new code/files). This is coherent with the stated purpose but increases the security surface; it requires careful auditing of any generated SKILL.md or extension before enabling or publishing. Additionally, the whitelist in .claude/settings.local.json does not include many of the model/workflow commands the instructions expect to run, creating an operational inconsistency.
Install Mechanism
This is an instruction-only skill with no install spec or code files. That is low-risk from an installation standpoint — nothing will be downloaded or written by the skill itself during install.
Credentials
The skill declares no required environment variables or credentials. The SKILL.md mentions optional env vars (SWAMP_CLUB_URL) and referencing secrets via Swamp's vault (vault.get), which is consistent with the tool's expected behavior and does not demand unrelated credentials from the user.
Persistence & Privilege
The skill is not always-enabled and uses the platform-default ability to be invoked autonomously. The real privilege risk comes from the documented ability to generate and publish new *Claw skills/extensions: if an agent is permitted to create and auto-install such artifacts, its capabilities can be extended. The skill itself does not declare persistent system-wide changes, but follow-up actions (publishing/pulling extensions, writing SKILL.md files) could alter agent behavior if allowed.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install swamp
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /swamp 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v0.2.0
Swamp 0.2.0 introduces extension management and swamp-club authentication: - Added step-by-step documentation for authenticating with swamp-club, including login, custom servers, and headless flows. - Introduced new sections on pulling, pushing, listing, and removing Swamp extensions. - Outlined the extension workflow for sharing custom model types via the registry. - Provided guidance on using both models (skills) and extensions for richer sharing and collaboration. - No changes to agent usage or core modeling/test workflows.
v0.1.0
Initial release of Swamp skill for API modeling and *Claw integration - Introduces Swamp CLI-based workflow for API modeling, testing, and turning models into reusable *Claw capabilities. - Documents step-by-step processes: repo setup, model creation/editing, validation, testing, and workflow orchestration. - Details secure credential storage via Swamp vaults and integration as *Claw skills. - Provides usage examples: modeling REST/weather APIs, chaining workflows, exporting as skills. - Includes important guidance on security, troubleshooting flags, and local operation boundaries.
元数据
Slug swamp
版本 0.2.0
许可证
累计安装 0
当前安装数 0
历史版本数 2
常见问题

swamp 是什么?

Model any API with Swamp, test it, and enrich *Claw with new capabilities — full lifecycle from idea to working integration. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 637 次。

如何安装 swamp?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install swamp」即可一键安装,无需额外配置。

swamp 是免费的吗?

是的,swamp 完全免费(开源免费),可自由下载、安装和使用。

swamp 支持哪些平台?

swamp 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 swamp?

由 Magistr(@umag)开发并维护,当前版本 v0.2.0。

💬 留言讨论