← 返回 Skills 市场
kevindagege

ZL-ClawPay

作者 zlpay · GitHub ↗ · v1.0.4 · MIT-0
cross-platform ⚠ suspicious
233
总下载
0
收藏
0
当前安装
5
版本数
在 OpenClaw 中安装
/install zl-clawpay
功能描述
Use when users need to query sub-wallet binding status, bind sub-wallet, generate QR code, check payment status, query balance or transaction history. Trigge...
安全使用建议
What to check before installing/using this skill: 1) Metadata mismatch: The report header shows no required env vars but SKILL.md/_meta.json require ZLPAY_APP_ID and GM key material — assume the skill needs those secrets. Do not pass keys until you audit the code. 2) Inspect config/.env: The package includes config/.env. Open it before installation; if it contains real keys or default credentials, remove or replace them. Never use credentials found inside a shipped .env without rotation. 3) Review Config for endpoints: Find scripts/zlpay_skill/config/config.py (or where SecureClient sets base URL). Confirm the backend host(s) the skill will contact. If endpoints point to unknown or external servers you don't control, treat it as high risk. 4) Local persistence: The code contains StateStore/Memory and logging with retention. If you need ephemeral operation, either run this skill in an isolated environment (container/VM) or modify the code/config to disable state/log retention or redirect to a secure path. 5) Confirm payment flow enforcement: SKILL.md requires explicit yes/no confirmation before payments. Verify the business methods actually enforce this (i.e., the CLI/library will not auto-execute payments when invoked by an agent). If the LLM can invoke the skill autonomously, ensure policy or operator approval is in place. 6) Secrets handling: The skill expects the client private key (sensitive). Prefer providing keys via secure secret manager or mounted files (paths) rather than embedding in environment on a shared machine. If you must put keys on disk, set strict filesystem permissions and consider hardware-backed keys. 7) Dependency review: The setup installs many third-party packages (cryptography, gmssl, sm-crypto). Verify you trust these package versions and consider using a vetted internal mirror or doing an SBOM/audit of dependencies. 8) Run in sandbox first: Execute the skill in an isolated environment, exercising non-sensitive operations (query binding, listing interfaces) and monitor network traffic to confirm it contacts only expected hosts and that no unexpected outbound data (e.g., entire .env contents) is transmitted. If you want, provide the contents of scripts/zlpay_skill/config/config.py and core/secure_client.py (or the base URL and where public keys are fetched) and I can do a more precise review of network endpoints and any code paths that may exfiltrate data.
功能分析
Type: OpenClaw Skill Name: zl-clawpay Version: 1.0.4 The ZL Claw Pay skill bundle is a professional payment integration tool for managing sub-wallets and generating QR codes. It implements robust security practices, including the use of SM2/SM4 cryptography for secure API communication, automatic sensitive data masking in logs (via `log_filter.py` and `secure_client.py`), and strict file permission management (0600) for its local state storage in `~/.zlpay/state.json`. The AI instructions in `SKILL.md` are defensive, explicitly requiring user confirmation for transactions and prohibiting the exposure of credentials. No indicators of malicious intent, data exfiltration, or unauthorized execution were found.
能力标签
cryptorequires-walletcan-make-purchasesrequires-oauth-token
能力评估
Purpose & Capability
The name/description (wallet/payment operations) aligns with the code: many modules implement SM2/SM4 (GM) crypto, HMAC signing, secure client, wallet/payment services and HTTP/local interfaces. Requesting an app id and client private key + server public key is reasonable for a payment SDK. However, registry summary at the top of the report said "Required env vars: none" while the skill's SKILL.md and _meta.json clearly require ZLPAY_APP_ID and GM key material — this metadata mismatch is an incoherence to be aware of.
Instruction Scope
SKILL.md instructs the LLM to call the local CLI wrapper (scripts/skill.py) and to consult local reference docs; that is consistent with included CLI code. But SKILL.md also claims a "stateless design" (each call spawns a new process) while the code contains a StateStore, SessionManager and Memory classes and has state retention and cleanup logic — the skill appears to persist wallet IDs/state to disk. The doc mandates never showing credentials, yet the code logs request/response info (with masking filters). The existence of log files, a configurable log directory and a state file means sensitive data could be persisted if masking or configuration is misused.
Install Mechanism
There is no remote 'download-and-extract' installer; an included setup.sh creates a venv and pip-installs pinned packages in requirements.txt. Packages are standard PyPI libraries (requests, gmssl, cryptography, qrcode, etc.) — this is expected for crypto and QR functionality. The install script itself does not fetch code from arbitrary hosts, but it will install many third-party packages (moderate-risk: supply-chain considerations).
Credentials
The required environment variables declared in SKILL.md and _meta.json (ZLPAY_APP_ID, ZLPAY_GM_CLIENT_PRIVATE_KEY or path, ZLPAY_GM_SERVER_PUBLIC_KEY or path) are appropriate for a crypto-based payment skill. However: (1) the top-level registry metadata in this report incorrectly shows no required env vars — a mismatch; (2) the package includes a config/.env file in the bundle (config/.env), which may contain secrets or default keys shipped with the skill — shipping credential files packaged with a skill is a security concern and not justified by normal usage. The skill also uses optional ZLPAY_API_KEY and other envs; ensure only necessary secrets are provided and that any shipped .env is inspected/removed.
Persistence & Privilege
SKILL.md's 'stateless' claim conflicts with code that instantiates StateStore/SessionManager and a Memory component and has log retention and state retention configuration. The skill will write logs and state files (log_dir, state_file_path) locally; it is not marked always:true, but it does persist data on disk. If you expect no local persistence, this is an inconsistency to address. Also, while logging uses a filter to mask secrets, masked data may still be partially recorded and retention/rotation must be reviewed.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install zl-clawpay
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /zl-clawpay 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.4
zl-clawpay 1.0.4 Changelog - Updated environment variable handling: `ZLPAY_API_KEY` marked as optional and now supports command line, interactive input, or request body. - Clarified API Key sourcing priority: command line > request body parameter > environment variable > memory. - No code or file changes detected; updates are documentation-only. - Improved documentation on credential management for API keys, including storage and display rules.
v1.0.3
zl-claw-pay v1.0.3 - Updated environment variable documentation to explicitly list required/optional variables, including ZLPAY_API_KEY. - Clarified API Key handling: now must be set via environment variable (not via chat/Memory system). - Detailed how sensitive information (API Key, Wallet ID) is retrieved, stored, and masked in chat. - Expanded security section to specify new configuration and storage requirements. - No code changes—documentation update only.
v1.0.2
- Lowered minimum Python version requirement from 3.10 to 3.6 in skill metadata. - Added a new configuration section detailing settings in `config/.env` and their usage. - Clarified API key handling: user provides key in chat, which is stored in OpenClaw Memory (not in config). - Noted that local files are stored in `~/.zlpay/` with user-only permissions. - No code changes; documentation only.
v1.0.1
- Removed two scripts-related files: requirements-test.txt and security_scan.sh. - SKILL.md rewritten and renamed to zl-claw-pay, with all documentation fully switched to English. - Reorganized and condensed documentation structure; removed Chinese explanatory sections. - Documentation for install/test/security scripts and prompts trimmed or removed. - No functional or code changes; documentation and cleanup update only.
v1.0.0
Initial release - Security-Payment skill for AI agents
元数据
Slug zl-clawpay
版本 1.0.4
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 5
常见问题

ZL-ClawPay 是什么?

Use when users need to query sub-wallet binding status, bind sub-wallet, generate QR code, check payment status, query balance or transaction history. Trigge... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 233 次。

如何安装 ZL-ClawPay?

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

ZL-ClawPay 是免费的吗?

是的,ZL-ClawPay 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

ZL-ClawPay 支持哪些平台?

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

谁开发了 ZL-ClawPay?

由 zlpay(@kevindagege)开发并维护,当前版本 v1.0.4。

💬 留言讨论