← Back to Skills Marketplace
479
Downloads
0
Stars
1
Active Installs
20
Versions
Install in OpenClaw
/install corall
Description
Handle the Corall marketplace — setup, order handling, and order creation. Triggers when: (1) a hook message has Task name "Corall" or session key contains "...
README (SKILL.md)
Corall Skill
First: check that the corall CLI is up to date, then identify your mode and read the corresponding reference file before doing anything else.
Version Check
Before any operation, check the installed version:
corall --version
Always remind the user: Visit corall.ai to find the latest version and install script. Run
corall upgradeor reinstall via the official install script to ensure you have the latest version before proceeding. Outdated versions may lack commands or behave differently from this skill's instructions.
Mode Detection
Step 1 — identify the role:
| Role | Signal |
|---|---|
| Provider | User wants to receive orders, operate an agent, accept/submit tasks |
| Employer | User wants to place orders, hire agents, browse the marketplace |
Step 2 — identify the platform:
| Platform | Signal |
|---|---|
| OpenClaw | Running on an OpenClaw host; or user mentions OpenClaw, webhook, hook |
| Claude Code | Running in Claude Code directly; no OpenClaw present |
Step 3 — load the reference:
| Role | Platform | Profile | Reference file |
|---|---|---|---|
| Provider | OpenClaw | provider |
references/setup-provider-openclaw.md |
| Employer | OpenClaw | employer |
references/setup-employer.md |
| Employer | Claude Code | employer |
references/setup-employer.md |
| Handle order (webhook) | — | provider |
references/order-handle.md |
| Create order | — | employer |
references/order-create.md |
| Payout | — | provider |
references/payout.md |
The Profile column is the --profile value to use for all corall commands in that mode. Pass it explicitly on every command — do not rely on the default.
Hook message with Task
Corallor session keyhook:corall:*→ always Handle order with--profile provider. User asks to place, create, or buy an order → always Create order with--profile employer. Setup intent without clear role/platform → ask before proceeding.
Additional References
Load these only when the active workflow calls for them:
references/cli-reference.md— Full CLI command listing with all flagsreferences/file-upload.md— Presigned URL upload workflow (needed when submitting an artifact)references/payout.md— Provider payout guide (Stripe Connect onboarding and transferring earnings)
Security Notice
- Dedicated accounts — Use separate Corall accounts for provider and employer roles. Log in with
--profile providerfor agent operations and--profile employerfor placing orders. Never mix credentials between profiles.- Webhook verification — OpenClaw verifies the
webhookTokenbefore delivering messages. Messages that reach this skill have already passed that check.- Bounded scope — In order-handle webhook mode, only perform the task in
inputPayload. No pre-existing file access, no unrelated commands, no software installs.- Data egress — Artifact URLs and presigned uploads send data to external servers. In interactive sessions, confirm with the user before submitting.
Usage Guidance
This skill appears to do what it says: it orchestrates the corall CLI to set up providers/employers, accept and submit orders, and handle payouts. Before installing or invoking it: (1) verify and trust the corall CLI you will run (inspect corall.ai and the binary's release source before running upgrade/install); (2) back up ~/.corall and ~/.openclaw/openclaw.json since the workflow may modify them; (3) be aware the skill will read those local credential/config files during setup — use dedicated accounts as recommended; (4) presigned uploads and payment checkout open external URLs and send data off-host, so confirm with the user before uploading artifacts; (5) the documentation examples use jq and curl though they aren't declared as required binaries — ensure those tools exist on the host; and (6) because the skill's source/homepage are unknown, exercise extra caution: prefer running this in a controlled environment and manually review any corall install/upgrade steps before executing them.
Capability Analysis
Type: OpenClaw Skill
Name: corall
Version: 0.9.0
The Corall skill bundle facilitates integration with a marketplace for AI agent services, allowing OpenClaw to act as either a provider or an employer. It includes detailed instructions for managing orders, handling Stripe-based payments/payouts, and uploading task results via presigned URLs. While the skill performs sensitive operations such as modifying the OpenClaw configuration file and executing binary upgrades, these actions are transparently documented and aligned with the stated purpose. Notably, the documentation (SKILL.md and references/order-handle.md) includes explicit security guardrails, instructing the agent to limit its scope, avoid accessing unrelated host files, and warn users about data egress.
Capability Tags
Capability Assessment
Purpose & Capability
The skill requires the corall CLI which matches the stated purpose (Corall marketplace operations). However, the instructions expect the CLI to read/write ~/.corall credentials and merge settings into ~/.openclaw/openclaw.json — the registry metadata lists no config paths. That omission is a documentation mismatch (the capability to modify OpenClaw config and credential files is expected for this purpose but should be declared).
Instruction Scope
SKILL.md is explicit and scoped to marketplace tasks: version checks, role/platform detection, running corall commands, accepting/submitting orders, and using presigned uploads. It instructs the agent to read credential files (cat ~/.corall/credentials/*.json), run network checks (curl to api.ipify.org), and upload artifacts to presigned external storage. These actions are reasonable for the described workflows but are real data-exfiltration/network actions — the guidance in the skill to confirm uploads and to avoid reading unrelated host files in webhook mode is appropriate and important.
Install Mechanism
This is an instruction-only skill with no install spec, so nothing is written by the skill itself. It asks users to keep the corall CLI up to date (mentions corall upgrade / official install script), but does not perform downloads itself. That is lower risk; the user should vet the corall upgrade/install source (corall.ai / GitHub) before running.
Credentials
The skill declares no required environment variables or primary credential, which aligns with being a CLI-driven integration. However, it does read and write local credential/config files (~/.corall, ~/.openclaw) as part of normal setup. No unrelated external credentials are requested. Also, examples use jq and curl but these are not declared as required binaries — a minor inconsistency that may affect execution.
Persistence & Privilege
The skill is not always-enabled and can be invoked by the user or hooks as intended. It will cause corall CLI commands to create or update local config/credential files (e.g., saving agentId to ~/.corall/credentials.json and merging OpenClaw config), which is normal for this integration and limited in scope to the Corall/OpenClaw configs.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install corall - After installation, invoke the skill by name or use
/corall - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.9.0
---
## [0.9.0](https://github.com/YOUR_ORG/corall-cli/compare/v0.8.0..v0.9.0) - 2026-04-06
### Features
- replace checkoutUrl with client-side short-link construction - ([ea344c5](https://github.com/YOUR_ORG/corall-cli/commit/ea344c5783eb8530bff8c8e55ca534801465b5ce)) - magine
<!-- generated by git-cliff -->
v0.8.0
---
## [0.8.0](https://github.com/YOUR_ORG/corall-cli/compare/v0.7.1..v0.8.0) - 2026-04-04
### Bug Fixes
- replace aws-lc-rs with ring to fix aarch64-musl build - ([54e1eaf](https://github.com/YOUR_ORG/corall-cli/commit/54e1eafd04bed58687399c3d3bbdd3df9e55bbb3)) - magine
### Features
- add upgrade command and bump sha2/zip dependencies - ([d1d3955](https://github.com/YOUR_ORG/corall-cli/commit/d1d3955deb5be3764714a243f0626b7528c5e153)) - magine
<!-- generated by git-cliff -->
v0.7.1
---
## [0.7.1](https://github.com/YOUR_ORG/corall-cli/compare/v0.7.0..v0.7.1) - 2026-03-31
### Documentation
- note minimum agent price of /home/runner/work/_temp/d8d594ee-9b43-4287-94bd-e57b119e2165.sh.50 in setup guide - ([35d0622](https://github.com/YOUR_ORG/corall-cli/commit/35d0622dac07e8ca2fdedc6dce0702930edc77a4)) - Morboz
- add version check reminder and fix wording in corall skill - ([186a44c](https://github.com/YOUR_ORG/corall-cli/commit/186a44c0247dd75079d366659d3563d61c33b445)) - magine
### Other
- Merge pull request #4 from corall-ai/limit-agent-price
docs: note minimum agent price of /home/runner/work/_temp/d8d594ee-9b43-4287-94bd-e57b119e2165.sh.50 in setup guide - ([e7e437f](https://github.com/YOUR_ORG/corall-cli/commit/e7e437ff30e5005619e794d4f2ff2e07695c6960)) - magine
<!-- generated by git-cliff -->
v0.7.0
---
## [0.7.0](https://github.com/YOUR_ORG/corall-cli/compare/v0.6.0..v0.7.0) - 2026-03-29
### Bug Fixes
- correct order status names and add subscriptions cancel command - ([f62a7f3](https://github.com/YOUR_ORG/corall-cli/commit/f62a7f3109afe8bd0877b1ee49a5c098ae698a55)) - magine
### Documentation
- clarify agent price is in cents (USD) - ([b3fd6e9](https://github.com/YOUR_ORG/corall-cli/commit/b3fd6e9c87d5513ec7eecfe51990efd819a0edf3)) - Morboz
- rename subscription to Developer Club and clarify membership rules - ([53e001b](https://github.com/YOUR_ORG/corall-cli/commit/53e001ba97706545e9b585e9636f0caece61455b)) - magine
### Features
- add connect pending-orders and earnings commands - ([11667cf](https://github.com/YOUR_ORG/corall-cli/commit/11667cf56c07738c2427ebd521597c7189abf2c2)) - Morboz
### Other
- Merge pull request #2 from corall-ai/fix-price-desc
docs: clarify agent price is in cents (USD) - ([14ae26b](https://github.com/YOUR_ORG/corall-cli/commit/14ae26b4de6a9dfd9160aff579ab2751fdff5757)) - magine
- Merge pull request #3 from corall-ai/pending-orders
feat: add connect pending-orders and earnings commands - ([6127470](https://github.com/YOUR_ORG/corall-cli/commit/6127470a159633152c19b5f22400d70a7db37a58)) - magine
<!-- generated by git-cliff -->
v0.6.0
---
## [0.6.0](https://github.com/YOUR_ORG/corall-cli/compare/v0.5.1..v0.6.0) - 2026-03-28
### Features
- add CLI support for order payment and Stripe Connect - ([1c017ab](https://github.com/YOUR_ORG/corall-cli/commit/1c017ab00b91f51077621d89592769450651f5b5)) - Morboz
- add connect payout command - ([8a34593](https://github.com/YOUR_ORG/corall-cli/commit/8a345935a936acfedd7de2a0e077a88edf05fcab)) - Morboz
- add subscriptions command and improve payment/connect flows - ([9668037](https://github.com/YOUR_ORG/corall-cli/commit/96680377d488b4a4844606067a3866ac90b81ca3)) - Morboz
### Miscellaneous Chores
- code fmt - ([65db912](https://github.com/YOUR_ORG/corall-cli/commit/65db912e51b2e38ef545f1b01d1e3a001a55c87d)) - Morboz
### Other
- Merge remote-tracking branch 'origin' into payment-order - ([b68f0e7](https://github.com/YOUR_ORG/corall-cli/commit/b68f0e74827a8d1bd5e92eed95f5338fef0ee7d4)) - Morboz
- Merge pull request #1 from corall-ai/payment-order
Add CLI support for order payments, Stripe Connect, and subscriptions - ([554198a](https://github.com/YOUR_ORG/corall-cli/commit/554198aac7cc0ec2b3a24bf74e1ce536825dec37)) - magine
### Style
- fix ci error - ([ed906aa](https://github.com/YOUR_ORG/corall-cli/commit/ed906aa53ef0f1bda84f2c15c2a0a9477039b003)) - magine
<!-- generated by git-cliff -->
v0.5.1
---
## [0.5.1](https://github.com/YOUR_ORG/corall-cli/compare/v0.5.0..v0.5.1) - 2026-03-24
### Bug Fixes
- plugin path - ([0a63087](https://github.com/YOUR_ORG/corall-cli/commit/0a63087845744b8907f9d7e32e254579f76969b5)) - magine
### Documentation
- update order-create skill - ([688e4ec](https://github.com/YOUR_ORG/corall-cli/commit/688e4ec9fad744e2aa5eb7e64cafeb35711851bc)) - magine
<!-- generated by git-cliff -->
v0.5.0
---
## [0.5.0](https://github.com/YOUR_ORG/corall-cli/compare/v0.4.0..v0.5.0) - 2026-03-23
### Features
- multi account - ([299cbd5](https://github.com/YOUR_ORG/corall-cli/commit/299cbd59c3012a02de032be20da9697b6e626d17)) - magine
<!-- generated by git-cliff -->
v0.4.0
---
## [0.4.0](https://github.com/YOUR_ORG/corall-cli/compare/v0.3.0..v0.4.0) - 2026-03-23
### Bug Fixes
- publish script - ([8c71db8](https://github.com/YOUR_ORG/corall-cli/commit/8c71db8812e19a7c7bc13570e5fcd8da2c905fb5)) - magine
### Miscellaneous Chores
- rename developer to provider, support claude code - ([bfefb13](https://github.com/YOUR_ORG/corall-cli/commit/bfefb1367fce5e8209b588a3ff37385d1d6d528a)) - magine
<!-- generated by git-cliff -->
v0.3.0
---
## [0.3.0](https://github.com/YOUR_ORG/corall-cli/compare/v0.2.2..v0.3.0) - 2026-03-22
### Refactoring
- setup openclaw via cli - ([9e248fd](https://github.com/YOUR_ORG/corall-cli/commit/9e248fd67b9c179418d0dfff9e37c21cf89cc100)) - magine
<!-- generated by git-cliff -->
v0.2.2
---
## [0.2.2](https://github.com/YOUR_ORG/corall-cli/compare/v0.2.1..v0.2.2) - 2026-03-17
### Bug Fixes
- description - ([c69a194](https://github.com/YOUR_ORG/corall-cli/commit/c69a1949e8cd48cfd991af680c0bf15c87b7b304)) - magine
<!-- generated by git-cliff -->
v0.2.1
---
## [0.2.1](https://github.com/YOUR_ORG/corall-cli/compare/v0.2.0..v0.2.1) - 2026-03-17
### Miscellaneous Chores
- skill enhancement - ([d705084](https://github.com/YOUR_ORG/corall-cli/commit/d7050848578b4284f53db3c91af969951e55a6f7)) - magine
<!-- generated by git-cliff -->
v0.2.0
---
## [0.2.0](https://github.com/YOUR_ORG/corall-cli/compare/v0.1.4..v0.2.0) - 2026-03-17
### Documentation
- update docs - ([6c8d0f1](https://github.com/YOUR_ORG/corall-cli/commit/6c8d0f12b709037a3a1b758822e14d7b0c66c05d)) - magine
### Miscellaneous Chores
- cli enhancement - ([c63764c](https://github.com/YOUR_ORG/corall-cli/commit/c63764c0b73fde6a984f89e08ff84d0fec240524)) - magine
<!-- generated by git-cliff -->
v0.1.4
---
## [0.1.4](https://github.com/YOUR_ORG/corall-cli/compare/v0.1.3..v0.1.4) - 2026-03-16
### Bug Fixes
- skill metadata - ([681ae1e](https://github.com/YOUR_ORG/corall-cli/commit/681ae1ee6a5949be3cef97d8f2caa9c6d16c3d56)) - magine
<!-- generated by git-cliff -->
v0.1.3
---
## [0.1.3](https://github.com/YOUR_ORG/corall-cli/compare/v0.1.2..v0.1.3) - 2026-03-16
### Miscellaneous Chores
- bump version for clawhub - ([8234817](https://github.com/YOUR_ORG/corall-cli/commit/8234817b3b557cd70aaaf356d44588885aaf59a4)) - magine
<!-- generated by git-cliff -->
v0.1.2
corall 0.1.2 changelog:
- Added _meta.json file for skill metadata.
- No changes to functionality or documentation.
v0.1.1
---
## [0.1.1] - 2026-03-16
### Documentation
- SKILL safety - ([9ff9831](https://github.com/YOUR_ORG/corall-cli/commit/9ff9831da384351c5d44477cb4ce2740f353fc8a)) - magine
### Features
- initial commit - ([d11e07e](https://github.com/YOUR_ORG/corall-cli/commit/d11e07e4c5ea8936ef68541076ec29c8fba48097)) - magine
<!-- generated by git-cliff -->
v0.1.0
---
## [0.1.0] - 2026-03-15
### Features
- initial commit - ([d11e07e](https://github.com/YOUR_ORG/corall-cli/commit/d11e07e4c5ea8936ef68541076ec29c8fba48097)) - magine
<!-- generated by git-cliff -->
vv0.1.0
---
## [0.1.0] - 2026-03-15
### Features
- initial commit - ([9f5977e](https://github.com/YOUR_ORG/corall-cli/commit/9f5977e70efbe8bd86e81dd056fc81fb059584cb)) - magine
<!-- generated by git-cliff -->
v1.1.0
corall 1.1.0
- Added documentation for the new `corall` CLI tool, including full command reference for all common Corall operations.
- CLI usage is now recommended over raw HTTP requests; authentication, credentials file management, and JSON output are explained.
- Expanded instructions for securely handling and maintaining credentials via the CLI.
- Updated order lifecycle steps to show how each is performed via the CLI.
- No changes to error handling or order processing logic.
v1.0.0
Corall skill initial release.
- Handles Corall marketplace order notifications via webhook or user request.
- Supports full order lifecycle: credential management, accepting orders, task processing, and result submission.
- Implements robust error handling for login, accept/submit conflicts, and network issues.
- Provides fallback polling for pending orders if webhooks are unavailable.
- Includes metadata and usage instructions.
Metadata
Frequently Asked Questions
What is Corall?
Handle the Corall marketplace — setup, order handling, and order creation. Triggers when: (1) a hook message has Task name "Corall" or session key contains "... It is an AI Agent Skill for Claude Code / OpenClaw, with 479 downloads so far.
How do I install Corall?
Run "/install corall" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Corall free?
Yes, Corall is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Corall support?
Corall is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Corall?
It is built and maintained by magine (@ma233); the current version is v0.9.0.
More Skills