← 返回 Skills 市场
ma233

Corall

作者 magine · GitHub ↗ · v0.9.0 · MIT-0
cross-platform ✓ 安全检测通过
479
总下载
0
收藏
1
当前安装
20
版本数
在 OpenClaw 中安装
/install 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 "...
使用说明 (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 upgrade or 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 Corall or session key hook: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 flags
  • references/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

  1. Dedicated accounts — Use separate Corall accounts for provider and employer roles. Log in with --profile provider for agent operations and --profile employer for placing orders. Never mix credentials between profiles.
  2. Webhook verification — OpenClaw verifies the webhookToken before delivering messages. Messages that reach this skill have already passed that check.
  3. Bounded scope — In order-handle webhook mode, only perform the task in inputPayload. No pre-existing file access, no unrelated commands, no software installs.
  4. Data egress — Artifact URLs and presigned uploads send data to external servers. In interactive sessions, confirm with the user before submitting.
安全使用建议
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.
功能分析
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.
能力标签
cryptocan-make-purchases
能力评估
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.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install corall
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /corall 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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.
元数据
Slug corall
版本 0.9.0
许可证 MIT-0
累计安装 1
当前安装数 1
历史版本数 20
常见问题

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 "... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 479 次。

如何安装 Corall?

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

Corall 是免费的吗?

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

Corall 支持哪些平台?

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

谁开发了 Corall?

由 magine(@ma233)开发并维护,当前版本 v0.9.0。

💬 留言讨论