openmarlin

What This Skill Does

The OpenMarlin skill serves as the primary integration bridge between the OpenClaw agent ecosystem and OpenMarlin services. It is designed to handle the full lifecycle of OpenMarlin interactions, from initial account bootstrap and API key management to the execution of both standard requests and long-running asynchronous tasks. By centralizing billing, authentication, and execution logic, it allows users to leverage OpenMarlin's advanced models and tools directly within their OpenClaw chat session. The skill manages the complexity of the /v1/executions and /v1/tasks endpoints, ensuring that users can invoke powerful reasoning and data processing capabilities without needing to manage raw API configurations manually.

Installation

To install this skill, use the clawhub command-line tool. Ensure your environment has python3 installed and that your OpenClaw instance is properly configured for agent interactions. Execute the following command in your terminal:

clawhub install openclaw/skills/skills/alex4506/openmarlin

Ensure that the installation includes both the SKILL.md file and the scripts/ directory, as the internal components depend on specific helper scripts for platform requests, billing, and authentication.

Use Cases

• Complex Reasoning & Summarization: Offload difficult summarization or analysis tasks to OpenMarlin.
• Task Execution: Trigger long-running asynchronous processes that persist beyond the immediate chat session.
• Billing Management: Check account balances or resolve payment issues without leaving the chat interface.
• Account Bootstrap: Perform secure registration and authentication flows, leveraging OpenClaw's internal storage mechanisms for platform keys.

Example Prompts

1. "Use OpenMarlin to summarize the research paper linked at this URL and extract the key findings."
2. "Check my OpenMarlin account balance and let me know if I need to update my billing information."
3. "OpenMarlin, please find the latest USD/CNY exchange rate and present the trend for the last 7 days."

Tips & Limitations

• Always rely on the Registration Session: When authenticating, avoid browser-based manual overrides. The skill tracks the registration session state automatically until completion.
• Handle Billing with Care: Always treat balance information as the 'last-known' state provided by the API; ensure you verify major account changes through the secure browser handoff.
• Authentication: Keep credentials secure; never type passwords into the chat. Use the device-based auth flow provided by the skill.
• Origin URL: The OPENMARLIN_SERVER_URL should always be a bare origin (e.g., https://api.openmarlin.ai). Do not append /v1 to the environment variable path, as the skill handles endpoint routing internally.