openclaw/docs
openclaw/docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore(i18n): refresh es translations

Browse Source
This commit is contained in:
openclaw-docs-i18n[bot] 2026-04-06 05:17:44 +00:00
parent fbb95e1f0d
commit 473154dd77
7 changed files with 1529 additions and 1480 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

560
docs/es/channels/matrix.md
View File

File diff suppressed because it is too large Load Diff

123
docs/es/concepts/dreaming.md
View File

@ -1,52 +1,52 @@
---
read_when:
- Quieres que la promoción de memoria se ejecute automáticamente
- Quieres entender qué hace cada fase de sueño
- Quieres ajustar la consolidación sin contaminar `MEMORY.md`
- Quieres entender qué hace cada fase de dreaming
- Quieres ajustar la consolidación sin contaminar MEMORY.md
summary: Consolidación de memoria en segundo plano con fases ligera, profunda y REM, además de un Diario de Sueños
title: Sueños (experimental)
title: Dreaming (experimental)
x-i18n:
generated_at: "2026-04-06T03:06:09Z"
generated_at: "2026-04-06T05:12:22Z"
model: gpt-5.4
provider: openai
source_hash: f27da718176bebf59fe8a80fddd4fb5b6d814ac5647f6c1e8344bcfb328db9de
source_hash: 36c4b1e70801d662090dc8ce20608c2f141c23cd7ce53c54e3dcf332c801fd4e
source_path: concepts/dreaming.md
workflow: 15
---
# Sueños (experimental)
# Dreaming (experimental)
Sueños es el sistema de consolidación de memoria en segundo plano de `memory-core`.
Ayuda a OpenClaw a mover señales sólidas de corto plazo hacia memoria duradera mientras
Dreaming es el sistema de consolidación de memoria en segundo plano de `memory-core`.
Ayuda a OpenClaw a mover señales fuertes de corto plazo a memoria duradera, mientras
mantiene el proceso explicable y revisable.
Sueños es **optativo** y está deshabilitado de forma predeterminada.
Dreaming es **optativo** y está desactivado de forma predeterminada.
## Qué escribe Sueños
## Qué escribe dreaming
Sueños mantiene dos tipos de salida:
Dreaming mantiene dos tipos de salida:
- **Estado de máquina** en `memory/.dreams/` (almacén de recuperación, señales de fase, puntos de control de ingestión, bloqueos).
- **Salida legible para humanos** en `DREAMS.md` (o `dreams.md` existente) y archivos opcionales de informes de fase en `memory/dreaming/<phase>/YYYY-MM-DD.md`.
- **Salida legible por humanos** en `DREAMS.md` (o `dreams.md` existente) y archivos opcionales de informes de fase en `memory/dreaming/<phase>/YYYY-MM-DD.md`.
La promoción a largo plazo sigue escribiendo solo en `MEMORY.md`.
## Modelo de fases
Sueños usa tres fases cooperativas:
Dreaming usa tres fases cooperativas:
| Fase | Propósito | Escritura duradera |
| ----- | ------------------------------------------ | ------------------ |
| Ligera | Ordenar y preparar material reciente de corto plazo | No |
| Profunda | Puntuar y promover candidatos duraderos | Sí (`MEMORY.md`) |
| REM | Reflexionar sobre temas e ideas recurrentes | No |
| Fase | Propósito | Escritura duradera |
| ----- | --------- | ------------------ |
| Ligera | Ordenar y preparar material reciente de corto plazo | No |
| Profunda | Puntuar y promover candidatos duraderos | Sí (`MEMORY.md`) |
| REM | Reflexionar sobre temas e ideas recurrentes | No |
Estas fases son detalles internos de implementación, no "modos"
separados configurados por el usuario.
### Fase ligera
La fase ligera ingiere señales recientes de memoria diaria y trazas de recuperación, las desduplica
La fase ligera ingiere señales recientes de memoria diaria y rastros de recuperación, los deduplica
y prepara líneas candidatas.
- Lee del estado de recuperación a corto plazo y de archivos recientes de memoria diaria.
@ -58,59 +58,59 @@ y prepara líneas candidatas.
La fase profunda decide qué se convierte en memoria a largo plazo.
- Clasifica candidatos usando puntuación ponderada y umbrales de control.
- Clasifica candidatos usando puntuación ponderada y umbrales de acceso.
- Requiere que `minScore`, `minRecallCount` y `minUniqueQueries` se cumplan.
- Rehidrata fragmentos desde archivos diarios activos antes de escribir, por lo que se omiten fragmentos obsoletos o eliminados.
- Rehidrata fragmentos desde archivos diarios activos antes de escribir, por lo que se omiten los fragmentos obsoletos o eliminados.
- Agrega entradas promovidas a `MEMORY.md`.
- Escribe un resumen `## Deep Sleep` en `DREAMS.md` y opcionalmente escribe `memory/dreaming/deep/YYYY-MM-DD.md`.
- Escribe un resumen `## Deep Sleep` en `DREAMS.md` y, opcionalmente, escribe `memory/dreaming/deep/YYYY-MM-DD.md`.
### Fase REM
La fase REM extrae patrones y señales reflexivas.
- Construye resúmenes de temas y reflexiones a partir de trazas recientes de corto plazo.
- Construye resúmenes de temas y reflexiones a partir de rastros recientes de corto plazo.
- Escribe un bloque administrado `## REM Sleep` cuando el almacenamiento incluye salida en línea.
- Registra señales de refuerzo REM usadas por la clasificación profunda.
- Nunca escribe en `MEMORY.md`.
## Diario de Sueños
Sueños también mantiene un **Diario de Sueños** narrativo en `DREAMS.md`.
Después de que cada fase tiene suficiente material, `memory-core` ejecuta en segundo plano, con el mejor esfuerzo,
un turno de subagente (usando el modelo de runtime predeterminado) y agrega una breve entrada de diario.
Dreaming también mantiene un **Diario de Sueños** narrativo en `DREAMS.md`.
Después de que cada fase tiene suficiente material, `memory-core` ejecuta un turno
de subagente en segundo plano de mejor esfuerzo (usando el modelo de runtime predeterminado) y agrega una entrada breve al diario.
Este diario es para lectura humana en la interfaz de Sueños, no una fuente de promoción.
Este diario es para lectura humana en la UI de Dreams, no una fuente de promoción.
## Señales de clasificación profunda
La clasificación profunda usa seis señales base ponderadas más refuerzo por fase:
La clasificación profunda usa seis señales base ponderadas más refuerzo de fase:
| Señal | Peso | Descripción |
| ------------------- | ------ | ------------------------------------------------- |
| Frecuencia | 0.24 | Cuántas señales de corto plazo acumuló la entrada |
| Relevancia | 0.30 | Calidad promedio de recuperación de la entrada |
| Diversidad de consultas | 0.15 | Contextos distintos de consulta/día en los que apareció |
| Recencia | 0.15 | Puntuación de frescura con decaimiento temporal |
| Consolidación | 0.10 | Fuerza de recurrencia en varios días |
| Riqueza conceptual | 0.06 | Densidad de etiquetas conceptuales del fragmento/ruta |
| Señal | Peso | Descripción |
| ------ | ---- | ----------- |
| Frecuencia | 0.24 | Cuántas señales de corto plazo acumuló la entrada |
| Relevancia | 0.30 | Calidad media de recuperación de la entrada |
| Diversidad de consultas | 0.15 | Contextos distintos de consulta/día en que apareció |
| Recencia | 0.15 | Puntuación de frescura con decaimiento temporal |
| Consolidación | 0.10 | Fuerza de recurrencia en varios días |
| Riqueza conceptual | 0.06 | Densidad de etiquetas conceptuales del fragmento/ruta |
Los aciertos de las fases ligera y REM agregan un pequeño impulso con decaimiento temporal desde
Los aciertos de las fases ligera y REM añaden un pequeño refuerzo con decaimiento por recencia desde
`memory/.dreams/phase-signals.json`.
## Programación
Cuando está habilitado, `memory-core` administra automáticamente una tarea cron para un barrido
completo de sueños. Cada barrido ejecuta las fases en orden: ligera -> REM -> profunda.
completo de dreaming. Cada barrido ejecuta las fases en orden: ligera -> REM -> profunda.
Comportamiento predeterminado de la cadencia:
| Configuración | Predeterminado |
| -------------------- | ----------- |
| Configuración | Predeterminado |
| ------------- | -------------- |
| `dreaming.frequency` | `0 3 * * *` |
## Inicio rápido
Habilitar Sueños:
Habilitar dreaming:
```json
{
@ -128,7 +128,7 @@ Habilitar Sueños:
}
```
Habilitar Sueños con una cadencia de barrido personalizada:
Habilitar dreaming con una cadencia de barrido personalizada:
```json
{
@ -168,31 +168,46 @@ openclaw memory promote --limit 5
openclaw memory status --deep
```
`memory promote` manual usa los umbrales de la fase profunda de forma predeterminada, a menos que se reemplacen
con indicadores de la CLI.
La ejecución manual de `memory promote` usa los umbrales de la fase profunda de forma predeterminada, salvo que se sobrescriban
con flags de la CLI.
Explica por qué un candidato específico se promovería o no:
```bash
openclaw memory promote-explain "router vlan"
openclaw memory promote-explain "router vlan" --json
```
Obtén una vista previa de reflexiones REM, verdades candidatas y salida de promoción profunda sin
escribir nada:
```bash
openclaw memory rem-harness
openclaw memory rem-harness --json
```
## Valores predeterminados clave
Toda la configuración se encuentra en `plugins.entries.memory-core.config.dreaming`.
Todas las configuraciones viven en `plugins.entries.memory-core.config.dreaming`.
| Clave | Predeterminado |
| ----------- | ----------- |
| `enabled` | `false` |
| Clave | Predeterminado |
| ----- | -------------- |
| `enabled` | `false` |
| `frequency` | `0 3 * * *` |
La política de fases, los umbrales y el comportamiento de almacenamiento son detalles internos de implementación
(no son configuración visible para el usuario).
(no son configuración orientada al usuario).
Consulta la [referencia de configuración de Memory](/es/reference/memory-config#dreaming-experimental)
para ver la lista completa de claves.
## Interfaz de Sueños
## UI de Dreams
Cuando está habilitada, la pestaña **Dreams** del Gateway muestra:
- estado actual de habilitación de Sueños
- estado por fase y presencia del barrido administrado
- recuentos de corto plazo, largo plazo y promociones de hoy
- estado actual de habilitación de dreaming
- estado a nivel de fase y presencia de barrido administrado
- recuentos de corto plazo, largo plazo y promovidos hoy
- hora de la siguiente ejecución programada
- un lector expandible del Diario de Sueños respaldado por `doctor.memory.dreamDiary`
@ -200,5 +215,5 @@ Cuando está habilitada, la pestaña **Dreams** del Gateway muestra:
- [Memory](/es/concepts/memory)
- [Memory Search](/es/concepts/memory-search)
- [memory CLI](/cli/memory)
- [CLI de memory](/cli/memory)
- [referencia de configuración de Memory](/es/reference/memory-config)

1200
docs/es/gateway/configuration-reference.md
View File

File diff suppressed because it is too large Load Diff

382
docs/es/plugins/sdk-migration.md
View File

@ -2,43 +2,43 @@
read_when:
- Ves la advertencia OPENCLAW_PLUGIN_SDK_COMPAT_DEPRECATED
- Ves la advertencia OPENCLAW_EXTENSION_API_DEPRECATED
- Estás actualizando un plugin a la arquitectura moderna de plugins de OpenClaw
- Estás actualizando un plugin a la arquitectura moderna de plugins
- Mantienes un plugin externo de OpenClaw
sidebarTitle: Migrate to SDK
summary: Migra desde la capa heredada de compatibilidad hacia atrás al Plugin SDK moderno
title: Migración del Plugin SDK
summary: Migra de la capa heredada de compatibilidad con versiones anteriores al moderno plugin SDK
title: Migración de Plugin SDK
x-i18n:
generated_at: "2026-04-06T03:09:50Z"
generated_at: "2026-04-06T05:13:27Z"
model: gpt-5.4
provider: openai
source_hash: b71ce69b30c3bb02da1b263b1d11dc3214deae5f6fc708515e23b5a1c7bb7c8f
source_hash: 94f12d1376edd8184714cc4dbea4a88fa8ed652f65e9365ede6176f3bf441b33
source_path: plugins/sdk-migration.md
workflow: 15
---
# Migración del Plugin SDK
# Migración de Plugin SDK
OpenClaw ha pasado de una amplia capa de compatibilidad hacia atrás a una arquitectura moderna de plugins
con importaciones específicas y documentadas. Si tu plugin se creó antes
de la nueva arquitectura, esta guía te ayuda a migrarlo.
OpenClaw ha pasado de una amplia capa de compatibilidad con versiones anteriores a una arquitectura moderna de plugins
con importaciones específicas y documentadas. Si tu plugin se creó antes de
la nueva arquitectura, esta guía te ayudará a migrarlo.
## Qué está cambiando
El sistema antiguo de plugins proporcionaba dos superficies muy abiertas que permitían a los plugins importar
El sistema de plugins anterior proporcionaba dos superficies muy abiertas que permitían a los plugins importar
todo lo que necesitaban desde un único punto de entrada:
- **`openclaw/plugin-sdk/compat`** — una sola importación que reexportaba decenas de
helpers. Se introdujo para mantener funcionando los plugins antiguos basados en hooks mientras se
utilidades. Se introdujo para mantener en funcionamiento los plugins antiguos basados en hooks mientras se
construía la nueva arquitectura de plugins.
- **`openclaw/extension-api`** — un puente que daba a los plugins acceso directo a
helpers del lado del host, como el ejecutor de agentes integrados.
utilidades del lado del host, como el ejecutor de agentes embebido.
Ambas superficies ahora están **obsoletas**. Siguen funcionando en runtime, pero los nuevos
plugins no deben usarlas, y los plugins existentes deberían migrar antes de que la próxima
Ambas superficies ahora están **obsoletas**. Siguen funcionando en tiempo de ejecución, pero los plugins nuevos
no deben usarlas, y los plugins existentes deberían migrar antes de que la próxima
versión principal las elimine.
<Warning>
La capa de compatibilidad hacia atrás se eliminará en una futura versión principal.
La capa de compatibilidad con versiones anteriores se eliminará en una futura versión principal.
Los plugins que sigan importando desde estas superficies dejarán de funcionar cuando eso ocurra.
</Warning>
@ -46,37 +46,37 @@ versión principal las elimine.
El enfoque anterior causaba problemas:
- **Inicio lento** — importar un helper cargaba docenas de módulos no relacionados
- **Dependencias circulares** — las reexportaciones amplias facilitaban crear ciclos de importación
- **Inicio lento** — importar una utilidad cargaba docenas de módulos no relacionados
- **Dependencias circulares** — las reexportaciones amplias hacían fácil crear ciclos de importación
- **Superficie de API poco clara** — no había forma de saber qué exportaciones eran estables y cuáles eran internas
El Plugin SDK moderno corrige esto: cada ruta de importación (`openclaw/plugin-sdk/\<subpath\>`)
es un módulo pequeño y autocontenido con un propósito claro y un contrato documentado.
El moderno plugin SDK corrige esto: cada ruta de importación (`openclaw/plugin-sdk/\<subpath\>`)
es un módulo pequeño y autónomo con un propósito claro y un contrato documentado.
Las interfaces heredadas de conveniencia de proveedores para canales empaquetados también han desaparecido. Las importaciones
Las interfaces heredadas de conveniencia para providers de canales integrados también han desaparecido. Importaciones
como `openclaw/plugin-sdk/slack`, `openclaw/plugin-sdk/discord`,
`openclaw/plugin-sdk/signal`, `openclaw/plugin-sdk/whatsapp`,
las interfaces helper con marca de canal y
`openclaw/plugin-sdk/telegram-core` eran atajos privados del monorepo, no
interfaces de utilidades con marca de canal, y
`openclaw/plugin-sdk/telegram-core` eran atajos privados del mono-repo, no
contratos estables para plugins. Usa en su lugar subrutas genéricas y específicas del SDK. Dentro del
workspace de plugins empaquetados, mantén los helpers propiedad del proveedor en el propio
espacio de trabajo de plugins integrados, mantén las utilidades propias del provider en el propio
`api.ts` o `runtime-api.ts` de ese plugin.
Ejemplos actuales de proveedores empaquetados:
Ejemplos actuales de providers integrados:
- Anthropic mantiene los helpers de stream específicos de Claude en su propia interfaz `api.ts` /
- Anthropic mantiene las utilidades de flujo específicas de Claude en su propia interfaz `api.ts` /
`contract-api.ts`
- OpenAI mantiene constructores de proveedores, helpers de modelo predeterminado y constructores de proveedores
en tiempo real en su propio `api.ts`
- OpenRouter mantiene el constructor de proveedor y los helpers de onboarding/configuración en su propio
- OpenAI mantiene los builders de provider, las utilidades de modelo predeterminado y los builders del provider
realtime en su propio `api.ts`
- OpenRouter mantiene el builder del provider y las utilidades de onboarding/configuración en su propio
`api.ts`
## Cómo migrar
<Steps>
<Step title="Auditar el comportamiento de fallback del wrapper de Windows">
Si tu plugin usa `openclaw/plugin-sdk/windows-spawn`, los wrappers de Windows
`.cmd`/`.bat` no resueltos ahora fallan de forma cerrada a menos que pases explícitamente
<Step title="Audita el comportamiento de reserva del wrapper de Windows">
Si tu plugin usa `openclaw/plugin-sdk/windows-spawn`, los wrappers no resueltos de Windows
`.cmd`/`.bat` ahora fallan de forma cerrada a menos que pases explícitamente
`allowShellFallback: true`.
```typescript
@ -86,19 +86,19 @@ Ejemplos actuales de proveedores empaquetados:
// Después
const program = applyWindowsSpawnProgramPolicy({
candidate,
// Establece esto solo para llamadas de compatibilidad de confianza que
// aceptan intencionalmente el fallback mediado por shell.
// Establece esto solo para llamadores de compatibilidad confiables que
// aceptan intencionalmente la reserva mediada por shell.
allowShellFallback: true,
});
```
Si tu llamada no depende intencionalmente del fallback de shell, no establezcas
`allowShellFallback` y gestiona en su lugar el error lanzado.
Si tu llamador no depende intencionalmente de la reserva por shell, no establezcas
`allowShellFallback` y maneja en su lugar el error lanzado.
</Step>
<Step title="Encontrar importaciones obsoletas">
Busca en tu plugin importaciones de cualquiera de las dos superficies obsoletas:
<Step title="Encuentra las importaciones obsoletas">
Busca en tu plugin las importaciones desde cualquiera de las dos superficies obsoletas:
```bash
grep -r "plugin-sdk/compat" my-plugin/
@ -107,11 +107,11 @@ Ejemplos actuales de proveedores empaquetados:
</Step>
<Step title="Reemplazar con importaciones específicas">
Cada exportación de la superficie antigua se asigna a una ruta de importación moderna específica:
<Step title="Sustitúyelas por importaciones específicas">
Cada exportación de la superficie anterior corresponde a una ruta de importación moderna específica:
```typescript
// Antes (capa obsoleta de compatibilidad hacia atrás)
// Antes (capa obsoleta de compatibilidad con versiones anteriores)
import {
createChannelReplyPipeline,
createPluginRuntimeStore,
@ -124,7 +124,7 @@ Ejemplos actuales de proveedores empaquetados:
import { resolveControlCommandGate } from "openclaw/plugin-sdk/command-auth";
```
Para los helpers del lado del host, usa el runtime de plugin inyectado en lugar de importar
Para las utilidades del lado del host, usa el runtime del plugin inyectado en lugar de importar
directamente:
```typescript
@ -136,9 +136,9 @@ Ejemplos actuales de proveedores empaquetados:
const result = await api.runtime.agent.runEmbeddedPiAgent({ sessionId, prompt });
```
El mismo patrón se aplica a otros helpers heredados del puente:
El mismo patrón se aplica a otras utilidades heredadas del puente:
| Importación antigua | Equivalente moderno |
| Importación anterior | Equivalente moderno |
| --- | --- |
| `resolveAgentDir` | `api.runtime.agent.resolveAgentDir` |
| `resolveAgentWorkspaceDir` | `api.runtime.agent.resolveAgentWorkspaceDir` |
@ -146,11 +146,11 @@ Ejemplos actuales de proveedores empaquetados:
| `resolveThinkingDefault` | `api.runtime.agent.resolveThinkingDefault` |
| `resolveAgentTimeoutMs` | `api.runtime.agent.resolveAgentTimeoutMs` |
| `ensureAgentWorkspace` | `api.runtime.agent.ensureAgentWorkspace` |
| helpers del almacén de sesiones | `api.runtime.agent.session.*` |
| utilidades del almacén de sesiones | `api.runtime.agent.session.*` |
</Step>
<Step title="Compilar y probar">
<Step title="Compila y prueba">
```bash
pnpm build
pnpm test -- my-plugin/
@ -160,168 +160,176 @@ Ejemplos actuales de proveedores empaquetados:
## Referencia de rutas de importación
<Accordion title="Tabla común de rutas de importación">
<Accordion title="Tabla de rutas de importación comunes">
| Ruta de importación | Propósito | Exportaciones clave |
| --- | --- | --- |
| `plugin-sdk/plugin-entry` | Helper canónico del punto de entrada del plugin | `definePluginEntry` |
| `plugin-sdk/core` | Reexportación heredada general para definiciones/constructores de entrada de canal | `defineChannelPluginEntry`, `createChatChannelPlugin` |
| `plugin-sdk/plugin-entry` | Utilidad canónica de entrada de plugin | `definePluginEntry` |
| `plugin-sdk/core` | Reexportación general heredada para definiciones/builders de entradas de canal | `defineChannelPluginEntry`, `createChatChannelPlugin` |
| `plugin-sdk/config-schema` | Exportación del esquema de configuración raíz | `OpenClawSchema` |
| `plugin-sdk/provider-entry` | Helper de punto de entrada de proveedor único | `defineSingleProviderPluginEntry` |
| `plugin-sdk/channel-core` | Definiciones y constructores específicos de entrada de canal | `defineChannelPluginEntry`, `defineSetupPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase` |
| `plugin-sdk/setup` | Helpers compartidos del asistente de configuración | Prompts de lista permitida, constructores de estado de configuración |
| `plugin-sdk/setup-runtime` | Helpers de runtime para configuración | Adaptadores de parche de configuración seguros para importación, helpers de notas de búsqueda, `promptResolvedAllowFrom`, `splitSetupEntries`, proxies de configuración delegados |
| `plugin-sdk/setup-adapter-runtime` | Helpers del adaptador de configuración | `createEnvPatchedAccountSetupAdapter` |
| `plugin-sdk/setup-tools` | Helpers de herramientas de configuración | `formatCliCommand`, `detectBinary`, `extractArchive`, `resolveBrewExecutable`, `formatDocsLink`, `CONFIG_DIR` |
| `plugin-sdk/account-core` | Helpers de múltiples cuentas | Helpers de lista/configuración/puerta de acciones de cuenta |
| `plugin-sdk/account-id` | Helpers de ID de cuenta | `DEFAULT_ACCOUNT_ID`, normalización de ID de cuenta |
| `plugin-sdk/account-resolution` | Helpers de búsqueda de cuentas | Helpers de búsqueda de cuenta + fallback predeterminado |
| `plugin-sdk/account-helpers` | Helpers específicos de cuenta | Helpers de lista de cuentas/acciones de cuenta |
| `plugin-sdk/provider-entry` | Utilidad de entrada para un solo provider | `defineSingleProviderPluginEntry` |
| `plugin-sdk/channel-core` | Definiciones y builders específicos para entradas de canal | `defineChannelPluginEntry`, `defineSetupPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase` |
| `plugin-sdk/setup` | Utilidades compartidas del asistente de configuración | Prompts de lista de permitidos, builders de estado de configuración |
| `plugin-sdk/setup-runtime` | Utilidades de runtime para el tiempo de configuración | Adaptadores de parche de configuración seguros para importación, utilidades lookup-note, `promptResolvedAllowFrom`, `splitSetupEntries`, proxies de configuración delegada |
| `plugin-sdk/setup-adapter-runtime` | Utilidades de adaptador de configuración | `createEnvPatchedAccountSetupAdapter` |
| `plugin-sdk/setup-tools` | Utilidades de herramientas de configuración | `formatCliCommand`, `detectBinary`, `extractArchive`, `resolveBrewExecutable`, `formatDocsLink`, `CONFIG_DIR` |
| `plugin-sdk/account-core` | Utilidades para múltiples cuentas | Utilidades de lista/configuración/puerta de acciones de cuenta |
| `plugin-sdk/account-id` | Utilidades de ID de cuenta | `DEFAULT_ACCOUNT_ID`, normalización de ID de cuenta |
| `plugin-sdk/account-resolution` | Utilidades de búsqueda de cuentas | Utilidades de búsqueda de cuentas + reserva predeterminada |
| `plugin-sdk/account-helpers` | Utilidades específicas de cuenta | Utilidades de lista de cuentas/acción de cuenta |
| `plugin-sdk/channel-setup` | Adaptadores del asistente de configuración | `createOptionalChannelSetupSurface`, `createOptionalChannelSetupAdapter`, `createOptionalChannelSetupWizard`, además de `DEFAULT_ACCOUNT_ID`, `createTopLevelChannelDmPolicy`, `setSetupChannelEnabled`, `splitSetupEntries` |
| `plugin-sdk/channel-pairing` | Primitivas de emparejamiento de DM | `createChannelPairingController` |
| `plugin-sdk/channel-reply-pipeline` | Cableado de prefijo de respuesta + typing | `createChannelReplyPipeline` |
| `plugin-sdk/channel-reply-pipeline` | Cableado de prefijo de respuesta + escritura | `createChannelReplyPipeline` |
| `plugin-sdk/channel-config-helpers` | Fábricas de adaptadores de configuración | `createHybridChannelConfigAdapter` |
| `plugin-sdk/channel-config-schema` | Constructores de esquema de configuración | Tipos de esquema de configuración de canal |
| `plugin-sdk/telegram-command-config` | Helpers de configuración de comandos de Telegram | Normalización de nombres de comandos, recorte de descripciones, validación de duplicados/conflictos |
| `plugin-sdk/channel-config-schema` | Builders de esquemas de configuración | Tipos de esquema de configuración de canal |
| `plugin-sdk/telegram-command-config` | Utilidades de configuración de comandos de Telegram | Normalización de nombres de comando, recorte de descripciones, validación de duplicados/conflictos |
| `plugin-sdk/channel-policy` | Resolución de políticas de grupo/DM | `resolveChannelGroupRequireMention` |
| `plugin-sdk/channel-lifecycle` | Seguimiento del estado de cuentas | `createAccountStatusSink` |
| `plugin-sdk/inbound-envelope` | Helpers de sobre entrante | Helpers compartidos de ruta + constructor de sobre |
| `plugin-sdk/inbound-reply-dispatch` | Helpers de respuesta entrante | Helpers compartidos de registrar y despachar |
| `plugin-sdk/messaging-targets` | Análisis de destinos de mensajería | Helpers de análisis/coincidencia de destinos |
| `plugin-sdk/outbound-media` | Helpers de medios salientes | Carga compartida de medios salientes |
| `plugin-sdk/outbound-runtime` | Helpers de runtime saliente | Helpers delegados de identidad/envío salientes |
| `plugin-sdk/thread-bindings-runtime` | Helpers de enlaces de hilo | Ciclo de vida de enlaces de hilo y helpers de adaptador |
| `plugin-sdk/agent-media-payload` | Helpers heredados de payload de medios | Constructor de payload de medios de agente para estructuras heredadas de campos |
| `plugin-sdk/channel-lifecycle` | Seguimiento de estado de cuenta | `createAccountStatusSink` |
| `plugin-sdk/inbound-envelope` | Utilidades de envoltura de entrada | Utilidades compartidas de ruta + builder de envoltura |
| `plugin-sdk/inbound-reply-dispatch` | Utilidades de respuesta entrante | Utilidades compartidas de registrar y despachar |
| `plugin-sdk/messaging-targets` | Análisis de destinos de mensajería | Utilidades de análisis/coincidencia de destinos |
| `plugin-sdk/outbound-media` | Utilidades de medios salientes | Carga compartida de medios salientes |
| `plugin-sdk/outbound-runtime` | Utilidades de runtime saliente | Utilidades de identidad saliente/delegado de envío |
| `plugin-sdk/thread-bindings-runtime` | Utilidades de vinculación de hilos | Utilidades de ciclo de vida y adaptador de vinculación de hilos |
| `plugin-sdk/agent-media-payload` | Utilidades heredadas de payload de medios | Builder de payload de medios de agente para diseños heredados de campos |
| `plugin-sdk/channel-runtime` | Shim de compatibilidad obsoleto | Solo utilidades heredadas de runtime de canal |
| `plugin-sdk/channel-send-result` | Tipos de resultado de envío | Tipos de resultado de respuesta |
| `plugin-sdk/runtime-store` | Almacenamiento persistente del plugin | `createPluginRuntimeStore` |
| `plugin-sdk/runtime` | Helpers amplios de runtime | Helpers de runtime/logging/copias de seguridad/instalación de plugins |
| `plugin-sdk/runtime-env` | Helpers específicos del entorno de runtime | Logger/entorno de runtime, helpers de timeout, reintento y backoff |
| `plugin-sdk/plugin-runtime` | Helpers compartidos de runtime de plugin | Helpers de plugin para comandos/hooks/http/interactivo |
| `plugin-sdk/hook-runtime` | Helpers del pipeline de hooks | Helpers compartidos del pipeline de hooks webhook/internos |
| `plugin-sdk/lazy-runtime` | Helpers de runtime diferido | `createLazyRuntimeModule`, `createLazyRuntimeMethod`, `createLazyRuntimeMethodBinder`, `createLazyRuntimeNamedExport`, `createLazyRuntimeSurface` |
| `plugin-sdk/process-runtime` | Helpers de procesos | Helpers compartidos de exec |
| `plugin-sdk/cli-runtime` | Helpers de runtime de CLI | Formato de comandos, esperas, helpers de versión |
| `plugin-sdk/gateway-runtime` | Helpers de gateway | Cliente del gateway y helpers de parche de estado de canal |
| `plugin-sdk/config-runtime` | Helpers de configuración | Helpers de carga/escritura de configuración |
| `plugin-sdk/telegram-command-config` | Helpers de comandos de Telegram | Helpers de validación de comandos de Telegram estables ante fallback cuando la superficie de contrato empaquetada de Telegram no está disponible |
| `plugin-sdk/approval-runtime` | Helpers de prompts de aprobación | Payload de aprobación de exec/plugin, helpers de capacidad/perfil de aprobación, helpers de enrutamiento/runtime de aprobación nativa |
| `plugin-sdk/approval-auth-runtime` | Helpers de autenticación de aprobación | Resolución de aprobadores, autenticación de acciones del mismo chat |
| `plugin-sdk/approval-client-runtime` | Helpers de cliente de aprobación | Helpers de perfil/filtro de aprobación nativa de exec |
| `plugin-sdk/approval-delivery-runtime` | Helpers de entrega de aprobación | Adaptadores de capacidad/entrega de aprobación nativa |
| `plugin-sdk/approval-native-runtime` | Helpers de destino de aprobación | Helpers de destino/vinculación de cuenta de aprobación nativa |
| `plugin-sdk/approval-reply-runtime` | Helpers de respuesta de aprobación | Helpers de payload de respuesta de aprobación de exec/plugin |
| `plugin-sdk/security-runtime` | Helpers de seguridad | Helpers compartidos de confianza, bloqueo de DM, contenido externo y recopilación de secretos |
| `plugin-sdk/ssrf-policy` | Helpers de política SSRF | Helpers de lista permitida de hosts y política de red privada |
| `plugin-sdk/ssrf-runtime` | Helpers de runtime SSRF | Helpers de dispatcher fijado, fetch protegido y política SSRF |
| `plugin-sdk/collection-runtime` | Helpers de caché acotada | `pruneMapToMaxSize` |
| `plugin-sdk/diagnostic-runtime` | Helpers de bloqueo de diagnóstico | `isDiagnosticFlagEnabled`, `isDiagnosticsEnabled` |
| `plugin-sdk/error-runtime` | Helpers de formato de errores | `formatUncaughtError`, `isApprovalNotFoundError`, helpers de grafo de errores |
| `plugin-sdk/fetch-runtime` | Helpers de fetch/proxy envueltos | `resolveFetch`, helpers de proxy |
| `plugin-sdk/host-runtime` | Helpers de normalización de host | `normalizeHostname`, `normalizeScpRemoteHost` |
| `plugin-sdk/retry-runtime` | Helpers de reintento | `RetryConfig`, `retryAsync`, ejecutores de política |
| `plugin-sdk/allow-from` | Formato de lista permitida | `formatAllowFromLowercase` |
| `plugin-sdk/allowlist-resolution` | Asignación de entradas de lista permitida | `mapAllowlistResolutionInputs` |
| `plugin-sdk/command-auth` | Bloqueo de comandos y helpers de superficie de comandos | `resolveControlCommandGate`, helpers de autorización del remitente, helpers del registro de comandos |
| `plugin-sdk/secret-input` | Análisis de entradas secretas | Helpers de entrada secreta |
| `plugin-sdk/webhook-ingress` | Helpers de solicitudes webhook | Utilidades de destino de webhook |
| `plugin-sdk/webhook-request-guards` | Helpers de protección del cuerpo de webhook | Helpers de lectura/límite del cuerpo de la solicitud |
| `plugin-sdk/runtime-store` | Almacenamiento persistente de plugins | `createPluginRuntimeStore` |
| `plugin-sdk/runtime` | Utilidades amplias de runtime | Utilidades de runtime/logging/respaldo/instalación de plugins |
| `plugin-sdk/runtime-env` | Utilidades específicas de entorno de runtime | Entorno logger/runtime, utilidades de timeout, retry y backoff |
| `plugin-sdk/plugin-runtime` | Utilidades compartidas de runtime de plugins | Utilidades de comandos/hooks/http/interacción de plugins |
| `plugin-sdk/hook-runtime` | Utilidades de pipeline de hooks | Utilidades compartidas de pipeline de webhook/hook interno |
| `plugin-sdk/lazy-runtime` | Utilidades de runtime diferido | `createLazyRuntimeModule`, `createLazyRuntimeMethod`, `createLazyRuntimeMethodBinder`, `createLazyRuntimeNamedExport`, `createLazyRuntimeSurface` |
| `plugin-sdk/process-runtime` | Utilidades de procesos | Utilidades compartidas de ejecución |
| `plugin-sdk/cli-runtime` | Utilidades de runtime de CLI | Formato de comandos, esperas, utilidades de versión |
| `plugin-sdk/gateway-runtime` | Utilidades de gateway | Cliente de gateway y utilidades de parche de estado de canal |
| `plugin-sdk/config-runtime` | Utilidades de configuración | Utilidades de carga/escritura de configuración |
| `plugin-sdk/telegram-command-config` | Utilidades de comandos de Telegram | Utilidades de validación de comandos de Telegram con reserva estable cuando la superficie de contrato integrada de Telegram no está disponible |
| `plugin-sdk/approval-runtime` | Utilidades de prompts de aprobación | Payload de aprobación de ejecución/plugin, utilidades de capacidad/perfil de aprobación, utilidades nativas de enrutamiento/runtime de aprobación |
| `plugin-sdk/approval-auth-runtime` | Utilidades de autenticación de aprobación | Resolución de aprobador, autenticación de acciones en el mismo chat |
| `plugin-sdk/approval-client-runtime` | Utilidades de cliente de aprobación | Utilidades nativas de perfil/filtro de aprobación de ejecución |
| `plugin-sdk/approval-delivery-runtime` | Utilidades de entrega de aprobación | Adaptadores nativos de capacidad/entrega de aprobación |
| `plugin-sdk/approval-native-runtime` | Utilidades de destino de aprobación | Utilidades nativas de vinculación de destino/cuenta de aprobación |
| `plugin-sdk/approval-reply-runtime` | Utilidades de respuesta de aprobación | Utilidades de payload de respuesta de aprobación de ejecución/plugin |
| `plugin-sdk/security-runtime` | Utilidades de seguridad | Utilidades compartidas de confianza, control de DM, contenido externo y recolección de secretos |
| `plugin-sdk/ssrf-policy` | Utilidades de política SSRF | Utilidades de lista de permitidos de hosts y política de red privada |
| `plugin-sdk/ssrf-runtime` | Utilidades de runtime SSRF | Dispatcher fijado, fetch protegido, utilidades de política SSRF |
| `plugin-sdk/collection-runtime` | Utilidades de caché acotada | `pruneMapToMaxSize` |
| `plugin-sdk/diagnostic-runtime` | Utilidades de control de diagnósticos | `isDiagnosticFlagEnabled`, `isDiagnosticsEnabled` |
| `plugin-sdk/error-runtime` | Utilidades de formateo de errores | `formatUncaughtError`, `isApprovalNotFoundError`, utilidades de grafo de errores |
| `plugin-sdk/fetch-runtime` | Utilidades de fetch/proxy envuelto | `resolveFetch`, utilidades de proxy |
| `plugin-sdk/host-runtime` | Utilidades de normalización del host | `normalizeHostname`, `normalizeScpRemoteHost` |
| `plugin-sdk/retry-runtime` | Utilidades de retry | `RetryConfig`, `retryAsync`, ejecutores de políticas |
| `plugin-sdk/allow-from` | Formato de lista de permitidos | `formatAllowFromLowercase` |
| `plugin-sdk/allowlist-resolution` | Mapeo de entradas de lista de permitidos | `mapAllowlistResolutionInputs` |
| `plugin-sdk/command-auth` | Control de comandos y utilidades de superficie de comandos | `resolveControlCommandGate`, utilidades de autorización del remitente, utilidades de registro de comandos |
| `plugin-sdk/secret-input` | Análisis de entrada secreta | Utilidades de entrada secreta |
| `plugin-sdk/webhook-ingress` | Utilidades de solicitudes webhook | Utilidades de destino de webhook |
| `plugin-sdk/webhook-request-guards` | Utilidades de guardas del cuerpo webhook | Utilidades de lectura/límite del cuerpo de la solicitud |
| `plugin-sdk/reply-runtime` | Runtime compartido de respuesta | Despacho entrante, heartbeat, planificador de respuesta, fragmentación |
| `plugin-sdk/reply-dispatch-runtime` | Helpers específicos de despacho de respuesta | Helpers de finalización + despacho del proveedor |
| `plugin-sdk/reply-history` | Helpers del historial de respuestas | `buildHistoryContext`, `buildPendingHistoryContextFromMap`, `recordPendingHistoryEntry`, `clearHistoryEntriesIfEnabled` |
| `plugin-sdk/reply-dispatch-runtime` | Utilidades específicas de despacho de respuesta | Utilidades de finalización + despacho de provider |
| `plugin-sdk/reply-history` | Utilidades de historial de respuestas | `buildHistoryContext`, `buildPendingHistoryContextFromMap`, `recordPendingHistoryEntry`, `clearHistoryEntriesIfEnabled` |
| `plugin-sdk/reply-reference` | Planificación de referencias de respuesta | `createReplyReferencePlanner` |
| `plugin-sdk/reply-chunking` | Helpers de fragmentación de respuestas | Helpers de fragmentación de texto/markdown |
| `plugin-sdk/session-store-runtime` | Helpers del almacén de sesiones | Helpers de ruta del almacén + updated-at |
| `plugin-sdk/state-paths` | Helpers de rutas de estado | Helpers de directorio de estado y OAuth |
| `plugin-sdk/routing` | Helpers de enrutamiento/clave de sesión | `resolveAgentRoute`, `buildAgentSessionKey`, `resolveDefaultAgentBoundAccountId`, helpers de normalización de clave de sesión |
| `plugin-sdk/status-helpers` | Helpers de estado de canal | Constructores de resumen de estado de canal/cuenta, valores predeterminados del estado de runtime, helpers de metadatos de incidencias |
| `plugin-sdk/target-resolver-runtime` | Helpers de resolución de destinos | Helpers compartidos de resolución de destinos |
| `plugin-sdk/string-normalization-runtime` | Helpers de normalización de cadenas | Helpers de normalización de slug/cadenas |
| `plugin-sdk/request-url` | Helpers de URL de solicitud | Extrae URLs de cadena de entradas tipo request |
| `plugin-sdk/run-command` | Helpers de comandos temporizados | Ejecutor de comandos temporizados con stdout/stderr normalizados |
| `plugin-sdk/reply-chunking` | Utilidades de fragmentación de respuestas | Utilidades de fragmentación de texto/markdown |
| `plugin-sdk/session-store-runtime` | Utilidades de almacén de sesiones | Utilidades de ruta del almacén + fecha de actualización |
| `plugin-sdk/state-paths` | Utilidades de rutas de estado | Utilidades de directorios de estado y OAuth |
| `plugin-sdk/routing` | Utilidades de enrutamiento/clave de sesión | `resolveAgentRoute`, `buildAgentSessionKey`, `resolveDefaultAgentBoundAccountId`, utilidades de normalización de clave de sesión |
| `plugin-sdk/status-helpers` | Utilidades de estado de canal | Builders de resumen de estado de canal/cuenta, valores predeterminados de estado de runtime, utilidades de metadatos de incidencias |
| `plugin-sdk/target-resolver-runtime` | Utilidades de resolución de destinos | Utilidades compartidas de resolución de destinos |
| `plugin-sdk/string-normalization-runtime` | Utilidades de normalización de cadenas | Utilidades de normalización de slug/cadenas |
| `plugin-sdk/request-url` | Utilidades de URL de solicitud | Extraer URL de cadena de entradas similares a solicitudes |
| `plugin-sdk/run-command` | Utilidades de comandos temporizados | Ejecutor de comandos temporizados con stdout/stderr normalizados |
| `plugin-sdk/param-readers` | Lectores de parámetros | Lectores comunes de parámetros de herramienta/CLI |
| `plugin-sdk/tool-send` | Extracción de envío de herramientas | Extrae campos canónicos de destino de envío de argumentos de herramienta |
| `plugin-sdk/temp-path` | Helpers de rutas temporales | Helpers compartidos de rutas temporales para descargas |
| `plugin-sdk/logging-core` | Helpers de logging | Logger del subsistema y helpers de redacción |
| `plugin-sdk/markdown-table-runtime` | Helpers de tablas Markdown | Helpers de modo de tabla Markdown |
| `plugin-sdk/tool-send` | Extracción de envío de herramientas | Extraer campos canónicos de destino de envío de argumentos de herramientas |
| `plugin-sdk/temp-path` | Utilidades de rutas temporales | Utilidades compartidas de rutas temporales de descarga |
| `plugin-sdk/logging-core` | Utilidades de logging | Logger de subsistema y utilidades de redacción |
| `plugin-sdk/markdown-table-runtime` | Utilidades de tablas Markdown | Utilidades de modo de tabla Markdown |
| `plugin-sdk/reply-payload` | Tipos de respuesta de mensajes | Tipos de payload de respuesta |
| `plugin-sdk/provider-setup` | Helpers seleccionados de configuración de proveedores locales/autohospedados | Helpers de descubrimiento/configuración de proveedores autohospedados |
| `plugin-sdk/self-hosted-provider-setup` | Helpers específicos de configuración de proveedores autohospedados compatibles con OpenAI | Los mismos helpers de descubrimiento/configuración de proveedores autohospedados |
| `plugin-sdk/provider-auth-runtime` | Helpers de autenticación de proveedores en runtime | Helpers de resolución de claves de API en runtime |
| `plugin-sdk/provider-auth-api-key` | Helpers de configuración de claves de API de proveedores | Helpers de onboarding/escritura de perfiles para claves de API |
| `plugin-sdk/provider-auth-result` | Helpers de resultados de autenticación de proveedores | Constructor estándar de resultados de autenticación OAuth |
| `plugin-sdk/provider-auth-login` | Helpers de inicio de sesión interactivo de proveedores | Helpers compartidos de inicio de sesión interactivo |
| `plugin-sdk/provider-env-vars` | Helpers de variables de entorno de proveedores | Helpers de búsqueda de variables de entorno de autenticación de proveedores |
| `plugin-sdk/provider-model-shared` | Helpers compartidos de modelos/replay de proveedores | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, constructores compartidos de políticas de replay, helpers de endpoint del proveedor y helpers de normalización de ID de modelo |
| `plugin-sdk/provider-catalog-shared` | Helpers compartidos de catálogo de proveedores | `findCatalogTemplate`, `buildSingleProviderApiKeyCatalog`, `supportsNativeStreamingUsageCompat`, `applyProviderNativeStreamingUsageCompat` |
| `plugin-sdk/provider-onboard` | Parches de onboarding de proveedores | Helpers de configuración de onboarding |
| `plugin-sdk/provider-http` | Helpers HTTP de proveedores | Helpers genéricos de HTTP/capacidades de endpoint de proveedores |
| `plugin-sdk/provider-web-fetch` | Helpers de proveedores de obtención web | Helpers de registro/caché de proveedores de obtención web |
| `plugin-sdk/provider-web-search` | Helpers de proveedores de búsqueda web | Helpers de registro/caché/configuración de proveedores de búsqueda web |
| `plugin-sdk/provider-tools` | Helpers de compatibilidad de herramientas/esquema de proveedores | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, limpieza + diagnósticos de esquemas Gemini y helpers de compatibilidad xAI como `resolveXaiModelCompatPatch` / `applyXaiModelCompat` |
| `plugin-sdk/provider-usage` | Helpers de uso de proveedores | `fetchClaudeUsage`, `fetchGeminiUsage`, `fetchGithubCopilotUsage` y otros helpers de uso de proveedores |
| `plugin-sdk/provider-stream` | Helpers de envoltorios de stream de proveedores | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, tipos de envoltorio de stream y helpers compartidos de envoltorio para Anthropic/Bedrock/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot |
| `plugin-sdk/provider-setup` | Utilidades seleccionadas de configuración de provider local/autohospedado | Utilidades de detección/configuración de provider autohospedado |
| `plugin-sdk/self-hosted-provider-setup` | Utilidades específicas de configuración de provider autohospedado compatible con OpenAI | Las mismas utilidades de detección/configuración de provider autohospedado |
| `plugin-sdk/provider-auth-runtime` | Utilidades de autenticación de runtime de provider | Utilidades de resolución de API key en runtime |
| `plugin-sdk/provider-auth-api-key` | Utilidades de configuración de API key de provider | Utilidades de onboarding/escritura de perfil de API key |
| `plugin-sdk/provider-auth-result` | Utilidades de resultado de autenticación de provider | Builder estándar de resultado de autenticación OAuth |
| `plugin-sdk/provider-auth-login` | Utilidades de inicio de sesión interactivo de provider | Utilidades compartidas de inicio de sesión interactivo |
| `plugin-sdk/provider-env-vars` | Utilidades de variables de entorno de provider | Utilidades de búsqueda de variables de entorno de autenticación de provider |
| `plugin-sdk/provider-model-shared` | Utilidades compartidas de modelo/replay de provider | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, builders compartidos de política de replay, utilidades de endpoint de provider y utilidades de normalización de ID de modelo |
| `plugin-sdk/provider-catalog-shared` | Utilidades compartidas de catálogo de provider | `findCatalogTemplate`, `buildSingleProviderApiKeyCatalog`, `supportsNativeStreamingUsageCompat`, `applyProviderNativeStreamingUsageCompat` |
| `plugin-sdk/provider-onboard` | Parches de onboarding de provider | Utilidades de configuración de onboarding |
| `plugin-sdk/provider-http` | Utilidades HTTP de provider | Utilidades genéricas HTTP/capacidad de endpoint de provider |
| `plugin-sdk/provider-web-fetch` | Utilidades web-fetch de provider | Utilidades de registro/caché de provider web-fetch |
| `plugin-sdk/provider-web-search` | Utilidades web-search de provider | Utilidades de registro/caché/configuración de provider web-search |
| `plugin-sdk/provider-tools` | Utilidades de compatibilidad de herramientas/esquemas de provider | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, limpieza de esquemas Gemini + diagnósticos, y utilidades de compatibilidad de xAI como `resolveXaiModelCompatPatch` / `applyXaiModelCompat` |
| `plugin-sdk/provider-usage` | Utilidades de uso de provider | `fetchClaudeUsage`, `fetchGeminiUsage`, `fetchGithubCopilotUsage` y otras utilidades de uso de provider |
| `plugin-sdk/provider-stream` | Utilidades wrapper de streams de provider | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, tipos de wrapper de stream y utilidades wrapper compartidas de Anthropic/Bedrock/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot |
| `plugin-sdk/keyed-async-queue` | Cola asíncrona ordenada | `KeyedAsyncQueue` |
| `plugin-sdk/media-runtime` | Helpers compartidos de medios | Helpers de fetch/transformación/almacenamiento de medios más constructores de payload de medios |
| `plugin-sdk/media-understanding` | Helpers de comprensión de medios | Tipos de proveedores de comprensión de medios más exportaciones helper orientadas al proveedor para imagen/audio |
| `plugin-sdk/text-runtime` | Helpers compartidos de texto | Eliminación de texto visible para el asistente, helpers de renderizado/fragmentación/tabla Markdown, helpers de redacción, helpers de etiquetas de directiva, utilidades de texto seguro y helpers relacionados de texto/logging |
| `plugin-sdk/text-chunking` | Helpers de fragmentación de texto | Helper de fragmentación de texto saliente |
| `plugin-sdk/speech` | Helpers de voz | Tipos de proveedores de voz más helpers orientados al proveedor para directivas, registro y validación |
| `plugin-sdk/speech-core` | Núcleo compartido de voz | Tipos de proveedores de voz, registro, directivas, normalización |
| `plugin-sdk/realtime-transcription` | Helpers de transcripción en tiempo real | Tipos de proveedores y helpers de registro |
| `plugin-sdk/realtime-voice` | Helpers de voz en tiempo real | Tipos de proveedores y helpers de registro |
| `plugin-sdk/image-generation-core` | Núcleo compartido de generación de imágenes | Tipos, failover, autenticación y helpers de registro de generación de imágenes |
| `plugin-sdk/music-generation` | Helpers de generación de música | Tipos de proveedor/solicitud/resultado de generación de música |
| `plugin-sdk/music-generation-core` | Núcleo compartido de generación de música | Tipos de generación de música, helpers de failover, búsqueda de proveedor y análisis de referencias de modelo |
| `plugin-sdk/video-generation` | Helpers de generación de video | Tipos de proveedor/solicitud/resultado de generación de video |
| `plugin-sdk/video-generation-core` | Núcleo compartido de generación de video | Tipos de generación de video, helpers de failover, búsqueda de proveedor y análisis de referencias de modelo |
| `plugin-sdk/interactive-runtime` | Helpers de respuestas interactivas | Normalización/reducción de payload de respuestas interactivas |
| `plugin-sdk/channel-config-primitives` | Primitivas de configuración de canal | Primitivas específicas de esquema de configuración de canal |
| `plugin-sdk/channel-config-writes` | Helpers de escritura de configuración de canal | Helpers de autorización para escritura de configuración de canal |
| `plugin-sdk/media-runtime` | Utilidades compartidas de medios | Utilidades de fetch/transformación/almacenamiento de medios además de builders de payload de medios |
| `plugin-sdk/media-generation-runtime` | Utilidades compartidas de generación de medios | Utilidades compartidas de failover, selección de candidatos y mensajes de modelo faltante para generación de imagen/video/música |
| `plugin-sdk/media-understanding` | Utilidades de comprensión de medios | Tipos de provider de comprensión de medios además de exportaciones de utilidades de imagen/audio orientadas al provider |
| `plugin-sdk/text-runtime` | Utilidades compartidas de texto | Eliminación de texto visible para el asistente, utilidades de renderizado/fragmentación/tablas Markdown, utilidades de redacción, utilidades de etiquetas de directivas, utilidades de texto seguro y utilidades relacionadas de texto/logging |
| `plugin-sdk/text-chunking` | Utilidades de fragmentación de texto | Utilidad de fragmentación de texto saliente |
| `plugin-sdk/speech` | Utilidades de voz | Tipos de provider de voz además de utilidades de directivas, registro y validación orientadas al provider |
| `plugin-sdk/speech-core` | Núcleo compartido de voz | Tipos de provider de voz, registro, directivas, normalización |
| `plugin-sdk/realtime-transcription` | Utilidades de transcripción en tiempo real | Tipos de provider y utilidades de registro |
| `plugin-sdk/realtime-voice` | Utilidades de voz en tiempo real | Tipos de provider y utilidades de registro |
| `plugin-sdk/image-generation-core` | Núcleo compartido de generación de imágenes | Tipos de generación de imágenes, failover, autenticación y utilidades de registro |
| `plugin-sdk/music-generation` | Utilidades de generación de música | Tipos de provider/solicitud/resultado para generación de música |
| `plugin-sdk/music-generation-core` | Núcleo compartido de generación de música | Tipos de generación de música, utilidades de failover, búsqueda de provider y análisis de model-ref |
| `plugin-sdk/video-generation` | Utilidades de generación de video | Tipos de provider/solicitud/resultado para generación de video |
| `plugin-sdk/video-generation-core` | Núcleo compartido de generación de video | Tipos de generación de video, utilidades de failover, búsqueda de provider y análisis de model-ref |
| `plugin-sdk/interactive-runtime` | Utilidades de respuestas interactivas | Normalización/reducción de payload de respuesta interactiva |
| `plugin-sdk/channel-config-primitives` | Primitivas de configuración de canal | Primitivas específicas de config-schema de canal |
| `plugin-sdk/channel-config-writes` | Utilidades de escritura de configuración de canal | Utilidades de autorización para escritura de configuración de canal |
| `plugin-sdk/channel-plugin-common` | Preludio compartido de canal | Exportaciones compartidas de preludio de plugin de canal |
| `plugin-sdk/channel-status` | Helpers de estado de canal | Helpers compartidos de instantánea/resumen de estado de canal |
| `plugin-sdk/allowlist-config-edit` | Helpers de configuración de lista permitida | Helpers de edición/lectura de configuración de lista permitida |
| `plugin-sdk/group-access` | Helpers de acceso a grupos | Helpers compartidos de decisión de acceso a grupos |
| `plugin-sdk/direct-dm` | Helpers de DM directo | Helpers compartidos de autenticación/protección de DM directo |
| `plugin-sdk/extension-shared` | Helpers compartidos de extensión | Primitivas helper de canal/estado pasivo |
| `plugin-sdk/webhook-targets` | Helpers de destinos webhook | Registro de destinos webhook y helpers de instalación de rutas |
| `plugin-sdk/webhook-path` | Helpers de rutas webhook | Helpers de normalización de rutas webhook |
| `plugin-sdk/web-media` | Helpers compartidos de medios web | Helpers de carga de medios remotos/locales |
| `plugin-sdk/zod` | Reexportación de Zod | `zod` reexportado para consumidores del Plugin SDK |
| `plugin-sdk/memory-core` | Helpers empaquetados de memory-core | Superficie helper de gestor/configuración/archivo/CLI de memoria |
| `plugin-sdk/channel-status` | Utilidades de estado de canal | Utilidades compartidas de instantánea/resumen de estado de canal |
| `plugin-sdk/allowlist-config-edit` | Utilidades de configuración de lista de permitidos | Utilidades de edición/lectura de configuración de lista de permitidos |
| `plugin-sdk/group-access` | Utilidades de acceso a grupos | Utilidades compartidas de decisión de acceso a grupos |
| `plugin-sdk/direct-dm` | Utilidades de DM directo | Utilidades compartidas de autenticación/protección de DM directo |
| `plugin-sdk/extension-shared` | Utilidades compartidas de extensiones | Primitivas auxiliares de canal/estado pasivo |
| `plugin-sdk/webhook-targets` | Utilidades de destinos webhook | Registro de destinos webhook y utilidades de instalación de rutas |
| `plugin-sdk/webhook-path` | Utilidades de rutas webhook | Utilidades de normalización de rutas webhook |
| `plugin-sdk/web-media` | Utilidades compartidas de medios web | Utilidades de carga de medios remotos/locales |
| `plugin-sdk/zod` | Reexportación de Zod | `zod` reexportado para consumidores de plugin SDK |
| `plugin-sdk/memory-core` | Utilidades integradas de memory-core | Superficie de utilidades de administrador/configuración/archivo/CLI de memoria |
| `plugin-sdk/memory-core-engine-runtime` | Fachada de runtime del motor de memoria | Fachada de runtime de índice/búsqueda de memoria |
| `plugin-sdk/memory-core-host-engine-foundation` | Motor base del host de memoria | Exportaciones del motor base del host de memoria |
| `plugin-sdk/memory-core-host-engine-embeddings` | Motor de embeddings del host de memoria | Exportaciones del motor de embeddings del host de memoria |
| `plugin-sdk/memory-core-host-engine-qmd` | Motor QMD del host de memoria | Exportaciones del motor QMD del host de memoria |
| `plugin-sdk/memory-core-host-engine-storage` | Motor de almacenamiento del host de memoria | Exportaciones del motor de almacenamiento del host de memoria |
| `plugin-sdk/memory-core-host-multimodal` | Helpers multimodales del host de memoria | Helpers multimodales del host de memoria |
| `plugin-sdk/memory-core-host-query` | Helpers de consulta del host de memoria | Helpers de consulta del host de memoria |
| `plugin-sdk/memory-core-host-secret` | Helpers de secretos del host de memoria | Helpers de secretos del host de memoria |
| `plugin-sdk/memory-core-host-status` | Helpers de estado del host de memoria | Helpers de estado del host de memoria |
| `plugin-sdk/memory-core-host-runtime-cli` | Runtime CLI del host de memoria | Helpers de runtime CLI del host de memoria |
| `plugin-sdk/memory-core-host-runtime-core` | Runtime central del host de memoria | Helpers de runtime central del host de memoria |
| `plugin-sdk/memory-core-host-runtime-files` | Helpers de archivos/runtime del host de memoria | Helpers de archivos/runtime del host de memoria |
| `plugin-sdk/memory-lancedb` | Helpers empaquetados de memory-lancedb | Superficie helper de memory-lancedb |
| `plugin-sdk/testing` | Utilidades de prueba | Helpers y mocks de prueba |
| `plugin-sdk/memory-core-host-multimodal` | Utilidades multimodales del host de memoria | Utilidades multimodales del host de memoria |
| `plugin-sdk/memory-core-host-query` | Utilidades de consulta del host de memoria | Utilidades de consulta del host de memoria |
| `plugin-sdk/memory-core-host-secret` | Utilidades de secretos del host de memoria | Utilidades de secretos del host de memoria |
| `plugin-sdk/memory-core-host-events` | Utilidades de diario de eventos del host de memoria | Utilidades de diario de eventos del host de memoria |
| `plugin-sdk/memory-core-host-status` | Utilidades de estado del host de memoria | Utilidades de estado del host de memoria |
| `plugin-sdk/memory-core-host-runtime-cli` | Runtime CLI del host de memoria | Utilidades de runtime CLI del host de memoria |
| `plugin-sdk/memory-core-host-runtime-core` | Runtime principal del host de memoria | Utilidades de runtime principal del host de memoria |
| `plugin-sdk/memory-core-host-runtime-files` | Utilidades de archivos/runtime del host de memoria | Utilidades de archivos/runtime del host de memoria |
| `plugin-sdk/memory-host-core` | Alias de runtime principal del host de memoria | Alias neutral respecto al proveedor para utilidades de runtime principal del host de memoria |
| `plugin-sdk/memory-host-events` | Alias de diario de eventos del host de memoria | Alias neutral respecto al proveedor para utilidades de diario de eventos del host de memoria |
| `plugin-sdk/memory-host-files` | Alias de archivos/runtime del host de memoria | Alias neutral respecto al proveedor para utilidades de archivos/runtime del host de memoria |
| `plugin-sdk/memory-host-markdown` | Utilidades de markdown administrado | Utilidades compartidas de markdown administrado para plugins adyacentes a memoria |
| `plugin-sdk/memory-host-search` | Fachada de búsqueda de memoria activa | Fachada de runtime diferido del administrador de búsqueda de memoria activa |
| `plugin-sdk/memory-host-status` | Alias de estado del host de memoria | Alias neutral respecto al proveedor para utilidades de estado del host de memoria |
| `plugin-sdk/memory-lancedb` | Utilidades integradas de memory-lancedb | Superficie de utilidades de memory-lancedb |
| `plugin-sdk/testing` | Utilidades de prueba | Utilidades y mocks de prueba |
</Accordion>
Esta tabla es intencionalmente el subconjunto común de migración, no toda la
superficie del SDK. La lista completa de más de 200 puntos de entrada se encuentra en
Esta tabla es intencionalmente el subconjunto común de migración, no la superficie completa del SDK.
La lista completa de más de 200 puntos de entrada se encuentra en
`scripts/lib/plugin-sdk-entrypoints.json`.
Esa lista aún incluye algunas interfaces helper de plugins empaquetados como
Esa lista todavía incluye algunas interfaces de utilidades de plugins integrados como
`plugin-sdk/feishu`, `plugin-sdk/feishu-setup`, `plugin-sdk/zalo`,
`plugin-sdk/zalo-setup` y `plugin-sdk/matrix*`. Siguen exportándose para
mantenimiento y compatibilidad de plugins empaquetados, pero se omiten intencionadamente
de la tabla común de migración y no son el objetivo recomendado para
`plugin-sdk/zalo-setup` y `plugin-sdk/matrix*`. Estas siguen exportándose para
mantenimiento y compatibilidad de plugins integrados, pero se omiten intencionalmente
de la tabla común de migración y no son el destino recomendado para
código nuevo de plugins.
La misma regla se aplica a otras familias de helpers empaquetados como:
La misma regla se aplica a otras familias de utilidades integradas como:
- helpers de soporte de navegador: `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/browser-support`
- utilidades de compatibilidad con browser: `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/browser-support`
- Matrix: `plugin-sdk/matrix*`
- LINE: `plugin-sdk/line*`
- IRC: `plugin-sdk/irc*`
- superficies de helpers/plugins empaquetados como `plugin-sdk/googlechat`,
- superficies de utilidades/plugins integrados como `plugin-sdk/googlechat`,
`plugin-sdk/zalouser`, `plugin-sdk/bluebubbles*`,
`plugin-sdk/mattermost*`, `plugin-sdk/msteams`,
`plugin-sdk/nextcloud-talk`, `plugin-sdk/nostr`, `plugin-sdk/tlon`,
@ -330,21 +338,21 @@ La misma regla se aplica a otras familias de helpers empaquetados como:
`plugin-sdk/diagnostics-otel`, `plugin-sdk/diffs`, `plugin-sdk/llm-task`,
`plugin-sdk/thread-ownership` y `plugin-sdk/voice-call`
`plugin-sdk/github-copilot-token` actualmente expone la superficie específica de helpers de token
`plugin-sdk/github-copilot-token` actualmente expone la superficie específica de utilidades de token
`DEFAULT_COPILOT_API_BASE_URL`,
`deriveCopilotApiBaseUrlFromToken` y `resolveCopilotApiToken`.
Usa la importación más específica que coincida con la tarea. Si no encuentras una exportación,
consulta el código fuente en `src/plugin-sdk/` o pregunta en Discord.
revisa la fuente en `src/plugin-sdk/` o pregunta en Discord.
## Cronograma de eliminación
| Cuándo | Qué sucede |
| ---------------------- | ----------------------------------------------------------------------- |
| **Ahora** | Las superficies obsoletas emiten advertencias en runtime |
| Cuándo | Qué sucede |
| ---------------------- | ---------------------------------------------------------------------- |
| **Ahora** | Las superficies obsoletas emiten advertencias en tiempo de ejecución |
| **Próxima versión principal** | Las superficies obsoletas se eliminarán; los plugins que aún las usen fallarán |
Todos los plugins principales ya se han migrado. Los plugins externos deberían migrar
Todos los plugins principales ya se migraron. Los plugins externos deberían migrar
antes de la próxima versión principal.
## Suprimir temporalmente las advertencias
@ -356,13 +364,13 @@ OPENCLAW_SUPPRESS_PLUGIN_SDK_COMPAT_WARNING=1 openclaw gateway run
OPENCLAW_SUPPRESS_EXTENSION_API_WARNING=1 openclaw gateway run
```
Esto es una vía de escape temporal, no una solución permanente.
Esta es una vía de escape temporal, no una solución permanente.
## Relacionado
- [Primeros pasos](/es/plugins/building-plugins) — crea tu primer plugin
- [Resumen del SDK](/es/plugins/sdk-overview) — referencia completa de importaciones por subruta
- [Descripción general del SDK](/es/plugins/sdk-overview) — referencia completa de importaciones por subruta
- [Plugins de canal](/es/plugins/sdk-channel-plugins) — creación de plugins de canal
- [Plugins de proveedor](/es/plugins/sdk-provider-plugins) — creación de plugins de proveedor
- [Internals de plugins](/es/plugins/architecture) — análisis profundo de la arquitectura
- [Manifiesto del plugin](/es/plugins/manifest) — referencia del esquema del manifiesto
- [Plugins de provider](/es/plugins/sdk-provider-plugins) — creación de plugins de provider
- [Aspectos internos de plugins](/es/plugins/architecture) — análisis profundo de la arquitectura
- [Manifiesto de plugin](/es/plugins/manifest) — referencia del esquema del manifiesto

520
docs/es/plugins/sdk-overview.md
View File

@ -1,30 +1,30 @@
---
read_when:
- Necesitas saber desde qué subruta del SDK importar
- Quieres una referencia de todos los métodos de registro en OpenClawPluginApi
- Estás consultando una exportación específica del SDK
- Quieres una referencia para todos los métodos de registro en OpenClawPluginApi
- Estás buscando una exportación específica del SDK
sidebarTitle: SDK Overview
summary: Mapa de importaciones, referencia de la API de registro y arquitectura del SDK
title: Resumen del Plugin SDK
summary: Mapa de importación, referencia de la API de registro y arquitectura del SDK
title: Descripción general del SDK de plugins
x-i18n:
generated_at: "2026-04-06T03:10:46Z"
generated_at: "2026-04-06T05:13:36Z"
model: gpt-5.4
provider: openai
source_hash: d801641f26f39dc21490d2a69a337ff1affb147141360916b8b58a267e9f822a
source_hash: acd2887ef52c66b2f234858d812bb04197ecd0bfb3e4f7bf3622f8fdc765acad
source_path: plugins/sdk-overview.md
workflow: 15
---
# Resumen del Plugin SDK
# Descripción general del SDK de plugins
El plugin SDK es el contrato tipado entre los plugins y el núcleo. Esta página es la
referencia para **qué importar** y **qué puedes registrar**.
El SDK de plugins es el contrato tipado entre los plugins y el núcleo. Esta página es la
referencia de **qué importar** y **qué puedes registrar**.
<Tip>
**¿Buscas una guía práctica?**
- ¿Primer plugin? Empieza con [Primeros pasos](/es/plugins/building-plugins)
- ¿Plugin de canal? Consulta [Plugins de canal](/es/plugins/sdk-channel-plugins)
- ¿Plugin de proveedor? Consulta [Plugins de proveedor](/es/plugins/sdk-provider-plugins)
- ¿Primer plugin? Empieza con [Getting Started](/es/plugins/building-plugins)
- ¿Plugin de canal? Consulta [Channel Plugins](/es/plugins/sdk-channel-plugins)
- ¿Plugin de proveedor? Consulta [Provider Plugins](/es/plugins/sdk-provider-plugins)
</Tip>
## Convención de importación
@ -37,247 +37,255 @@ import { defineChannelPluginEntry } from "openclaw/plugin-sdk/channel-core";
```
Cada subruta es un módulo pequeño y autocontenido. Esto mantiene un inicio rápido y
evita problemas de dependencias circulares. Para helpers de entrada/construcción específicos
de canal, prefiere `openclaw/plugin-sdk/channel-core`; deja `openclaw/plugin-sdk/core` para
la superficie paraguas más amplia y helpers compartidos como
evita problemas de dependencias circulares. Para los ayudantes de entrada/construcción específicos de canal,
prefiere `openclaw/plugin-sdk/channel-core`; deja `openclaw/plugin-sdk/core` para
la superficie paraguas más amplia y los ayudantes compartidos como
`buildChannelConfigSchema`.
No añadas ni dependas de accesos convenientes con nombre de proveedor como
No agregues ni dependas de interfaces de conveniencia con nombre de proveedor como
`openclaw/plugin-sdk/slack`, `openclaw/plugin-sdk/discord`,
`openclaw/plugin-sdk/signal`, `openclaw/plugin-sdk/whatsapp`, ni
accesos helper con marca de canal. Los plugins empaquetados deben componer subrutas
genéricas del SDK dentro de sus propios barrels `api.ts` o `runtime-api.ts`, y el núcleo
debe usar esos barrels locales del plugin o añadir un contrato genérico y estrecho del SDK
cuando la necesidad sea realmente entre canales.
`openclaw/plugin-sdk/signal`, `openclaw/plugin-sdk/whatsapp`, ni de
interfaces auxiliares con marca de canal. Los plugins incluidos deben componer subrutas genéricas
del SDK dentro de sus propios barrels `api.ts` o `runtime-api.ts`, y el núcleo
debe usar esos barrels locales del plugin o agregar un contrato genérico y reducido del SDK
cuando la necesidad sea realmente transversal a varios canales.
El mapa de exportaciones generado todavía contiene un pequeño conjunto de accesos helper
de plugins empaquetados como `plugin-sdk/feishu`, `plugin-sdk/feishu-setup`,
El mapa de exportaciones generado todavía contiene un pequeño conjunto de
interfaces auxiliares para plugins incluidos como `plugin-sdk/feishu`, `plugin-sdk/feishu-setup`,
`plugin-sdk/zalo`, `plugin-sdk/zalo-setup` y `plugin-sdk/matrix*`. Esas
subrutas existen solo para mantenimiento y compatibilidad de plugins empaquetados; se
omiten intencionalmente de la tabla común siguiente y no son la ruta de importación
subrutas existen solo para mantenimiento y compatibilidad de plugins incluidos; se
omiten intencionalmente de la tabla común de abajo y no son la ruta de importación
recomendada para nuevos plugins de terceros.
## Referencia de subrutas
Las subrutas más usadas, agrupadas por propósito. La lista completa generada de
Las subrutas más usadas con frecuencia, agrupadas por propósito. La lista completa generada de
más de 200 subrutas está en `scripts/lib/plugin-sdk-entrypoints.json`.
Las subrutas helper reservadas para plugins empaquetados siguen apareciendo en esa lista generada.
Trátalas como una superficie de implementación/compatibilidad a menos que una página de documentación
promocione explícitamente una como pública.
Las subrutas auxiliares reservadas para plugins incluidos siguen apareciendo en esa lista generada.
Trátalas como superficies de detalle de implementación/compatibilidad salvo que una página de documentación
promueva explícitamente alguna como pública.
### Entrada de plugin
### Entrada del plugin
| Subruta | Exportaciones clave |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `plugin-sdk/plugin-entry` | `definePluginEntry` |
| `plugin-sdk/core` | `defineChannelPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase`, `defineSetupPluginEntry`, `buildChannelConfigSchema` |
| `plugin-sdk/config-schema` | `OpenClawSchema` |
| `plugin-sdk/provider-entry` | `defineSingleProviderPluginEntry` |
| Subruta | Exportaciones clave |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| `plugin-sdk/plugin-entry` | `definePluginEntry` |
| `plugin-sdk/core` | `defineChannelPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase`, `defineSetupPluginEntry`, `buildChannelConfigSchema` |
| `plugin-sdk/config-schema` | `OpenClawSchema` |
| `plugin-sdk/provider-entry` | `defineSingleProviderPluginEntry` |
<AccordionGroup>
<Accordion title="Subrutas de canal">
| Subruta | Exportaciones clave |
| --- | --- |
| `plugin-sdk/channel-core` | `defineChannelPluginEntry`, `defineSetupPluginEntry`, `createChatChannelPlugin`, `createChannelPluginBase` |
| `plugin-sdk/config-schema` | Exportación del esquema Zod raíz `openclaw.json` (`OpenClawSchema`) |
| `plugin-sdk/config-schema` | Exportación del esquema Zod raíz de `openclaw.json` (`OpenClawSchema`) |
| `plugin-sdk/channel-setup` | `createOptionalChannelSetupSurface`, `createOptionalChannelSetupAdapter`, `createOptionalChannelSetupWizard`, además de `DEFAULT_ACCOUNT_ID`, `createTopLevelChannelDmPolicy`, `setSetupChannelEnabled`, `splitSetupEntries` |
| `plugin-sdk/setup` | Helpers compartidos de asistente de configuración, prompts de lista de permitidos, generadores de estado de configuración |
| `plugin-sdk/setup` | Ayudantes compartidos del asistente de configuración, indicaciones de allowlist, constructores de estado de configuración |
| `plugin-sdk/setup-runtime` | `createPatchedAccountSetupAdapter`, `createEnvPatchedAccountSetupAdapter`, `createSetupInputPresenceValidator`, `noteChannelLookupFailure`, `noteChannelLookupSummary`, `promptResolvedAllowFrom`, `splitSetupEntries`, `createAllowlistSetupWizardProxy`, `createDelegatedSetupWizardProxy` |
| `plugin-sdk/setup-adapter-runtime` | `createEnvPatchedAccountSetupAdapter` |
| `plugin-sdk/setup-tools` | `formatCliCommand`, `detectBinary`, `extractArchive`, `resolveBrewExecutable`, `formatDocsLink`, `CONFIG_DIR` |
| `plugin-sdk/account-core` | Helpers de configuración/controles de acciones multi-cuenta y helpers de fallback de cuenta predeterminada |
| `plugin-sdk/account-id` | `DEFAULT_ACCOUNT_ID`, helpers de normalización de ID de cuenta |
| `plugin-sdk/account-resolution` | Helpers de búsqueda de cuenta y fallback predeterminado |
| `plugin-sdk/account-helpers` | Helpers concretos de lista de cuentas/acciones de cuenta |
| `plugin-sdk/account-core` | Ayudantes de configuración/puerta de acción para varias cuentas, ayudantes de respaldo de cuenta predeterminada |
| `plugin-sdk/account-id` | `DEFAULT_ACCOUNT_ID`, ayudantes de normalización de ID de cuenta |
| `plugin-sdk/account-resolution` | Búsqueda de cuentas + ayudantes de respaldo predeterminado |
| `plugin-sdk/account-helpers` | Ayudantes específicos para lista de cuentas/acciones de cuenta |
| `plugin-sdk/channel-pairing` | `createChannelPairingController` |
| `plugin-sdk/channel-reply-pipeline` | `createChannelReplyPipeline` |
| `plugin-sdk/channel-config-helpers` | `createHybridChannelConfigAdapter` |
| `plugin-sdk/channel-config-schema` | Tipos de esquema de configuración de canal |
| `plugin-sdk/telegram-command-config` | Helpers de normalización/validación de comandos personalizados de Telegram con fallback de contrato empaquetado |
| `plugin-sdk/telegram-command-config` | Ayudantes de normalización/validación de comandos personalizados de Telegram con respaldo del contrato incluido |
| `plugin-sdk/channel-policy` | `resolveChannelGroupRequireMention` |
| `plugin-sdk/channel-lifecycle` | `createAccountStatusSink` |
| `plugin-sdk/inbound-envelope` | Helpers compartidos de ruta entrante y construcción de sobre |
| `plugin-sdk/inbound-reply-dispatch` | Helpers compartidos para registrar y despachar entradas |
| `plugin-sdk/messaging-targets` | Helpers de análisis/coincidencia de destino |
| `plugin-sdk/outbound-media` | Helpers compartidos de carga de multimedia saliente |
| `plugin-sdk/outbound-runtime` | Helpers de identidad saliente y delegado de envío |
| `plugin-sdk/thread-bindings-runtime` | Helpers de ciclo de vida y adaptador de vinculaciones de hilo |
| `plugin-sdk/agent-media-payload` | Constructor heredado de carga multimedia del agente |
| `plugin-sdk/conversation-runtime` | Helpers de conversación/vinculación de hilo, vinculación y binding configurado |
| `plugin-sdk/runtime-config-snapshot` | Helper de snapshot de configuración de runtime |
| `plugin-sdk/runtime-group-policy` | Helpers de resolución de política de grupo en runtime |
| `plugin-sdk/channel-status` | Helpers compartidos de snapshot/resumen de estado de canal |
| `plugin-sdk/channel-config-primitives` | Primitivas concretas de esquema de configuración de canal |
| `plugin-sdk/channel-config-writes` | Helpers de autorización para escrituras de configuración de canal |
| `plugin-sdk/inbound-envelope` | Ayudantes compartidos para rutas de entrada + creación de sobres |
| `plugin-sdk/inbound-reply-dispatch` | Ayudantes compartidos para registrar y despachar entradas |
| `plugin-sdk/messaging-targets` | Ayudantes para analizar/emparejar destinos |
| `plugin-sdk/outbound-media` | Ayudantes compartidos para cargar medios salientes |
| `plugin-sdk/outbound-runtime` | Ayudantes de identidad saliente/del delegado de envío |
| `plugin-sdk/thread-bindings-runtime` | Ciclo de vida de vinculaciones de hilos y ayudantes de adaptador |
| `plugin-sdk/agent-media-payload` | Constructor heredado de carga útil de medios del agente |
| `plugin-sdk/conversation-runtime` | Ayudantes de vinculación de conversación/hilo, emparejamiento y vinculación configurada |
| `plugin-sdk/runtime-config-snapshot` | Ayudante de instantánea de configuración en tiempo de ejecución |
| `plugin-sdk/runtime-group-policy` | Ayudantes de resolución de políticas de grupo en tiempo de ejecución |
| `plugin-sdk/channel-status` | Ayudantes compartidos para instantáneas/resúmenes de estado de canal |
| `plugin-sdk/channel-config-primitives` | Primitivas específicas del esquema de configuración de canal |
| `plugin-sdk/channel-config-writes` | Ayudantes de autorización de escritura de configuración de canal |
| `plugin-sdk/channel-plugin-common` | Exportaciones de preludio compartidas para plugins de canal |
| `plugin-sdk/allowlist-config-edit` | Helpers de edición/lectura de configuración de lista de permitidos |
| `plugin-sdk/group-access` | Helpers compartidos de decisión de acceso a grupos |
| `plugin-sdk/direct-dm` | Helpers compartidos de autenticación/protección para DM directo |
| `plugin-sdk/interactive-runtime` | Helpers de normalización/reducción de carga de respuesta interactiva |
| `plugin-sdk/channel-inbound` | Helpers de debounce, coincidencia de mención y sobre |
| `plugin-sdk/allowlist-config-edit` | Ayudantes para editar/leer configuración de allowlist |
| `plugin-sdk/group-access` | Ayudantes compartidos para decisiones de acceso a grupos |
| `plugin-sdk/direct-dm` | Ayudantes compartidos para autenticación/protección de mensajes directos |
| `plugin-sdk/interactive-runtime` | Ayudantes para normalización/reducción de cargas útiles de respuestas interactivas |
| `plugin-sdk/channel-inbound` | Debounce, coincidencia de menciones, ayudantes de sobres |
| `plugin-sdk/channel-send-result` | Tipos de resultado de respuesta |
| `plugin-sdk/channel-actions` | `createMessageToolButtonsSchema`, `createMessageToolCardSchema` |
| `plugin-sdk/channel-targets` | Helpers de análisis/coincidencia de destino |
| `plugin-sdk/channel-targets` | Ayudantes para analizar/emparejar destinos |
| `plugin-sdk/channel-contract` | Tipos de contrato de canal |
| `plugin-sdk/channel-feedback` | Cableado de feedback/reacciones |
| `plugin-sdk/channel-feedback` | Integración de comentarios/reacciones |
</Accordion>
<Accordion title="Subrutas de proveedor">
| Subruta | Exportaciones clave |
| --- | --- |
| `plugin-sdk/provider-entry` | `defineSingleProviderPluginEntry` |
| `plugin-sdk/provider-setup` | Helpers seleccionados de configuración de proveedores locales/autohospedados |
| `plugin-sdk/self-hosted-provider-setup` | Helpers enfocados para configuración de proveedores autohospedados compatibles con OpenAI |
| `plugin-sdk/provider-auth-runtime` | Helpers de resolución de claves API en runtime para plugins de proveedor |
| `plugin-sdk/provider-auth-api-key` | Helpers de onboarding/escritura de perfil de clave API |
| `plugin-sdk/provider-setup` | Ayudantes seleccionados de configuración para proveedores locales/autohospedados |
| `plugin-sdk/self-hosted-provider-setup` | Ayudantes enfocados de configuración para proveedores autohospedados compatibles con OpenAI |
| `plugin-sdk/provider-auth-runtime` | Ayudantes de resolución de claves API en tiempo de ejecución para plugins de proveedor |
| `plugin-sdk/provider-auth-api-key` | Ayudantes de incorporación/escritura de perfil de clave API |
| `plugin-sdk/provider-auth-result` | Constructor estándar de resultado de autenticación OAuth |
| `plugin-sdk/provider-auth-login` | Helpers compartidos de inicio de sesión interactivo para plugins de proveedor |
| `plugin-sdk/provider-env-vars` | Helpers de búsqueda de variables de entorno de autenticación de proveedor |
| `plugin-sdk/provider-auth-login` | Ayudantes compartidos de inicio de sesión interactivo para plugins de proveedor |
| `plugin-sdk/provider-env-vars` | Ayudantes de búsqueda de variables de entorno de autenticación de proveedor |
| `plugin-sdk/provider-auth` | `createProviderApiKeyAuthMethod`, `ensureApiKeyFromOptionEnvOrPrompt`, `upsertAuthProfile` |
| `plugin-sdk/provider-model-shared` | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, constructores compartidos de política de replay, helpers de endpoint de proveedor y helpers de normalización de ID de modelo como `normalizeNativeXaiModelId` |
| `plugin-sdk/provider-model-shared` | `ProviderReplayFamily`, `buildProviderReplayFamilyHooks`, `normalizeModelCompat`, constructores compartidos de políticas de repetición, ayudantes de endpoints de proveedor y ayudantes de normalización de ID de modelo como `normalizeNativeXaiModelId` |
| `plugin-sdk/provider-catalog-shared` | `findCatalogTemplate`, `buildSingleProviderApiKeyCatalog`, `supportsNativeStreamingUsageCompat`, `applyProviderNativeStreamingUsageCompat` |
| `plugin-sdk/provider-http` | Helpers genéricos de capacidades HTTP/endpoint de proveedor |
| `plugin-sdk/provider-web-fetch` | Helpers de registro/caché de proveedores web-fetch |
| `plugin-sdk/provider-web-search` | Helpers de registro/caché/configuración de proveedores web-search |
| `plugin-sdk/provider-tools` | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, limpieza de esquemas Gemini + diagnósticos, y helpers de compatibilidad xAI como `resolveXaiModelCompatPatch` / `applyXaiModelCompat` |
| `plugin-sdk/provider-http` | Ayudantes genéricos de capacidades HTTP/endpoint de proveedor |
| `plugin-sdk/provider-web-fetch` | Ayudantes de registro/caché para proveedores de captura web |
| `plugin-sdk/provider-web-search` | Ayudantes de registro/caché/configuración para proveedores de búsqueda web |
| `plugin-sdk/provider-tools` | `ProviderToolCompatFamily`, `buildProviderToolCompatFamilyHooks`, limpieza de esquemas Gemini + diagnósticos y ayudantes de compatibilidad de xAI como `resolveXaiModelCompatPatch` / `applyXaiModelCompat` |
| `plugin-sdk/provider-usage` | `fetchClaudeUsage` y similares |
| `plugin-sdk/provider-stream` | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, tipos de envoltura de stream y helpers compartidos de envoltura para Anthropic/Bedrock/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot |
| `plugin-sdk/provider-onboard` | Helpers de parche de configuración de onboarding |
| `plugin-sdk/global-singleton` | Helpers de singleton/mapa/caché locales al proceso |
| `plugin-sdk/provider-stream` | `ProviderStreamFamily`, `buildProviderStreamFamilyHooks`, `composeProviderStreamWrappers`, tipos de envoltorios de flujo y ayudantes compartidos de envoltorios para Anthropic/Bedrock/Google/Kilocode/Moonshot/OpenAI/OpenRouter/Z.A.I/MiniMax/Copilot |
| `plugin-sdk/provider-onboard` | Ayudantes de parcheo de configuración de incorporación |
| `plugin-sdk/global-singleton` | Ayudantes de singleton/mapa/caché local al proceso |
</Accordion>
<Accordion title="Subrutas de autenticación y seguridad">
| Subruta | Exportaciones clave |
| --- | --- |
| `plugin-sdk/command-auth` | `resolveControlCommandGate`, helpers de registro de comandos, helpers de autorización de remitente |
| `plugin-sdk/approval-auth-runtime` | Helpers de resolución de aprobadores y autenticación de acciones en el mismo chat |
| `plugin-sdk/approval-client-runtime` | Helpers de perfil/filtro de aprobaciones nativas de ejecución |
| `plugin-sdk/approval-delivery-runtime` | Adaptadores de capacidad/entrega de aprobación nativa |
| `plugin-sdk/approval-native-runtime` | Helpers de destino de aprobación nativa y vinculación de cuenta |
| `plugin-sdk/approval-reply-runtime` | Helpers de carga de respuesta para aprobación exec/plugin |
| `plugin-sdk/command-auth-native` | Helpers de autenticación de comandos nativos y destino de sesión nativa |
| `plugin-sdk/command-detection` | Helpers compartidos de detección de comandos |
| `plugin-sdk/command-surface` | Helpers de normalización del cuerpo de comando y superficie de comando |
| `plugin-sdk/command-auth` | `resolveControlCommandGate`, ayudantes del registro de comandos, ayudantes de autorización del remitente |
| `plugin-sdk/approval-auth-runtime` | Ayudantes para resolución de aprobadores y autenticación de acciones en el mismo chat |
| `plugin-sdk/approval-client-runtime` | Ayudantes de perfil/filtro de aprobación de ejecución nativa |
| `plugin-sdk/approval-delivery-runtime` | Adaptadores nativos de capacidad/entrega de aprobación |
| `plugin-sdk/approval-native-runtime` | Ayudantes nativos de destino de aprobación + vinculación de cuenta |
| `plugin-sdk/approval-reply-runtime` | Ayudantes de carga útil de respuesta para aprobación de ejecución/plugin |
| `plugin-sdk/command-auth-native` | Autenticación de comandos nativos + ayudantes nativos de destino de sesión |
| `plugin-sdk/command-detection` | Ayudantes compartidos de detección de comandos |
| `plugin-sdk/command-surface` | Normalización del cuerpo de comandos y ayudantes de superficie de comandos |
| `plugin-sdk/allow-from` | `formatAllowFromLowercase` |
| `plugin-sdk/security-runtime` | Helpers compartidos de confianza, control de DM, contenido externo y recopilación de secretos |
| `plugin-sdk/ssrf-policy` | Helpers de allowlist de hosts y política SSRF de red privada |
| `plugin-sdk/ssrf-runtime` | Helpers de pinned-dispatcher, fetch protegido por SSRF y política SSRF |
| `plugin-sdk/secret-input` | Helpers de análisis de entrada secreta |
| `plugin-sdk/webhook-ingress` | Helpers de solicitud/destino de webhook |
| `plugin-sdk/webhook-request-guards` | Helpers de tamaño de cuerpo/tiempo de espera de solicitud |
| `plugin-sdk/security-runtime` | Ayudantes compartidos para confianza, bloqueo de mensajes directos, contenido externo y recolección de secretos |
| `plugin-sdk/ssrf-policy` | Ayudantes de allowlist de hosts y política SSRF de red privada |
| `plugin-sdk/ssrf-runtime` | Ayudantes de dispatcher fijado, fetch con protección SSRF y política SSRF |
| `plugin-sdk/secret-input` | Ayudantes de análisis de entrada secreta |
| `plugin-sdk/webhook-ingress` | Ayudantes de solicitud/destino de webhook |
| `plugin-sdk/webhook-request-guards` | Ayudantes de tamaño de cuerpo/tiempo de espera de solicitud |
</Accordion>
<Accordion title="Subrutas de runtime y almacenamiento">
| Subruta | Exportaciones clave |
| --- | --- |
| `plugin-sdk/runtime` | Helpers amplios de runtime/logging/copia de seguridad/instalación de plugins |
| `plugin-sdk/runtime-env` | Helpers concretos de entorno de runtime, logger, timeout, retry y backoff |
| `plugin-sdk/runtime` | Ayudantes amplios de runtime, registro, copias de seguridad e instalación de plugins |
| `plugin-sdk/runtime-env` | Ayudantes específicos de entorno de runtime, logger, tiempo de espera, reintento y retroceso |
| `plugin-sdk/runtime-store` | `createPluginRuntimeStore` |
| `plugin-sdk/plugin-runtime` | Helpers compartidos de plugin para comandos/hooks/http/interactivo |
| `plugin-sdk/hook-runtime` | Helpers compartidos del pipeline de hooks webhook/internos |
| `plugin-sdk/lazy-runtime` | Helpers de importación/vinculación perezosa de runtime como `createLazyRuntimeModule`, `createLazyRuntimeMethod` y `createLazyRuntimeSurface` |
| `plugin-sdk/process-runtime` | Helpers de ejecución de procesos |
| `plugin-sdk/cli-runtime` | Helpers de formato CLI, espera y versión |
| `plugin-sdk/gateway-runtime` | Helpers de cliente gateway y parche de estado de canal |
| `plugin-sdk/config-runtime` | Helpers de carga/escritura de configuración |
| `plugin-sdk/telegram-command-config` | Normalización de nombre/descripción de comando de Telegram y comprobaciones de duplicados/conflictos, incluso cuando la superficie de contrato de Telegram empaquetada no está disponible |
| `plugin-sdk/approval-runtime` | Helpers de aprobación exec/plugin, constructores de capacidad de aprobación, helpers de auth/perfil, helpers nativos de routing/runtime |
| `plugin-sdk/reply-runtime` | Helpers compartidos de runtime para entrada/respuesta, fragmentación, despacho, heartbeat, planificador de respuesta |
| `plugin-sdk/reply-dispatch-runtime` | Helpers concretos de despacho/finalización de respuesta |
| `plugin-sdk/reply-history` | Helpers compartidos de historial de respuesta de ventana corta como `buildHistoryContext`, `recordPendingHistoryEntry` y `clearHistoryEntriesIfEnabled` |
| `plugin-sdk/plugin-runtime` | Ayudantes compartidos para comandos, hooks, HTTP e interacciones de plugins |
| `plugin-sdk/hook-runtime` | Ayudantes compartidos del flujo de hooks webhook/internos |
| `plugin-sdk/lazy-runtime` | Ayudantes de importación/vinculación perezosa en tiempo de ejecución como `createLazyRuntimeModule`, `createLazyRuntimeMethod` y `createLazyRuntimeSurface` |
| `plugin-sdk/process-runtime` | Ayudantes de ejecución de procesos |
| `plugin-sdk/cli-runtime` | Ayudantes de formato, espera y versión para CLI |
| `plugin-sdk/gateway-runtime` | Ayudantes de cliente de gateway y parcheo de estado de canal |
| `plugin-sdk/config-runtime` | Ayudantes para cargar/escribir configuración |
| `plugin-sdk/telegram-command-config` | Normalización de nombre/descripción de comandos de Telegram y comprobaciones de duplicados/conflictos, incluso cuando la superficie del contrato incluido de Telegram no está disponible |
| `plugin-sdk/approval-runtime` | Ayudantes de aprobación de ejecución/plugin, constructores de capacidad de aprobación, ayudantes de autenticación/perfil, ayudantes nativos de enrutamiento/runtime |
| `plugin-sdk/reply-runtime` | Ayudantes compartidos de runtime de entrada/respuesta, fragmentación, despacho, latido, planificador de respuestas |
| `plugin-sdk/reply-dispatch-runtime` | Ayudantes específicos para despacho/finalización de respuestas |
| `plugin-sdk/reply-history` | Ayudantes compartidos de historial de respuestas de ventana corta como `buildHistoryContext`, `recordPendingHistoryEntry` y `clearHistoryEntriesIfEnabled` |
| `plugin-sdk/reply-reference` | `createReplyReferencePlanner` |
| `plugin-sdk/reply-chunking` | Helpers concretos de fragmentación de texto/Markdown |
| `plugin-sdk/session-store-runtime` | Helpers de ruta del almacén de sesiones y updated-at |
| `plugin-sdk/state-paths` | Helpers de rutas de directorios de estado/OAuth |
| `plugin-sdk/routing` | Helpers de ruta/clave de sesión/vinculación de cuenta como `resolveAgentRoute`, `buildAgentSessionKey` y `resolveDefaultAgentBoundAccountId` |
| `plugin-sdk/status-helpers` | Helpers compartidos de resumen de estado de canal/cuenta, valores predeterminados de estado de runtime y helpers de metadatos de incidencias |
| `plugin-sdk/target-resolver-runtime` | Helpers compartidos de resolución de destino |
| `plugin-sdk/string-normalization-runtime` | Helpers de normalización de slug/cadenas |
| `plugin-sdk/request-url` | Extraer URLs de cadena de entradas tipo fetch/request |
| `plugin-sdk/run-command` | Ejecutor de comandos con tiempo medido y resultados stdout/stderr normalizados |
| `plugin-sdk/param-readers` | Lectores comunes de parámetros de herramienta/CLI |
| `plugin-sdk/tool-send` | Extraer campos de destino de envío canónicos de argumentos de herramienta |
| `plugin-sdk/temp-path` | Helpers compartidos de rutas temporales de descarga |
| `plugin-sdk/logging-core` | Logger de subsistema y helpers de redacción |
| `plugin-sdk/markdown-table-runtime` | Helpers de modo de tabla Markdown |
| `plugin-sdk/json-store` | Helpers pequeños de lectura/escritura de estado JSON |
| `plugin-sdk/file-lock` | Helpers de bloqueo de archivo reentrante |
| `plugin-sdk/persistent-dedupe` | Helpers de caché de deduplicación persistente en disco |
| `plugin-sdk/acp-runtime` | Helpers de runtime/sesión ACP y despacho de respuesta |
| `plugin-sdk/agent-config-primitives` | Primitivas concretas de esquema de configuración de runtime del agente |
| `plugin-sdk/reply-chunking` | Ayudantes específicos para fragmentación de texto/markdown |
| `plugin-sdk/session-store-runtime` | Ayudantes de ruta de almacén de sesión + `updated-at` |
| `plugin-sdk/state-paths` | Ayudantes de rutas de directorios de estado/OAuth |
| `plugin-sdk/routing` | Ayudantes de ruta/clave de sesión/vinculación de cuenta como `resolveAgentRoute`, `buildAgentSessionKey` y `resolveDefaultAgentBoundAccountId` |
| `plugin-sdk/status-helpers` | Ayudantes compartidos para resúmenes de estado de canal/cuenta, valores predeterminados de estado de runtime y ayudantes de metadatos de incidencias |
| `plugin-sdk/target-resolver-runtime` | Ayudantes compartidos de resolución de destinos |
| `plugin-sdk/string-normalization-runtime` | Ayudantes de normalización de slug/cadenas |
| `plugin-sdk/request-url` | Extraer URL en formato cadena de entradas tipo fetch/request |
| `plugin-sdk/run-command` | Ejecutor de comandos temporizado con resultados normalizados de stdout/stderr |
| `plugin-sdk/param-readers` | Lectores comunes de parámetros para herramientas/CLI |
| `plugin-sdk/tool-send` | Extraer campos canónicos del destino de envío desde argumentos de herramientas |
| `plugin-sdk/temp-path` | Ayudantes compartidos de rutas temporales de descarga |
| `plugin-sdk/logging-core` | Logger de subsistema y ayudantes de redacción |
| `plugin-sdk/markdown-table-runtime` | Ayudantes de modo de tabla Markdown |
| `plugin-sdk/json-store` | Ayudantes pequeños para leer/escribir estado JSON |
| `plugin-sdk/file-lock` | Ayudantes de bloqueo de archivos reentrantes |
| `plugin-sdk/persistent-dedupe` | Ayudantes de caché de deduplicación respaldada en disco |
| `plugin-sdk/acp-runtime` | Ayudantes de runtime/sesión ACP y despacho de respuestas |
| `plugin-sdk/agent-config-primitives` | Primitivas específicas del esquema de configuración de runtime de agentes |
| `plugin-sdk/boolean-param` | Lector flexible de parámetros booleanos |
| `plugin-sdk/dangerous-name-runtime` | Helpers de resolución de coincidencia de nombre peligrosa |
| `plugin-sdk/device-bootstrap` | Helpers de arranque de dispositivo y token de vinculación |
| `plugin-sdk/extension-shared` | Primitivas helper compartidas para canales pasivos y estado |
| `plugin-sdk/models-provider-runtime` | Helpers de respuesta para comando `/models`/proveedor |
| `plugin-sdk/skill-commands-runtime` | Helpers de listado de comandos de Skills |
| `plugin-sdk/native-command-registry` | Helpers de registro/construcción/serialización de comandos nativos |
| `plugin-sdk/provider-zai-endpoint` | Helpers de detección de endpoint Z.AI |
| `plugin-sdk/infra-runtime` | Helpers de evento del sistema/heartbeat |
| `plugin-sdk/collection-runtime` | Helpers pequeños de caché acotada |
| `plugin-sdk/diagnostic-runtime` | Helpers de marca y evento de diagnóstico |
| `plugin-sdk/error-runtime` | Grafo de errores, formato, helpers compartidos de clasificación de errores, `isApprovalNotFoundError` |
| `plugin-sdk/fetch-runtime` | Helpers de fetch envuelto, proxy y búsqueda fijada |
| `plugin-sdk/host-runtime` | Helpers de normalización de hostname y host SCP |
| `plugin-sdk/retry-runtime` | Helpers de configuración de retry y ejecutor de retry |
| `plugin-sdk/agent-runtime` | Helpers de directorio/identidad/workspace de agente |
| `plugin-sdk/directory-runtime` | Consulta/deduplicación de directorios basada en configuración |
| `plugin-sdk/dangerous-name-runtime` | Ayudantes de resolución de coincidencias de nombres peligrosos |
| `plugin-sdk/device-bootstrap` | Ayudantes de inicialización de dispositivos y tokens de emparejamiento |
| `plugin-sdk/extension-shared` | Primitivas compartidas para canales pasivos y ayudantes de estado |
| `plugin-sdk/models-provider-runtime` | Ayudantes de respuesta para el comando `/models` y proveedores |
| `plugin-sdk/skill-commands-runtime` | Ayudantes de listado de comandos de Skills |
| `plugin-sdk/native-command-registry` | Ayudantes para registrar/construir/serializar comandos nativos |
| `plugin-sdk/provider-zai-endpoint` | Ayudantes de detección de endpoint Z.AI |
| `plugin-sdk/infra-runtime` | Ayudantes de eventos del sistema/latido |
| `plugin-sdk/collection-runtime` | Ayudantes de caché acotada pequeña |
| `plugin-sdk/diagnostic-runtime` | Ayudantes de indicadores y eventos de diagnóstico |
| `plugin-sdk/error-runtime` | Grafo de errores, formato, ayudantes compartidos de clasificación de errores, `isApprovalNotFoundError` |
| `plugin-sdk/fetch-runtime` | Ayudantes de fetch envuelto, proxy y búsqueda fijada |
| `plugin-sdk/host-runtime` | Ayudantes de normalización de nombre de host y host SCP |
| `plugin-sdk/retry-runtime` | Ayudantes de configuración y ejecución de reintentos |
| `plugin-sdk/agent-runtime` | Ayudantes de directorio/identidad/espacio de trabajo del agente |
| `plugin-sdk/directory-runtime` | Consulta/deduplicación de directorios respaldados por configuración |
| `plugin-sdk/keyed-async-queue` | `KeyedAsyncQueue` |
</Accordion>
<Accordion title="Subrutas de capacidades y pruebas">
| Subruta | Exportaciones clave |
| --- | --- |
| `plugin-sdk/media-runtime` | Helpers compartidos de obtención/transformación/almacenamiento de multimedia más constructores de carga multimedia |
| `plugin-sdk/media-understanding` | Tipos de proveedor de comprensión multimedia más exportaciones de helpers de imagen/audio para proveedores |
| `plugin-sdk/text-runtime` | Helpers compartidos de texto/Markdown/logging como eliminación de texto visible para el asistente, renderizado/fragmentación/tablas Markdown, redacción, etiquetas de directivas y utilidades de texto seguro |
| `plugin-sdk/text-chunking` | Helper de fragmentación de texto saliente |
| `plugin-sdk/speech` | Tipos de proveedor de voz más helpers orientados al proveedor para directivas, registro y validación |
| `plugin-sdk/speech-core` | Tipos compartidos de proveedor de voz, registro, directiva y helpers de normalización |
| `plugin-sdk/realtime-transcription` | Tipos de proveedor de transcripción en tiempo real y helpers de registro |
| `plugin-sdk/realtime-voice` | Tipos de proveedor de voz en tiempo real y helpers de registro |
| `plugin-sdk/media-runtime` | Ayudantes compartidos para obtener/transformar/almacenar medios, además de constructores de cargas útiles de medios |
| `plugin-sdk/media-generation-runtime` | Ayudantes compartidos para failover de generación de medios, selección de candidatos y mensajes de modelo faltante |
| `plugin-sdk/media-understanding` | Tipos de proveedor para comprensión de medios más exportaciones de ayudantes de imagen/audio orientadas a proveedores |
| `plugin-sdk/text-runtime` | Ayudantes compartidos de texto/markdown/logging como eliminación de texto visible para el asistente, ayudantes de renderizado/fragmentación/tablas de markdown, ayudantes de redacción, ayudantes de etiquetas de directivas y utilidades de texto seguro |
| `plugin-sdk/text-chunking` | Ayudante de fragmentación de texto saliente |
| `plugin-sdk/speech` | Tipos de proveedor de voz más ayudantes orientados a proveedores para directivas, registro y validación |
| `plugin-sdk/speech-core` | Tipos compartidos de proveedor de voz, registro, directivas y ayudantes de normalización |
| `plugin-sdk/realtime-transcription` | Tipos de proveedor de transcripción en tiempo real y ayudantes de registro |
| `plugin-sdk/realtime-voice` | Tipos de proveedor de voz en tiempo real y ayudantes de registro |
| `plugin-sdk/image-generation` | Tipos de proveedor de generación de imágenes |
| `plugin-sdk/image-generation-core` | Tipos compartidos de generación de imágenes, failover, autenticación y helpers de registro |
| `plugin-sdk/image-generation-core` | Tipos compartidos de generación de imágenes, failover, autenticación y ayudantes de registro |
| `plugin-sdk/music-generation` | Tipos de proveedor/solicitud/resultado de generación musical |
| `plugin-sdk/music-generation-core` | Tipos compartidos de generación musical, helpers de failover, búsqueda de proveedor y análisis de model-ref |
| `plugin-sdk/music-generation-core` | Tipos compartidos de generación musical, ayudantes de failover, búsqueda de proveedores y análisis de referencias de modelos |
| `plugin-sdk/video-generation` | Tipos de proveedor/solicitud/resultado de generación de video |
| `plugin-sdk/video-generation-core` | Tipos compartidos de generación de video, helpers de failover, búsqueda de proveedor y análisis de model-ref |
| `plugin-sdk/webhook-targets` | Registro de destinos webhook y helpers de instalación de rutas |
| `plugin-sdk/webhook-path` | Helpers de normalización de ruta de webhook |
| `plugin-sdk/web-media` | Helpers compartidos de carga multimedia remota/local |
| `plugin-sdk/zod` | `zod` reexportado para consumidores del plugin SDK |
| `plugin-sdk/video-generation-core` | Tipos compartidos de generación de video, ayudantes de failover, búsqueda de proveedores y análisis de referencias de modelos |
| `plugin-sdk/webhook-targets` | Registro de destinos de webhook y ayudantes de instalación de rutas |
| `plugin-sdk/webhook-path` | Ayudantes de normalización de rutas de webhook |
| `plugin-sdk/web-media` | Ayudantes compartidos para carga de medios remotos/locales |
| `plugin-sdk/zod` | `zod` reexportado para consumidores del SDK de plugins |
| `plugin-sdk/testing` | `installCommonResolveTargetErrorCases`, `shouldAckReaction` |
</Accordion>
<Accordion title="Subrutas de memoria">
| Subruta | Exportaciones clave |
| --- | --- |
| `plugin-sdk/memory-core` | Superficie helper empaquetada memory-core para helpers de gestor/configuración/archivo/CLI |
| `plugin-sdk/memory-core-engine-runtime` | Fachada de runtime de índice/búsqueda de memoria |
| `plugin-sdk/memory-core` | Superficie auxiliar `memory-core` incluida para ayudantes de administrador/configuración/archivo/CLI |
| `plugin-sdk/memory-core-engine-runtime` | Fachada de runtime para indexación/búsqueda de memoria |
| `plugin-sdk/memory-core-host-engine-foundation` | Exportaciones del motor base del host de memoria |
| `plugin-sdk/memory-core-host-engine-embeddings` | Exportaciones del motor de embeddings del host de memoria |
| `plugin-sdk/memory-core-host-engine-qmd` | Exportaciones del motor QMD del host de memoria |
| `plugin-sdk/memory-core-host-engine-storage` | Exportaciones del motor de almacenamiento del host de memoria |
| `plugin-sdk/memory-core-host-multimodal` | Helpers multimodales del host de memoria |
| `plugin-sdk/memory-core-host-query` | Helpers de consulta del host de memoria |
| `plugin-sdk/memory-core-host-secret` | Helpers de secretos del host de memoria |
| `plugin-sdk/memory-core-host-status` | Helpers de estado del host de memoria |
| `plugin-sdk/memory-core-host-runtime-cli` | Helpers de runtime CLI del host de memoria |
| `plugin-sdk/memory-core-host-runtime-core` | Helpers de runtime central del host de memoria |
| `plugin-sdk/memory-core-host-runtime-files` | Helpers de archivos/runtime del host de memoria |
| `plugin-sdk/memory-lancedb` | Superficie helper empaquetada memory-lancedb |
| `plugin-sdk/memory-core-host-multimodal` | Ayudantes multimodales del host de memoria |
| `plugin-sdk/memory-core-host-query` | Ayudantes de consulta del host de memoria |
| `plugin-sdk/memory-core-host-secret` | Ayudantes de secretos del host de memoria |
| `plugin-sdk/memory-core-host-events` | Ayudantes de diario de eventos del host de memoria |
| `plugin-sdk/memory-core-host-status` | Ayudantes de estado del host de memoria |
| `plugin-sdk/memory-core-host-runtime-cli` | Ayudantes de runtime CLI del host de memoria |
| `plugin-sdk/memory-core-host-runtime-core` | Ayudantes de runtime central del host de memoria |
| `plugin-sdk/memory-core-host-runtime-files` | Ayudantes de archivos/runtime del host de memoria |
| `plugin-sdk/memory-host-core` | Alias neutral al proveedor para ayudantes de runtime central del host de memoria |
| `plugin-sdk/memory-host-events` | Alias neutral al proveedor para ayudantes del diario de eventos del host de memoria |
| `plugin-sdk/memory-host-files` | Alias neutral al proveedor para ayudantes de archivos/runtime del host de memoria |
| `plugin-sdk/memory-host-markdown` | Ayudantes compartidos de markdown gestionado para plugins adyacentes a memoria |
| `plugin-sdk/memory-host-search` | Fachada de runtime de memoria activa para acceso al administrador de búsqueda |
| `plugin-sdk/memory-host-status` | Alias neutral al proveedor para ayudantes de estado del host de memoria |
| `plugin-sdk/memory-lancedb` | Superficie auxiliar `memory-lancedb` incluida |
</Accordion>
<Accordion title="Subrutas helper empaquetadas reservadas">
<Accordion title="Subrutas reservadas de ayudantes incluidos">
| Familia | Subrutas actuales | Uso previsto |
| --- | --- | --- |
| Browser | `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/browser-support` | Helpers de soporte del plugin Browser empaquetado (`browser-support` sigue siendo el barrel de compatibilidad) |
| Matrix | `plugin-sdk/matrix`, `plugin-sdk/matrix-helper`, `plugin-sdk/matrix-runtime-heavy`, `plugin-sdk/matrix-runtime-shared`, `plugin-sdk/matrix-runtime-surface`, `plugin-sdk/matrix-surface`, `plugin-sdk/matrix-thread-bindings` | Superficie helper/runtime empaquetada de Matrix |
| Line | `plugin-sdk/line`, `plugin-sdk/line-core`, `plugin-sdk/line-runtime`, `plugin-sdk/line-surface` | Superficie helper/runtime empaquetada de LINE |
| IRC | `plugin-sdk/irc`, `plugin-sdk/irc-surface` | Superficie helper empaquetada de IRC |
| Helpers específicos de canal | `plugin-sdk/googlechat`, `plugin-sdk/zalouser`, `plugin-sdk/bluebubbles`, `plugin-sdk/bluebubbles-policy`, `plugin-sdk/mattermost`, `plugin-sdk/mattermost-policy`, `plugin-sdk/feishu-conversation`, `plugin-sdk/msteams`, `plugin-sdk/nextcloud-talk`, `plugin-sdk/nostr`, `plugin-sdk/tlon`, `plugin-sdk/twitch` | Accesos de compatibilidad/helper para canales empaquetados |
| Helpers específicos de auth/plugin | `plugin-sdk/github-copilot-login`, `plugin-sdk/github-copilot-token`, `plugin-sdk/diagnostics-otel`, `plugin-sdk/diffs`, `plugin-sdk/llm-task`, `plugin-sdk/thread-ownership`, `plugin-sdk/voice-call` | Accesos helper para funciones/plugins empaquetados; `plugin-sdk/github-copilot-token` exporta actualmente `DEFAULT_COPILOT_API_BASE_URL`, `deriveCopilotApiBaseUrlFromToken` y `resolveCopilotApiToken` |
| Browser | `plugin-sdk/browser-cdp`, `plugin-sdk/browser-config-runtime`, `plugin-sdk/browser-config-support`, `plugin-sdk/browser-control-auth`, `plugin-sdk/browser-node-runtime`, `plugin-sdk/browser-profiles`, `plugin-sdk/browser-security-runtime`, `plugin-sdk/browser-setup-tools`, `plugin-sdk/browser-support` | Ayudantes de soporte para el plugin Browser incluido (`browser-support` sigue siendo el barrel de compatibilidad) |
| Matrix | `plugin-sdk/matrix`, `plugin-sdk/matrix-helper`, `plugin-sdk/matrix-runtime-heavy`, `plugin-sdk/matrix-runtime-shared`, `plugin-sdk/matrix-runtime-surface`, `plugin-sdk/matrix-surface`, `plugin-sdk/matrix-thread-bindings` | Superficie auxiliar/de runtime de Matrix incluida |
| Line | `plugin-sdk/line`, `plugin-sdk/line-core`, `plugin-sdk/line-runtime`, `plugin-sdk/line-surface` | Superficie auxiliar/de runtime de LINE incluida |
| IRC | `plugin-sdk/irc`, `plugin-sdk/irc-surface` | Superficie auxiliar de IRC incluida |
| Ayudantes específicos de canal | `plugin-sdk/googlechat`, `plugin-sdk/zalouser`, `plugin-sdk/bluebubbles`, `plugin-sdk/bluebubbles-policy`, `plugin-sdk/mattermost`, `plugin-sdk/mattermost-policy`, `plugin-sdk/feishu-conversation`, `plugin-sdk/msteams`, `plugin-sdk/nextcloud-talk`, `plugin-sdk/nostr`, `plugin-sdk/tlon`, `plugin-sdk/twitch` | Interfaces auxiliares/de compatibilidad de canales incluidos |
| Ayudantes específicos de autenticación/plugin | `plugin-sdk/github-copilot-login`, `plugin-sdk/github-copilot-token`, `plugin-sdk/diagnostics-otel`, `plugin-sdk/diffs`, `plugin-sdk/llm-task`, `plugin-sdk/thread-ownership`, `plugin-sdk/voice-call` | Interfaces auxiliares de funciones/plugins incluidos; `plugin-sdk/github-copilot-token` exporta actualmente `DEFAULT_COPILOT_API_BASE_URL`, `deriveCopilotApiBaseUrlFromToken` y `resolveCopilotApiToken` |
</Accordion>
</AccordionGroup>
@ -288,19 +296,19 @@ métodos:
### Registro de capacidades
| Método | Qué registra |
| ------------------------------------------------ | -------------------------------- |
| `api.registerProvider(...)` | Inferencia de texto (LLM) |
| `api.registerChannel(...)` | Canal de mensajería |
| `api.registerSpeechProvider(...)` | Síntesis de texto a voz / STT |
| Método | Qué registra |
| ------------------------------------------------ | ------------------------------- |
| `api.registerProvider(...)` | Inferencia de texto (LLM) |
| `api.registerChannel(...)` | Canal de mensajería |
| `api.registerSpeechProvider(...)` | Síntesis de texto a voz / STT |
| `api.registerRealtimeTranscriptionProvider(...)` | Transcripción en tiempo real por streaming |
| `api.registerRealtimeVoiceProvider(...)` | Sesiones de voz bidireccionales en tiempo real |
| `api.registerMediaUnderstandingProvider(...)` | Análisis de imagen/audio/video |
| `api.registerImageGenerationProvider(...)` | Generación de imágenes |
| `api.registerMusicGenerationProvider(...)` | Generación musical |
| `api.registerVideoGenerationProvider(...)` | Generación de video |
| `api.registerWebFetchProvider(...)` | Proveedor de web fetch / scraping |
| `api.registerWebSearchProvider(...)` | Búsqueda web |
| `api.registerRealtimeVoiceProvider(...)` | Sesiones de voz dúplex en tiempo real |
| `api.registerMediaUnderstandingProvider(...)` | Análisis de imagen/audio/video |
| `api.registerImageGenerationProvider(...)` | Generación de imágenes |
| `api.registerMusicGenerationProvider(...)` | Generación de música |
| `api.registerVideoGenerationProvider(...)` | Generación de video |
| `api.registerWebFetchProvider(...)` | Proveedor de captura / scraping web |
| `api.registerWebSearchProvider(...)` | Búsqueda web |
### Herramientas y comandos
@ -311,29 +319,31 @@ métodos:
### Infraestructura
| Método | Qué registra |
| ---------------------------------------------- | -------------------- |
| `api.registerHook(events, handler, opts?)` | Hook de evento |
| `api.registerHttpRoute(params)` | Endpoint HTTP del gateway |
| `api.registerGatewayMethod(name, handler)` | Método RPC del gateway |
| `api.registerCli(registrar, opts?)` | Subcomando de CLI |
| `api.registerService(service)` | Servicio en segundo plano |
| `api.registerInteractiveHandler(registration)` | Controlador interactivo |
| Método | Qué registra |
| ---------------------------------------------- | --------------------------------------- |
| `api.registerHook(events, handler, opts?)` | Hook de eventos |
| `api.registerHttpRoute(params)` | Endpoint HTTP del gateway |
| `api.registerGatewayMethod(name, handler)` | Método RPC del gateway |
| `api.registerCli(registrar, opts?)` | Subcomando de CLI |
| `api.registerService(service)` | Servicio en segundo plano |
| `api.registerInteractiveHandler(registration)` | Manejador interactivo |
| `api.registerMemoryPromptSupplement(builder)` | Sección adicional del prompt adyacente a memoria |
| `api.registerMemoryCorpusSupplement(adapter)` | Corpus adicional de búsqueda/lectura de memoria |
Los espacios de nombres de administración reservados del núcleo (`config.*`, `exec.approvals.*`, `wizard.*`,
Los espacios de nombres administrativos reservados del núcleo (`config.*`, `exec.approvals.*`, `wizard.*`,
`update.*`) siempre permanecen como `operator.admin`, incluso si un plugin intenta asignar un
ámbito más estrecho a un método del gateway. Prefiere prefijos específicos del plugin para
métodos propiedad del plugin.
alcance más limitado al método del gateway. Prefiere prefijos específicos del plugin para
métodos propios del plugin.
### Metadatos de registro CLI
### Metadatos de registro de CLI
`api.registerCli(registrar, opts?)` acepta dos tipos de metadatos de nivel superior:
- `commands`: raíces de comando explícitas propiedad del registrador
- `descriptors`: descriptores de comandos en tiempo de análisis usados para la ayuda de la CLI raíz,
el enrutamiento y el registro perezoso de CLI de plugins
- `commands`: raíces de comandos explícitas propiedad del registrador
- `descriptors`: descriptores de comandos en tiempo de análisis usados para la ayuda del CLI raíz,
enrutamiento y registro perezoso del CLI del plugin
Si quieres que un comando de plugin siga cargándose de forma perezosa en la ruta normal de la CLI raíz,
Si quieres que un comando del plugin permanezca con carga perezosa en la ruta normal del CLI raíz,
proporciona `descriptors` que cubran cada raíz de comando de nivel superior expuesta por ese
registrador.
@ -347,7 +357,7 @@ api.registerCli(
descriptors: [
{
name: "matrix",
description: "Administrar cuentas de Matrix, verificación, dispositivos y estado del perfil",
description: "Manage Matrix accounts, verification, devices, and profile state",
hasSubcommands: true,
},
],
@ -355,7 +365,7 @@ api.registerCli(
);
```
Usa `commands` por sí solo únicamente cuando no necesites registro perezoso en la CLI raíz.
Usa `commands` por sí solo solo cuando no necesites registro perezoso en el CLI raíz.
Esa ruta de compatibilidad ansiosa sigue siendo compatible, pero no instala
marcadores respaldados por descriptores para carga perezosa en tiempo de análisis.
@ -370,52 +380,52 @@ marcadores respaldados por descriptores para carga perezosa en tiempo de anális
### Adaptadores de embeddings de memoria
| Método | Qué registra |
| ---------------------------------------------- | ---------------------------------------------------- |
| Método | Qué registra |
| ---------------------------------------------- | ---------------------------------------------- |
| `api.registerMemoryEmbeddingProvider(adapter)` | Adaptador de embeddings de memoria para el plugin activo |
- `registerMemoryPromptSection`, `registerMemoryFlushPlan` y
`registerMemoryRuntime` son exclusivos de los plugins de memoria.
- `registerMemoryEmbeddingProvider` permite al plugin de memoria activo registrar
uno o más IDs de adaptador de embeddings (por ejemplo `openai`, `gemini` o un ID personalizado
`registerMemoryRuntime` son exclusivos para plugins de memoria.
- `registerMemoryEmbeddingProvider` permite que el plugin de memoria activo registre uno
o más ID de adaptadores de embeddings (por ejemplo `openai`, `gemini` o un ID personalizado
definido por el plugin).
- La configuración de usuario, como `agents.defaults.memorySearch.provider` y
`agents.defaults.memorySearch.fallback`, se resuelve contra esos IDs de adaptador
- La configuración del usuario como `agents.defaults.memorySearch.provider` y
`agents.defaults.memorySearch.fallback` se resuelve contra esos ID de adaptadores
registrados.
### Eventos y ciclo de vida
| Método | Qué hace |
| -------------------------------------------- | ----------------------------- |
| `api.on(hookName, handler, opts?)` | Hook tipado de ciclo de vida |
| `api.onConversationBindingResolved(handler)` | Callback de resolución de vinculación de conversación |
| Método | Qué hace |
| -------------------------------------------- | ---------------------------- |
| `api.on(hookName, handler, opts?)` | Hook tipado del ciclo de vida |
| `api.onConversationBindingResolved(handler)` | Devolución de llamada de vinculación de conversación |
### Semántica de decisiones de hook
### Semántica de decisión de hooks
- `before_tool_call`: devolver `{ block: true }` es terminal. Una vez que cualquier controlador lo establece, se omiten los controladores de prioridad inferior.
- `before_tool_call`: devolver `{ block: true }` es terminal. Una vez que cualquier manejador lo establece, se omiten los manejadores de menor prioridad.
- `before_tool_call`: devolver `{ block: false }` se trata como ausencia de decisión (igual que omitir `block`), no como una anulación.
- `before_install`: devolver `{ block: true }` es terminal. Una vez que cualquier controlador lo establece, se omiten los controladores de prioridad inferior.
- `before_install`: devolver `{ block: true }` es terminal. Una vez que cualquier manejador lo establece, se omiten los manejadores de menor prioridad.
- `before_install`: devolver `{ block: false }` se trata como ausencia de decisión (igual que omitir `block`), no como una anulación.
- `reply_dispatch`: devolver `{ handled: true, ... }` es terminal. Una vez que cualquier controlador reclama el despacho, se omiten los controladores de prioridad inferior y la ruta predeterminada de despacho del modelo.
- `message_sending`: devolver `{ cancel: true }` es terminal. Una vez que cualquier controlador lo establece, se omiten los controladores de prioridad inferior.
- `reply_dispatch`: devolver `{ handled: true, ... }` es terminal. Una vez que cualquier manejador reclama el despacho, se omiten los manejadores de menor prioridad y la ruta predeterminada de despacho del modelo.
- `message_sending`: devolver `{ cancel: true }` es terminal. Una vez que cualquier manejador lo establece, se omiten los manejadores de menor prioridad.
- `message_sending`: devolver `{ cancel: false }` se trata como ausencia de decisión (igual que omitir `cancel`), no como una anulación.
### Campos del objeto API
| Campo | Tipo | Descripción |
| ------------------------ | ------------------------- | --------------------------------------------------------------------------------------------- |
| `api.id` | `string` | ID del plugin |
| `api.name` | `string` | Nombre visible |
| `api.version` | `string?` | Versión del plugin (opcional) |
| `api.description` | `string?` | Descripción del plugin (opcional) |
| `api.source` | `string` | Ruta de origen del plugin |
| `api.rootDir` | `string?` | Directorio raíz del plugin (opcional) |
| `api.config` | `OpenClawConfig` | Snapshot actual de configuración (snapshot activo en memoria del runtime cuando está disponible) |
| `api.pluginConfig` | `Record<string, unknown>` | Configuración específica del plugin desde `plugins.entries.<id>.config` |
| `api.runtime` | `PluginRuntime` | [Helpers de runtime](/es/plugins/sdk-runtime) |
| `api.logger` | `PluginLogger` | Logger con ámbito (`debug`, `info`, `warn`, `error`) |
| Campo | Tipo | Descripción |
| ------------------------ | ------------------------- | ------------------------------------------------------------------------------------------ |
| `api.id` | `string` | ID del plugin |
| `api.name` | `string` | Nombre para mostrar |
| `api.version` | `string?` | Versión del plugin (opcional) |
| `api.description` | `string?` | Descripción del plugin (opcional) |
| `api.source` | `string` | Ruta de origen del plugin |
| `api.rootDir` | `string?` | Directorio raíz del plugin (opcional) |
| `api.config` | `OpenClawConfig` | Instantánea de configuración actual (instantánea activa en memoria en tiempo de ejecución cuando está disponible) |
| `api.pluginConfig` | `Record<string, unknown>` | Configuración específica del plugin de `plugins.entries.<id>.config` |
| `api.runtime` | `PluginRuntime` | [Ayudantes de runtime](/es/plugins/sdk-runtime) |
| `api.logger` | `PluginLogger` | Logger con alcance (`debug`, `info`, `warn`, `error`) |
| `api.registrationMode` | `PluginRegistrationMode` | Modo de carga actual; `"setup-runtime"` es la ventana ligera de inicio/configuración previa a la entrada completa |
| `api.resolvePath(input)` | `(string) => string` | Resolver ruta relativa a la raíz del plugin |
| `api.resolvePath(input)` | `(string) => string` | Resuelve una ruta relativa a la raíz del plugin |
## Convención de módulos internos
@ -424,7 +434,7 @@ Dentro de tu plugin, usa archivos barrel locales para las importaciones internas
```
my-plugin/
api.ts # Exportaciones públicas para consumidores externos
runtime-api.ts # Exportaciones internas de runtime
runtime-api.ts # Exportaciones internas solo para runtime
index.ts # Punto de entrada del plugin
setup-entry.ts # Entrada ligera solo para configuración (opcional)
```
@ -435,37 +445,37 @@ my-plugin/
`./runtime-api.ts`. La ruta del SDK es solo el contrato externo.
</Warning>
Las superficies públicas de plugins empaquetados cargadas mediante fachada (`api.ts`, `runtime-api.ts`,
`index.ts`, `setup-entry.ts` y archivos de entrada pública similares) ahora prefieren el
snapshot activo de configuración del runtime cuando OpenClaw ya está en ejecución. Si todavía no existe
un snapshot de runtime, usan como fallback el archivo de configuración resuelto en disco.
Las superficies públicas de plugins incluidos cargadas mediante fachada (`api.ts`, `runtime-api.ts`,
`index.ts`, `setup-entry.ts` y archivos de entrada públicos similares) ahora prefieren la
instantánea activa de configuración en tiempo de ejecución cuando OpenClaw ya está en ejecución. Si todavía
no existe una instantánea de runtime, recurren al archivo de configuración resuelto en disco.
Los plugins de proveedor también pueden exponer un barrel de contrato local y concreto cuando un
helper es intencionalmente específico del proveedor y todavía no pertenece a una subruta genérica
del SDK. Ejemplo empaquetado actual: el proveedor Anthropic mantiene sus helpers de stream Claude
en su propio acceso público `api.ts` / `contract-api.ts` en lugar de promocionar la lógica de
encabezados beta de Anthropic y `service_tier` a un contrato genérico
Los plugins de proveedor también pueden exponer un barrel de contrato local y específico del plugin cuando un
ayudante es intencionalmente específico del proveedor y todavía no pertenece a una subruta genérica del SDK.
Ejemplo incluido actual: el proveedor Anthropic mantiene sus ayudantes de flujo Claude
en su propia interfaz pública `api.ts` / `contract-api.ts` en lugar de
promover la lógica de encabezados beta de Anthropic y `service_tier` a un contrato genérico
`plugin-sdk/*`.
Otros ejemplos empaquetados actuales:
Otros ejemplos incluidos actuales:
- `@openclaw/openai-provider`: `api.ts` exporta constructores de proveedores,
helpers de modelo predeterminado y constructores de proveedores en tiempo real
- `@openclaw/openai-provider`: `api.ts` exporta constructores de proveedor,
ayudantes de modelo predeterminado y constructores de proveedor en tiempo real
- `@openclaw/openrouter-provider`: `api.ts` exporta el constructor del proveedor más
helpers de onboarding/configuración
ayudantes de incorporación/configuración
<Warning>
El código de producción de extensiones también debe evitar importaciones `openclaw/plugin-sdk/<other-plugin>`.
Si un helper es realmente compartido, promuévelo a una subruta neutral del SDK
El código de producción de extensiones también debe evitar importaciones de `openclaw/plugin-sdk/<other-plugin>`.
Si un ayudante es realmente compartido, promuévelo a una subruta neutral del SDK
como `openclaw/plugin-sdk/speech`, `.../provider-model-shared` u otra
superficie orientada a capacidades en lugar de acoplar dos plugins entre sí.
superficie orientada a capacidades, en lugar de acoplar dos plugins entre sí.
</Warning>
## Relacionado
- [Puntos de entrada](/es/plugins/sdk-entrypoints) — opciones de `definePluginEntry` y `defineChannelPluginEntry`
- [Helpers de runtime](/es/plugins/sdk-runtime) — referencia completa del espacio de nombres `api.runtime`
- [Configuración y config](/es/plugins/sdk-setup) — empaquetado, manifiestos, esquemas de configuración
- [Pruebas](/es/plugins/sdk-testing) — utilidades de prueba y reglas de lint
- [Migración del SDK](/es/plugins/sdk-migration) — migración desde superficies obsoletas
- [Internos del plugin](/es/plugins/architecture) — arquitectura profunda y modelo de capacidades
- [Entry Points](/es/plugins/sdk-entrypoints) — opciones de `definePluginEntry` y `defineChannelPluginEntry`
- [Runtime Helpers](/es/plugins/sdk-runtime) — referencia completa del espacio de nombres `api.runtime`
- [Setup and Config](/es/plugins/sdk-setup) — empaquetado, manifiestos, esquemas de configuración
- [Testing](/es/plugins/sdk-testing) — utilidades de prueba y reglas de lint
- [SDK Migration](/es/plugins/sdk-migration) — migración desde superficies obsoletas
- [Plugin Internals](/es/plugins/architecture) — arquitectura profunda y modelo de capacidades

84
docs/es/tools/image-generation.md
View File

@ -1,30 +1,30 @@
---
read_when:
- Generar imágenes a través del agente
- Generar imágenes mediante el agente
- Configurar proveedores y modelos de generación de imágenes
- Comprender los parámetros de la herramienta image_generate
summary: Generar y editar imágenes usando proveedores configurados (OpenAI, Google Gemini, fal, MiniMax, ComfyUI, Vydra)
summary: Genera y edita imágenes usando proveedores configurados (OpenAI, Google Gemini, fal, MiniMax, ComfyUI, Vydra)
title: Generación de imágenes
x-i18n:
generated_at: "2026-04-06T03:12:15Z"
generated_at: "2026-04-06T05:12:27Z"
model: gpt-5.4
provider: openai
source_hash: dde416dd1441a06605db85b5813cf61ccfc525813d6db430b7b7dfa53d6a3134
source_hash: 903cc522c283a8da2cbd449ae3e25f349a74d00ecfdaf0f323fd8aa3f2107aea
source_path: tools/image-generation.md
workflow: 15
---
# Generación de imágenes
La herramienta `image_generate` permite al agente crear y editar imágenes usando tus proveedores configurados. Las imágenes generadas se entregan automáticamente como adjuntos multimedia en la respuesta del agente.
La herramienta `image_generate` permite que el agente cree y edite imágenes usando tus proveedores configurados. Las imágenes generadas se entregan automáticamente como archivos multimedia adjuntos en la respuesta del agente.
<Note>
La herramienta solo aparece cuando al menos un proveedor de generación de imágenes está disponible. Si no ves `image_generate` en las herramientas de tu agente, configura `agents.defaults.imageGenerationModel` o establece una clave de API del proveedor.
La herramienta solo aparece cuando hay al menos un proveedor de generación de imágenes disponible. Si no ves `image_generate` en las herramientas de tu agente, configura `agents.defaults.imageGenerationModel` o establece una clave de API de un proveedor.
</Note>
## Inicio rápido
1. Establece una clave de API para al menos un proveedor (por ejemplo `OPENAI_API_KEY` o `GEMINI_API_KEY`).
1. Establece una clave de API para al menos un proveedor (por ejemplo, `OPENAI_API_KEY` o `GEMINI_API_KEY`).
2. Opcionalmente, establece tu modelo preferido:
```json5
@ -41,18 +41,18 @@ La herramienta solo aparece cuando al menos un proveedor de generación de imág
3. Pídele al agente: _"Genera una imagen de una mascota langosta amistosa."_
El agente llama a `image_generate` automáticamente. No hace falta una lista de permitidos de herramientas: está habilitada de forma predeterminada cuando hay un proveedor disponible.
El agente llama a `image_generate` automáticamente. No se necesita ninguna lista de permitidos de herramientas; está habilitada de forma predeterminada cuando hay un proveedor disponible.
## Proveedores compatibles
| Provider | Modelo predeterminado | Compatibilidad de edición | Clave de API |
| -------- | -------------------------------- | ---------------------------------- | ------------------------------------------------------- |
| OpenAI | `gpt-image-1` | Sí (hasta 5 imágenes) | `OPENAI_API_KEY` |
| Google | `gemini-3.1-flash-image-preview` | Sí | `GEMINI_API_KEY` o `GOOGLE_API_KEY` |
| fal | `fal-ai/flux/dev` | Sí | `FAL_KEY` |
| MiniMax | `image-01` | Sí (referencia de sujeto) | `MINIMAX_API_KEY` o OAuth de MiniMax (`minimax-portal`) |
| ComfyUI | `workflow` | Sí (1 imagen, configurada por workflow) | `COMFY_API_KEY` o `COMFY_CLOUD_API_KEY` para cloud |
| Vydra | `grok-imagine` | No | `VYDRA_API_KEY` |
| Proveedor | Modelo predeterminado | Compatibilidad con edición | Clave de API |
| --------- | -------------------------------- | ---------------------------------- | ------------------------------------------------------- |
| OpenAI | `gpt-image-1` | Sí (hasta 5 imágenes) | `OPENAI_API_KEY` |
| Google | `gemini-3.1-flash-image-preview` | Sí | `GEMINI_API_KEY` o `GOOGLE_API_KEY` |
| fal | `fal-ai/flux/dev` | Sí | `FAL_KEY` |
| MiniMax | `image-01` | Sí (referencia de sujeto) | `MINIMAX_API_KEY` o OAuth de MiniMax (`minimax-portal`) |
| ComfyUI | `workflow` | Sí (1 imagen, configurada por flujo de trabajo) | `COMFY_API_KEY` o `COMFY_CLOUD_API_KEY` para la nube |
| Vydra | `grok-imagine` | No | `VYDRA_API_KEY` |
Usa `action: "list"` para inspeccionar los proveedores y modelos disponibles en tiempo de ejecución:
@ -62,20 +62,20 @@ Usa `action: "list"` para inspeccionar los proveedores y modelos disponibles en
## Parámetros de la herramienta
| Parameter | Type | Descripción |
| Parámetro | Tipo | Descripción |
| ------------- | -------- | ------------------------------------------------------------------------------------ |
| `prompt` | string | Prompt de generación de imágenes (obligatorio para `action: "generate"`) |
| `action` | string | `"generate"` (predeterminado) o `"list"` para inspeccionar proveedores |
| `model` | string | Anulación de proveedor/modelo, por ejemplo `openai/gpt-image-1` |
| `image` | string | Ruta o URL de una sola imagen de referencia para el modo edición |
| `images` | string[] | Varias imágenes de referencia para el modo edición (hasta 5) |
| `image` | string | Ruta o URL de una sola imagen de referencia para el modo de edición |
| `images` | string[] | Varias imágenes de referencia para el modo de edición (hasta 5) |
| `size` | string | Sugerencia de tamaño: `1024x1024`, `1536x1024`, `1024x1536`, `1024x1792`, `1792x1024` |
| `aspectRatio` | string | Relación de aspecto: `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9` |
| `resolution` | string | Sugerencia de resolución: `1K`, `2K` o `4K` |
| `count` | number | Número de imágenes a generar (1–4) |
| `count` | number | Número de imágenes que se van a generar (1–4) |
| `filename` | string | Sugerencia de nombre de archivo de salida |
No todos los proveedores admiten todos los parámetros. La herramienta pasa lo que cada proveedor admite, ignora el resto e informa de las anulaciones descartadas en el resultado de la herramienta.
No todos los proveedores admiten todos los parámetros. La herramienta pasa lo que cada proveedor admite, ignora el resto e informa las anulaciones descartadas en el resultado de la herramienta.
## Configuración
@ -98,23 +98,25 @@ No todos los proveedores admiten todos los parámetros. La herramienta pasa lo q
Al generar una imagen, OpenClaw prueba los proveedores en este orden:
1. **Parámetro `model`** de la llamada a la herramienta (si el agente especifica uno)
1. El parámetro **`model`** de la llamada a la herramienta (si el agente especifica uno)
2. **`imageGenerationModel.primary`** de la configuración
3. **`imageGenerationModel.fallbacks`** en orden
4. **Detección automática** — usa solo valores predeterminados de proveedores respaldados por autenticación:
- primero el proveedor predeterminado actual
- luego los proveedores restantes de generación de imágenes registrados, en orden de id de proveedor
- luego los proveedores de generación de imágenes registrados restantes en orden de ID de proveedor
Si un proveedor falla (error de autenticación, límite de tasa, etc.), se prueba automáticamente el siguiente candidato. Si todos fallan, el error incluye detalles de cada intento.
Si un proveedor falla (error de autenticación, límite de velocidad, etc.), se prueba automáticamente el siguiente candidato. Si todos fallan, el error incluye detalles de cada intento.
Notas:
- La detección automática es consciente de la autenticación. Un valor predeterminado de proveedor solo entra en la lista de candidatos cuando OpenClaw puede autenticar realmente ese proveedor.
- Usa `action: "list"` para inspeccionar los proveedores actualmente registrados, sus modelos predeterminados y las sugerencias de variables de entorno de autenticación.
- La detección automática tiene en cuenta la autenticación. Un valor predeterminado de proveedor solo entra en la lista de candidatos
cuando OpenClaw realmente puede autenticar ese proveedor.
- Usa `action: "list"` para inspeccionar los proveedores registrados actualmente, sus
modelos predeterminados y las sugerencias de variables de entorno para autenticación.
### Edición de imágenes
OpenAI, Google, fal, MiniMax y ComfyUI admiten edición de imágenes de referencia. Pasa una ruta o URL de imagen de referencia:
OpenAI, Google, fal, MiniMax y ComfyUI admiten la edición de imágenes de referencia. Pasa una ruta o URL de imagen de referencia:
```
"Genera una versión en acuarela de esta foto" + image: "/path/to/photo.jpg"
@ -122,29 +124,29 @@ OpenAI, Google, fal, MiniMax y ComfyUI admiten edición de imágenes de referenc
OpenAI y Google admiten hasta 5 imágenes de referencia mediante el parámetro `images`. fal, MiniMax y ComfyUI admiten 1.
La generación de imágenes de MiniMax está disponible a través de ambas rutas integradas de autenticación de MiniMax:
La generación de imágenes de MiniMax está disponible a través de ambas rutas de autenticación MiniMax incluidas:
- `minimax/image-01` para configuraciones con clave de API
- `minimax-portal/image-01` para configuraciones con OAuth
## Capacidades del proveedor
| Capability | OpenAI | Google | fal | MiniMax | ComfyUI | Vydra |
| --------------------- | -------------------- | -------------------- | ------------------- | -------------------------- | ---------------------------------- | ----- |
| Generar | Sí (hasta 4) | Sí (hasta 4) | Sí (hasta 4) | Sí (hasta 9) | Sí (salidas definidas por workflow) | Sí (1) |
| Edición/referencia | Sí (hasta 5 imágenes) | Sí (hasta 5 imágenes) | Sí (1 imagen) | Sí (1 imagen, ref. de sujeto) | Sí (1 imagen, configurada por workflow) | No |
| Control de tamaño | Sí | Sí | Sí | No | No | No |
| Relación de aspecto | No | Sí | Sí (solo generar) | Sí | No | No |
| Resolución (1K/2K/4K) | No | Sí | Sí | No | No | No |
| Capacidad | OpenAI | Google | fal | MiniMax | ComfyUI | Vydra |
| --------------------- | -------------------- | -------------------- | ------------------- | -------------------------- | ---------------------------------- | ------- |
| Generar | Sí (hasta 4) | Sí (hasta 4) | Sí (hasta 4) | Sí (hasta 9) | Sí (salidas definidas por el flujo de trabajo) | Sí (1) |
| Edición/referencia | Sí (hasta 5 imágenes) | Sí (hasta 5 imágenes) | Sí (1 imagen) | Sí (1 imagen, ref. de sujeto) | Sí (1 imagen, configurada por flujo de trabajo) | No |
| Control de tamaño | Sí | Sí | Sí | No | No | No |
| Relación de aspecto | No | Sí | Sí (solo generación) | Sí | No | No |
| Resolución (1K/2K/4K) | No | Sí | Sí | No | No | No |
## Relacionado
- [Resumen de herramientas](/es/tools) — todas las herramientas de agente disponibles
- [fal](/providers/fal) — configuración del proveedor de imágenes y video de fal
- [ComfyUI](/providers/comfy) — configuración de workflows de ComfyUI local y Comfy Cloud
- [Resumen de herramientas](/es/tools) — todas las herramientas del agente disponibles
- [fal](/es/providers/fal) — configuración del proveedor de imágenes y video de fal
- [ComfyUI](/es/providers/comfy) — configuración de flujos de trabajo locales de ComfyUI y Comfy Cloud
- [Google (Gemini)](/es/providers/google) — configuración del proveedor de imágenes Gemini
- [MiniMax](/es/providers/minimax) — configuración del proveedor de imágenes MiniMax
- [OpenAI](/es/providers/openai) — configuración del proveedor OpenAI Images
- [Vydra](/providers/vydra) — configuración de imágenes, video y voz de Vydra
- [Referencia de configuración](/es/gateway/configuration-reference#agent-defaults) — configuración `imageGenerationModel`
- [Models](/es/concepts/models) — configuración de modelos y failover
- [Vydra](/es/providers/vydra) — configuración de imágenes, video y voz de Vydra
- [Referencia de configuración](/es/gateway/configuration-reference#agent-defaults) — configuración de `imageGenerationModel`
- [Modelos](/es/concepts/models) — configuración de modelos y conmutación por error

140
docs/es/tools/video-generation.md
View File

@ -2,29 +2,29 @@
read_when:
- Generar videos mediante el agente
- Configurar proveedores y modelos de generación de video
- Comprender los parámetros de la herramienta video_generate
summary: Generar videos a partir de texto, imágenes o videos existentes usando 12 backends de proveedor
- Comprender los parámetros de la herramienta `video_generate`
summary: Genera videos a partir de texto, imágenes o videos existentes mediante 12 backends de proveedores
title: Generación de video
x-i18n:
generated_at: "2026-04-06T03:13:12Z"
generated_at: "2026-04-06T05:12:32Z"
model: gpt-5.4
provider: openai
source_hash: 4afec87368232221db1aa5a3980254093d6a961b17271b2dcbf724e6bd455b16
source_hash: 90d8a392b35adbd899232b02c55c10895b9d7ffc9858d6ca448f2e4e4a57f12f
source_path: tools/video-generation.md
workflow: 15
---
# Generación de video
Los agentes de OpenClaw pueden generar videos a partir de prompts de texto, imágenes de referencia o videos existentes. Se admiten doce backends de proveedor, cada uno con distintas opciones de modelo, modos de entrada y conjuntos de funciones. El agente elige automáticamente el proveedor adecuado según tu configuración y las claves de API disponibles.
Los agentes de OpenClaw pueden generar videos a partir de indicaciones de texto, imágenes de referencia o videos existentes. Se admiten doce backends de proveedores, cada uno con distintas opciones de modelo, modos de entrada y conjuntos de funciones. El agente elige automáticamente el proveedor adecuado según tu configuración y las claves de API disponibles.
<Note>
La herramienta `video_generate` solo aparece cuando al menos un proveedor de generación de video está disponible. Si no la ves en las herramientas de tu agente, establece una clave de API del proveedor o configura `agents.defaults.videoGenerationModel`.
La herramienta `video_generate` solo aparece cuando hay al menos un proveedor de generación de video disponible. Si no la ves en las herramientas de tu agente, configura una clave de API del proveedor o establece `agents.defaults.videoGenerationModel`.
</Note>
## Inicio rápido
1. Establece una clave de API para cualquier proveedor compatible:
1. Configura una clave de API para cualquier proveedor compatible:
```bash
export GEMINI_API_KEY="your-key"
@ -36,13 +36,13 @@ export GEMINI_API_KEY="your-key"
openclaw config set agents.defaults.videoGenerationModel.primary "google/veo-3.1-fast-generate-preview"
```
3. Pídele al agente:
3. Pídeselo al agente:
> Genera un video cinematográfico de 5 segundos de una langosta amigable surfeando al atardecer.
> Genera un video cinematográfico de 5 segundos de una langosta amistosa surfeando al atardecer.
El agente llama a `video_generate` automáticamente. No se necesita lista de permitidos para herramientas.
El agente llama a `video_generate` automáticamente. No se necesita ninguna lista de herramientas permitidas.
## Qué ocurre cuando generas un video
## Qué sucede cuando generas un video
La generación de video es asíncrona. Cuando el agente llama a `video_generate` en una sesión:
@ -51,28 +51,28 @@ La generación de video es asíncrona. Cuando el agente llama a `video_generate`
3. Cuando el video está listo, OpenClaw reactiva la misma sesión con un evento interno de finalización.
4. El agente publica el video terminado de vuelta en la conversación original.
Mientras un trabajo está en curso, las llamadas duplicadas a `video_generate` en la misma sesión devuelven el estado actual de la tarea en lugar de iniciar otra generación. Usa `openclaw tasks list` o `openclaw tasks show <taskId>` para comprobar el progreso desde la CLI.
Mientras una tarea está en curso, las llamadas duplicadas a `video_generate` en la misma sesión devuelven el estado actual de la tarea en lugar de iniciar otra generación. Usa `openclaw tasks list` o `openclaw tasks show <taskId>` para comprobar el progreso desde la CLI.
Fuera de las ejecuciones de agente respaldadas por sesión (por ejemplo, invocaciones directas de herramientas), la herramienta recurre a la generación en línea y devuelve la ruta final del medio en el mismo turno.
Fuera de las ejecuciones del agente respaldadas por sesión (por ejemplo, invocaciones directas de herramientas), la herramienta recurre a la generación en línea y devuelve la ruta del medio final en el mismo turno.
## Proveedores compatibles
| Provider | Modelo predeterminado | Texto | Ref. de imagen | Ref. de video | Clave de API |
| -------- | ------------------------------- | ----- | ----------------- | ----------------- | ---------------------------------------- |
| Alibaba | `wan2.6-t2v` | Sí | Sí (URL remota) | Sí (URL remota) | `MODELSTUDIO_API_KEY` |
| BytePlus | `seedance-1-0-lite-t2v-250428` | Sí | 1 imagen | No | `BYTEPLUS_API_KEY` |
| ComfyUI | `workflow` | Sí | 1 imagen | No | `COMFY_API_KEY` o `COMFY_CLOUD_API_KEY` |
| fal | `fal-ai/minimax/video-01-live` | Sí | 1 imagen | No | `FAL_KEY` |
| Google | `veo-3.1-fast-generate-preview` | Sí | 1 imagen | 1 video | `GEMINI_API_KEY` |
| MiniMax | `MiniMax-Hailuo-2.3` | Sí | 1 imagen | No | `MINIMAX_API_KEY` |
| OpenAI | `sora-2` | Sí | 1 imagen | 1 video | `OPENAI_API_KEY` |
| Qwen | `wan2.6-t2v` | Sí | Sí (URL remota) | Sí (URL remota) | `QWEN_API_KEY` |
| Runway | `gen4.5` | Sí | 1 imagen | 1 video | `RUNWAYML_API_SECRET` |
| Together | `Wan-AI/Wan2.2-T2V-A14B` | Sí | 1 imagen | No | `TOGETHER_API_KEY` |
| Vydra | `veo3` | Sí | 1 imagen (`kling`) | No | `VYDRA_API_KEY` |
| xAI | `grok-imagine-video` | Sí | 1 imagen | 1 video | `XAI_API_KEY` |
| Proveedor | Modelo predeterminado | Texto | Imagen de ref. | Video de ref. | Clave de API |
| --------- | ------------------------------- | ----- | ----------------- | ---------------- | ----------------------------------------- |
| Alibaba | `wan2.6-t2v` | Sí | Sí (URL remota) | Sí (URL remota) | `MODELSTUDIO_API_KEY` |
| BytePlus | `seedance-1-0-lite-t2v-250428` | Sí | 1 imagen | No | `BYTEPLUS_API_KEY` |
| ComfyUI | `workflow` | Sí | 1 imagen | No | `COMFY_API_KEY` o `COMFY_CLOUD_API_KEY` |
| fal | `fal-ai/minimax/video-01-live` | Sí | 1 imagen | No | `FAL_KEY` |
| Google | `veo-3.1-fast-generate-preview` | Sí | 1 imagen | 1 video | `GEMINI_API_KEY` |
| MiniMax | `MiniMax-Hailuo-2.3` | Sí | 1 imagen | No | `MINIMAX_API_KEY` |
| OpenAI | `sora-2` | Sí | 1 imagen | 1 video | `OPENAI_API_KEY` |
| Qwen | `wan2.6-t2v` | Sí | Sí (URL remota) | Sí (URL remota) | `QWEN_API_KEY` |
| Runway | `gen4.5` | Sí | 1 imagen | 1 video | `RUNWAYML_API_SECRET` |
| Together | `Wan-AI/Wan2.2-T2V-A14B` | Sí | 1 imagen | No | `TOGETHER_API_KEY` |
| Vydra | `veo3` | Sí | 1 imagen (`kling`) | No | `VYDRA_API_KEY` |
| xAI | `grok-imagine-video` | Sí | 1 imagen | 1 video | `XAI_API_KEY` |
Algunos proveedores aceptan variables de entorno adicionales o alternativas para la clave de API. Consulta las páginas individuales de [proveedores](#related) para más detalles.
Algunos proveedores aceptan variables de entorno de clave de API adicionales o alternativas. Consulta las [páginas de proveedores](#related) individuales para obtener más detalles.
Ejecuta `video_generate action=list` para inspeccionar los proveedores y modelos disponibles en tiempo de ejecución.
@ -80,13 +80,13 @@ Ejecuta `video_generate action=list` para inspeccionar los proveedores y modelos
### Obligatorios
| Parameter | Type | Descripción |
| --------- | ------ | ------------------------------------------------------------------------------- |
| `prompt` | string | Descripción en texto del video que se va a generar (obligatorio para `action: "generate"`) |
| Parámetro | Tipo | Descripción |
| --------- | ------ | ---------------------------------------------------------------------------- |
| `prompt` | string | Descripción de texto del video que se va a generar (obligatoria para `action: "generate"`) |
### Entradas de contenido
| Parameter | Type | Descripción |
| Parámetro | Tipo | Descripción |
| --------- | -------- | ---------------------------------------- |
| `image` | string | Una sola imagen de referencia (ruta o URL) |
| `images` | string[] | Varias imágenes de referencia (hasta 5) |
@ -95,28 +95,28 @@ Ejecuta `video_generate action=list` para inspeccionar los proveedores y modelos
### Controles de estilo
| Parameter | Type | Descripción |
| ----------------- | ------- | ----------------------------------------------------------------------- |
| `aspectRatio` | string | `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9` |
| `resolution` | string | `480P`, `720P` o `1080P` |
| `durationSeconds` | number | Duración objetivo en segundos (redondeada al valor compatible más cercano del proveedor) |
| `size` | string | Sugerencia de tamaño cuando el proveedor lo admite |
| `audio` | boolean | Habilita audio generado cuando se admite |
| `watermark` | boolean | Activa o desactiva la marca de agua del proveedor cuando se admite |
| Parámetro | Tipo | Descripción |
| ---------------- | ------- | ----------------------------------------------------------------------- |
| `aspectRatio` | string | `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9` |
| `resolution` | string | `480P`, `720P` o `1080P` |
| `durationSeconds` | number | Duración objetivo en segundos (redondeada al valor compatible más cercano del proveedor) |
| `size` | string | Indicación de tamaño cuando el proveedor lo admite |
| `audio` | boolean | Habilita el audio generado cuando se admite |
| `watermark` | boolean | Activa o desactiva la marca de agua del proveedor cuando se admite |
### Avanzados
| Parameter | Type | Descripción |
| ---------- | ------ | ---------------------------------------------- |
| `action` | string | `"generate"` (predeterminado), `"status"` o `"list"` |
| `model` | string | Anulación de proveedor/modelo (por ejemplo `runway/gen4.5`) |
| `filename` | string | Sugerencia de nombre de archivo de salida |
| Parámetro | Tipo | Descripción |
| --------- | ------ | ---------------------------------------------- |
| `action` | string | `"generate"` (predeterminado), `"status"` o `"list"` |
| `model` | string | Anulación de proveedor/modelo (por ejemplo, `runway/gen4.5`) |
| `filename` | string | Sugerencia de nombre de archivo de salida |
No todos los proveedores admiten todos los parámetros. Las anulaciones no compatibles se ignoran en base a best-effort y se informan como advertencias en el resultado de la herramienta. Los límites estrictos de capacidad (como demasiadas entradas de referencia) fallan antes del envío.
No todos los proveedores admiten todos los parámetros. Las anulaciones no compatibles se ignoran según el mejor esfuerzo y se informan como advertencias en el resultado de la herramienta. Los límites estrictos de capacidad (como demasiadas entradas de referencia) fallan antes del envío.
## Acciones
- **generate** (predeterminada) -- crea un video a partir del prompt dado y entradas de referencia opcionales.
- **generate** (predeterminada) -- crea un video a partir de la indicación dada y entradas de referencia opcionales.
- **status** -- comprueba el estado de la tarea de video en curso para la sesión actual sin iniciar otra generación.
- **list** -- muestra los proveedores, modelos y sus capacidades disponibles.
@ -127,7 +127,7 @@ Al generar un video, OpenClaw resuelve el modelo en este orden:
1. **Parámetro de herramienta `model`** -- si el agente especifica uno en la llamada.
2. **`videoGenerationModel.primary`** -- desde la configuración.
3. **`videoGenerationModel.fallbacks`** -- se prueban en orden.
4. **Detección automática** -- usa proveedores que tienen autenticación válida, empezando por el proveedor predeterminado actual y luego los proveedores restantes en orden alfabético.
4. **Detección automática** -- usa los proveedores que tienen autenticación válida, comenzando por el proveedor predeterminado actual y luego los proveedores restantes en orden alfabético.
Si un proveedor falla, se prueba automáticamente el siguiente candidato. Si todos los candidatos fallan, el error incluye detalles de cada intento.
@ -146,20 +146,20 @@ Si un proveedor falla, se prueba automáticamente el siguiente candidato. Si tod
## Notas sobre proveedores
| Provider | Notas |
| -------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| Alibaba | Usa el endpoint asíncrono de DashScope/Model Studio. Las imágenes y videos de referencia deben ser URL remotas `http(s)`. |
| BytePlus | Solo una imagen de referencia. |
| ComfyUI | Ejecución local o cloud impulsada por workflows. Admite texto a video e imagen a video mediante el grafo configurado. |
| fal | Usa un flujo respaldado por cola para trabajos de larga duración. Solo una imagen de referencia. |
| Google | Usa Gemini/Veo. Admite una imagen o un video de referencia. |
| MiniMax | Solo una imagen de referencia. |
| OpenAI | Solo se reenvía la anulación `size`. Otras anulaciones de estilo (`aspectRatio`, `resolution`, `audio`, `watermark`) se ignoran con advertencia. |
| Qwen | Mismo backend DashScope que Alibaba. Las entradas de referencia deben ser URL remotas `http(s)`; los archivos locales se rechazan de entrada. |
| Runway | Admite archivos locales mediante URI de datos. Video a video requiere `runway/gen4_aleph`. Las ejecuciones de solo texto exponen relaciones de aspecto `16:9` y `9:16`. |
| Together | Solo una imagen de referencia. |
| Vydra | Usa `https://www.vydra.ai/api/v1` directamente para evitar redirecciones que eliminan la autenticación. `veo3` está integrado solo como texto a video; `kling` requiere una URL de imagen remota. |
| xAI | Admite flujos de texto a video, imagen a video y edición/extensión de video remoto. |
| Proveedor | Notas |
| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Alibaba | Usa el endpoint asíncrono de DashScope/Model Studio. Las imágenes y videos de referencia deben ser URL `http(s)` remotas. |
| BytePlus | Solo admite una imagen de referencia. |
| ComfyUI | Ejecución local o en la nube basada en flujos de trabajo. Admite texto a video e imagen a video mediante el grafo configurado. |
| fal | Usa un flujo respaldado por cola para trabajos de larga duración. Solo admite una imagen de referencia. |
| Google | Usa Gemini/Veo. Admite una imagen o un video de referencia. |
| MiniMax | Solo admite una imagen de referencia. |
| OpenAI | Solo se reenvía la anulación `size`. Las demás anulaciones de estilo (`aspectRatio`, `resolution`, `audio`, `watermark`) se ignoran con una advertencia. |
| Qwen | El mismo backend de DashScope que Alibaba. Las entradas de referencia deben ser URL `http(s)` remotas; los archivos locales se rechazan por adelantado. |
| Runway | Admite archivos locales mediante URI de datos. Video a video requiere `runway/gen4_aleph`. Las ejecuciones solo con texto exponen las relaciones de aspecto `16:9` y `9:16`. |
| Together | Solo admite una imagen de referencia. |
| Vydra | Usa `https://www.vydra.ai/api/v1` directamente para evitar redirecciones que eliminan la autenticación. `veo3` se incluye solo como texto a video; `kling` requiere una URL de imagen remota. |
| xAI | Admite flujos de texto a video, imagen a video y edición/extensión de video remoto. |
## Configuración
@ -187,18 +187,18 @@ openclaw config set agents.defaults.videoGenerationModel.primary "qwen/wan2.6-t2
## Relacionado
- [Resumen de herramientas](/es/tools)
- [Tareas en segundo plano](/es/automation/tasks) -- seguimiento de tareas para generación de video asíncrona
- [Alibaba Model Studio](/providers/alibaba)
- [BytePlus](/providers/byteplus)
- [ComfyUI](/providers/comfy)
- [fal](/providers/fal)
- [Tareas en segundo plano](/es/automation/tasks) -- seguimiento de tareas para la generación asíncrona de video
- [Alibaba Model Studio](/es/providers/alibaba)
- [BytePlus](/es/concepts/model-providers#byteplus-international)
- [ComfyUI](/es/providers/comfy)
- [fal](/es/providers/fal)
- [Google (Gemini)](/es/providers/google)
- [MiniMax](/es/providers/minimax)
- [OpenAI](/es/providers/openai)
- [Qwen](/es/providers/qwen)
- [Runway](/providers/runway)
- [Runway](/es/providers/runway)
- [Together AI](/es/providers/together)
- [Vydra](/providers/vydra)
- [Vydra](/es/providers/vydra)
- [xAI](/es/providers/xai)
- [Referencia de configuración](/es/gateway/configuration-reference#agent-defaults)
- [Models](/es/concepts/models)
- [Modelos](/es/concepts/models)