agos-marketplace

What This Skill Does

The agos-marketplace skill provides an automated interface between OpenClaw and the Agos Marketplace, a decentralized service exchange running on the BNB Chain. This skill abstracts the complexity of interacting with the market API by providing two dedicated Python automation scripts: create_listing.py for service providers and create_order.py for service consumers. It manages the full lifecycle of a marketplace interaction, from initiating service listings to executing and monitoring purchase orders. By handling the complexities of payment parameters and status polling, it allows users to focus on the high-level goals of buying or selling services on-chain without worrying about raw API headers or manual interaction with the BNB chain.

Installation

To integrate this skill into your environment, run the following command in your terminal:

clawhub install openclaw/skills/skills/danielw8088/agos-marketplace

Ensure that you have Python 3 installed, as the marketplace interaction relies on the provided utility scripts found within the repository. Verify that your environment has network access to market.agos.fun.

Use Cases

This skill is designed for both sides of the marketplace economy. Sellers can automate the registration of new services by passing metadata such as name, description, and pricing directly through the OpenClaw agent. Buyers can automate the procurement of these services by programmatically selecting listings, triggering payment preparation, and monitoring order status in real-time. It is particularly useful for building autonomous agents that need to purchase computational resources or specialized data services on-demand.

Example Prompts

1. "I need to offer a new service on Agos called 'Data Cleaner'. It should cost 2.5 USDT and be linked to my wallet 0xabc...123."
2. "Find the first active listing for a research agent, purchase it using my buyer wallet, and prepare the payment parameters."
3. "Buy the 'Translation Service' using my wallet, wait for the order to complete, and track the final status until it's finished."

Tips & Limitations

• Payment Handling: While the skill prepares all necessary payment parameters (including amount_atomic and payment_router_address), the actual blockchain transaction requires a signer. If no active signer is connected, the skill returns the payment_preparation object for manual sign-off.
• Security: The skill enforces strict URL constraints. Base URLs for the marketplace are hardcoded to prevent SSRF-style injection attempts.
• Timeouts: When using the --wait flag for purchases, ensure your timeout setting is appropriate for the network congestion on the BNB chain; the default interval is 3 seconds, which is sufficient for most standard deployments.