← 返回 Skills 市场
Proxy Gateway X402
作者
kehongpeng
· GitHub ↗
· v0.1.6
· MIT-0
130
总下载
0
收藏
1
当前安装
7
版本数
在 OpenClaw 中安装
/install proxy-gateway-x402
功能描述
Proxy Gateway X402 enables unrestricted pay-per-use internet access via the x402 protocol with direct USDC payments on Base L2, requiring no custody or KYC.
安全使用建议
Key things to consider before installing or using this skill:
- Metadata vs. reality: the registry metadata claims no env vars and 'instruction-only', yet the package contains a full server implementation that expects multiple environment variables (DEVELOPER_WALLET, ADMIN_TOKEN, RPC_URL, REDIS settings) and the SKILL.md asks you to set USER_EVM_PRIVATE_KEY for auto-pay. Ask the publisher to clarify required configuration and why metadata omits these.
- Do NOT put your main private key in an environment variable: the skill explicitly instructs to set USER_EVM_PRIVATE_KEY to enable auto-pay. This gives code direct ability to sign and send transactions. If you decide to use auto-pay, only use a dedicated wallet with minimal funds, or better: avoid auto-pay and use manual payments. Prefer hardware wallet or signing through a separate, secure signing service rather than exporting a raw private key to the environment.
- Hosted endpoints are untrusted by default: SKILL.md/README reference hosted proxies (proxy-gateway-x402.easky.cn, proxy.easky.cn) of unknown origin. All proxied request data (URLs, headers, bodies, responses) will be visible to the operator — do not proxy API keys, passwords, private endpoints, or sensitive data through a hosted instance. Self-host if you need privacy.
- Verify developer recipient address and code provenance: the DEVELOPER_WALLET controls payment receipts. If you plan to pay, confirm the wallet address and the publisher identity. The skill's Source/Homepage are unknown; prefer code that is published from a traceable repository and signed releases.
- Self-hosting recommended: if you need the functionality, deploy the included server in an isolated environment (container), set RPC and wallet config to your own endpoints/wallets, and audit the code (particularly auto-pay and transaction validation) before use.
- Minimize privileges: if you test, set NETWORK=testnet (or base-sepolia), use a test RPC_URL, and set ADMIN_TOKEN / REDIS credentials appropriately. Inspect and optionally remove auto-pay capability if you cannot securely sign transactions.
What additional info would change the assessment:
- A verified publisher identity, an authoritative homepage/release URL, and matching registry metadata that declares required env vars and explains the hosted endpoints would raise confidence.
- Removal of the auto-pay-from-env pattern (or replacing it with a secure external signing flow/hardware-wallet integration) would materially reduce risk and could change the verdict toward benign.
Given the sensitive environment interaction (private key) and metadata/instruction mismatches, treat this skill as suspicious until the developer clarifies packaging, hosting, and how signing is performed securely.
功能分析
Type: OpenClaw Skill
Name: proxy-gateway-x402
Version: 0.1.6
The skill implements a proxy gateway using the x402 protocol for pay-per-use USDC payments on the Base and Polygon networks. It is classified as suspicious due to high-risk architectural patterns, specifically the requirement for users to store plaintext EVM private keys in environment variables (`USER_EVM_PRIVATE_KEY`) to facilitate automatic payments (`app/middleware/x402_payment.py`). While the documentation (`README.md`, `SECURITY.md`) provides extensive warnings regarding private key safety and the fact that the proxy operator has full visibility into all traffic (URLs, headers, and bodies), the handling of raw secrets and the inherent Man-in-the-Middle nature of the service pose significant security risks. No clear evidence of intentional exfiltration was found, but the 'auto-pay-demo' endpoint (`app/routers/proxy.py`) demonstrates server-side access to these sensitive environment variables.
能力评估
Purpose & Capability
The name, description, SKILL.md, and included code are consistent in implementing a pay-per-use HTTP proxy that verifies/sends USDC on-chain. However, metadata claims 'instruction-only' (no required env vars) while the code requires runtime configuration (DEVELOPER_WALLET, ADMIN_TOKEN, RPC_URL, etc.). README also references a hosted custodial endpoint and different trust models, creating mixed signals about custody/trust. Overall capability matches purpose but the packaging/metadata is inconsistent.
Instruction Scope
SKILL.md explicitly instructs users to set USER_EVM_PRIVATE_KEY in their environment to enable auto-pay; the code implements an auto-pay flow that signs and submits USDC transfers using that key. The skill also directs traffic through hosted endpoints (e.g., proxy-gateway-x402.easky.cn / proxy.easky.cn) and explicitly warns that all request data transits the proxy. Asking users (or an agent) to provide a raw private key and to route arbitrary requests through an external host expands scope and risk beyond a simple helper skill.
Install Mechanism
There is no install spec (instruction-only), which is lower risk in isolation, but the package contains a full application (19+ code files, requirements.txt, Docker instructions). That mismatch (no declared install but full source present) is unusual and should be clarified: either the skill is truly instruction-only (in which case shipping server code is misleading) or the code is intended to be deployed locally/dockerized (which requires an install step).
Credentials
Metadata shows 'required env vars: none' but the SKILL.md and code require several sensitive environment variables (USER_EVM_PRIVATE_KEY for auto-pay, DEVELOPER_WALLET, ADMIN_TOKEN, RPC_URL, REDIS creds, etc.). Requesting a user's private key as an environment variable is high-risk even if the skill recommends a dedicated wallet. The number and sensitivity of vars is disproportional to what's declared in the registry metadata.
Persistence & Privilege
The skill is not set always:true, and model invocation is allowed (default). Because the middleware supports auto-pay by reading USER_EVM_PRIVATE_KEY, autonomous invocation of the skill (or an agent using it) could cause on‑chain payments without an interactive confirmation. The combination of autonomous invocation + private-key-based auto-pay increases the blast radius and is a significant risk if a private key is present in the environment.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install proxy-gateway-x402 - 安装完成后,直接呼叫该 Skill 的名称或使用
/proxy-gateway-x402触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v0.1.6
- Minor internal updates.
- No user-facing documentation changes.
v0.1.5
- Major cleanup: removed 14 files including payment modules, tests, configuration, and developer docs.
- Reduced scope to core functionality only; no test or example files included.
- Internal code refactoring in app/managers/storage.py and skill.yaml.
- Documentation (SKILL.md) remains mostly unchanged for users and developers.
v0.1.4
- Updated logic in app/managers/proxy_manager.py
- Updated skill.yaml configuration
- No user-facing documentation changes in SKILL.md
v0.1.3
- Internal logic refactoring in hosted_payment, proxy_manager, and storage manager modules.
- Minor updates and possible dependency/configuration changes in skill.yaml.
- No changes to user-facing documentation or public API endpoints.
v0.1.2
- Internal metadata update for version 0.1.2 in skill.yaml.
- No changes to code or documentation content.
v0.1.1
- Updated SECURITY.md with improved or revised security information.
- Updated skill.yaml configuration.
- No changes were made to SKILL.md content.
- Version incremented to 0.1.1.
v0.1.0
Initial release of Proxy Gateway x402.
- Provides unrestricted proxy internet access with agent-to-agent, pay-per-use payments via x402 protocol.
- No custody or KYC; payments go directly to the developer in USDC on Base L2.
- Fast, sub-second confirmation and 0.001 USDC per request pricing.
- Supports auto-pay via EVM private key or manual payment flow with on-chain verification.
- Full open source with self-hosting, Docker deployment, and detailed API reference.
元数据
常见问题
Proxy Gateway X402 是什么?
Proxy Gateway X402 enables unrestricted pay-per-use internet access via the x402 protocol with direct USDC payments on Base L2, requiring no custody or KYC. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 130 次。
如何安装 Proxy Gateway X402?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install proxy-gateway-x402」即可一键安装,无需额外配置。
Proxy Gateway X402 是免费的吗?
是的,Proxy Gateway X402 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Proxy Gateway X402 支持哪些平台?
Proxy Gateway X402 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Proxy Gateway X402?
由 kehongpeng(@kehongpeng)开发并维护,当前版本 v0.1.6。
推荐 Skills