openclaw-airflow-plugin

Plugin externo read-only de OpenClaw para Apache Airflow.

Alcance actual

• Read-only.
• Solo Airflow Stable REST API.
• Solo /api/v2.
• Sin mutaciones.
• Sin logs, XCom ni features administrativas.
• Sin scraping ni acceso directo a DB.

Tools funcionales

• airflow.list_dags
• airflow.list_dag_runs
• airflow.list_task_instances

Restricciones de seguridad

• Solo autenticacion bearer.
• Solo metodo HTTP GET.
• Solo Airflow Stable REST API /api/v2.
• Sin mutaciones.
• Sin lectura de logs.
• Sin XCom.
• Sin features administrativas.
• Sin scraping.
• Sin acceso directo a DB.

Configuracion requerida

• baseUrl (URL base de Airflow, validada en modo fail-closed)
• authMode ("bearer")
• token (Bearer token)

Configuracion opcional

• timeoutMs (default 15000)
• retryCount (default 1)
• maxPageSize (default 100)
• defaultDagLimit (default 20)
• defaultDagRunLimit (default 10)
• defaultTaskInstanceLimit (default 100)
• allowPrivateHost (default false)
• allowInsecureHttp (default false)
• redactSensitiveErrors (default true)
• enableVerboseDiagnostics (default false)

Instalacion local

npm install
npm run typecheck
npm test

Instalacion en OpenClaw

• Tarball local: openclaw plugins install "./kansodata-openclaw-airflow-plugin-0.1.0.tgz"
• Referencia npm (scope requerido): openclaw plugins install "@kansodata/openclaw-airflow-plugin"

Empaquetado local

npm run pack:check
npm run smoke:external