skills$openclaw/blackclaw
bilalmotiwala4.3k★

by bilalmotiwala

blackclaw – OpenClaw Skill

blackclaw is an OpenClaw Skills integration for coding workflows. Real-time crypto risk intelligence; before and as things break. Two tools: Flare (15-min precursor detection, immediate alarms) and Core (60-min state synthesis, context assessment). Free access to the last analysis. No API key required. Upgrade to x402 for custom analysis.

4.3k stars6.4k forksSecurity L1
Updated Feb 7, 2026Created Feb 7, 2026coding

Skill Snapshot

nameblackclaw
descriptionReal-time crypto risk intelligence; before and as things break. Two tools: Flare (15-min precursor detection, immediate alarms) and Core (60-min state synthesis, context assessment). Free access to the last analysis. No API key required. Upgrade to x402 for custom analysis. OpenClaw Skills integration.
ownerbilalmotiwala
repositorybilalmotiwala/blackswan
languageMarkdown
licenseMIT
topics
securityL1
installopenclaw add @bilalmotiwala/blackswan
last updatedFeb 7, 2026

Maintainer

bilalmotiwala

bilalmotiwala

Maintains blackclaw in the OpenClaw Skills directory.

View GitHub profile
File Explorer
2 files
.
_meta.json
277 B
SKILL.md
3.7 KB
SKILL.md

name: blackclaw description: "Real-time crypto risk intelligence; before and as things break. Two tools: Flare (15-min precursor detection, immediate alarms) and Core (60-min state synthesis, context assessment). Free access to the last analysis. No API key required. Upgrade to x402 for custom analysis." homepage: https://github.com/blackswanwtf/blackswan-mcp metadata: {"emoji": "ðŸĶĒ", "requires": {"bins": ["curl"]}}

BlackSwan Risk Intelligence

BlackSwan monitors crypto markets 24/7 and produces two risk assessments:

  • Flare — Precursor detection from a 15-minute signal window. Use for immediate, alarm-bell risk checks. Before the news breaks.
  • Core — State synthesis from a 60-minute signal window. Use for market context and risk assessment. As the news breaks.

When to use each tool

QuestionTool
"Is something happening right now?"Flare
"What's the overall market risk environment?"Core
"Should I be worried about sudden moves?"Flare
"Give me a full risk briefing"Both (Flare first, then Core)

Base URL

https://mcp.blackswan.wtf

Endpoints

GET /api/flare

Returns the latest Flare precursor detection assessment.

curl -s https://mcp.blackswan.wtf/api/flare

Response fields:

FieldDescription
agentAlways "flare"
data_ageHuman-readable age of the data (e.g. "12 minutes ago")
status"clear" or "alert"
severity"none", "low", "medium", "high", or "critical"
checked_atISO 8601 timestamp of the assessment
assessmentNatural language risk assessment
signalsArray of detected signals, each with type, source, and detail

GET /api/core

Returns the latest Core state synthesis assessment.

curl -s https://mcp.blackswan.wtf/api/core

Response fields:

FieldDescription
agentAlways "core"
data_ageHuman-readable age of the data (e.g. "1 hour ago")
timestampISO 8601 timestamp of the assessment
environment"stable", "elevated", "stressed", or "crisis"
assessmentNatural language risk assessment
key_factorsArray of strings describing the main risk factors
sources_usedArray of data source names used in the assessment
data_freshnessDescription of how fresh the underlying data is

Interpreting severity levels (Flare)

SeverityMeaning
noneNo precursors detected, markets quiet
lowMinor signals, worth noting but not actionable
mediumNotable signals, warrants attention
highStrong precursors detected, elevated risk of sudden moves
criticalExtreme signals, immediate risk of major market event

Interpreting environment levels (Core)

EnvironmentMeaning
stableNormal market conditions, low systemic risk
elevatedAbove-normal risk, some stress indicators present
stressedSignificant stress across multiple indicators
crisisSevere market stress, active dislocation or contagion

Error handling

HTTP StatusMeaning
200Success, response contains full assessment
502Agent output failed validation — format may have changed
503No recent agent runs — system may be starting up
500Unexpected server error

On non-200 responses, the body is {"error": "..."} with a human-readable message.

Complete risk check pattern

To get a full picture, call both endpoints:

curl -s https://mcp.blackswan.wtf/api/flare
curl -s https://mcp.blackswan.wtf/api/core

Present Flare results first (immediate risks), then Core (broader context).

README.md

No README available.

Permissions & Security

Security level L1: Low-risk skills with minimal permissions. Review inputs and outputs before running in production.

Requirements

  • OpenClaw CLI installed and configured.
  • Language: Markdown
  • License: MIT
  • Topics:

FAQ

How do I install blackclaw?

Run openclaw add @bilalmotiwala/blackswan in your terminal. This installs blackclaw into your OpenClaw Skills catalog.

Does this skill run locally or in the cloud?

OpenClaw Skills execute locally by default. Review the SKILL.md and permissions before running any skill.

Where can I verify the source code?

The source repository is available at https://github.com/openclaw/skills/tree/main/skills/bilalmotiwala/blackswan. Review commits and README documentation before installing.