CLI commands

Wiki

openclaw wiki

Inspecciona y mantiene el almacén memory-wiki. Lo proporciona el Plugin memory-wiki incluido.

Relacionado: Plugin Memory Wiki, Descripción general de la memoria, CLI: memoria

Comandos habituales

bash
openclaw wiki statusopenclaw wiki doctoropenclaw wiki initopenclaw wiki ingest ./notes/alpha.mdopenclaw wiki okf import ./knowledge-catalog/okf/bundles/ga4openclaw wiki compileopenclaw wiki lintopenclaw wiki search "alpha"openclaw wiki search "who should I ask about Teams?" --mode route-questionopenclaw wiki get entity.alpha --from 1 --lines 80 openclaw wiki apply synthesis "Alpha Summary" \  --body "Short synthesis body" \  --source-id source.alpha openclaw wiki apply metadata entity.alpha \  --source-id source.alpha \  --status review \  --question "Still active?" openclaw wiki bridge importopenclaw wiki unsafe-local importopenclaw wiki chatgpt import --export ./chatgpt-export --dry-runopenclaw wiki chatgpt rollback <run-id> openclaw wiki obsidian statusopenclaw wiki obsidian search "alpha"openclaw wiki obsidian open syntheses/alpha-summary.mdopenclaw wiki obsidian command workspace:quick-switcheropenclaw wiki obsidian daily

Selección del agente

Cuando plugins.entries.memory-wiki.config.vault.scope es agent, selecciona el almacén con la opción de nivel superior --agent <id>:

bash
openclaw wiki --agent support statusopenclaw wiki --agent support search "refund policy"openclaw wiki --agent marketing ingest ./campaign-notes.md

En una configuración con varios agentes configurados, --agent es obligatorio para las operaciones de la CLI, de modo que un comando no pueda leer ni escribir en un almacén predeterminado arbitrario. Si solo hay un agente configurado, ese agente sigue siendo el predeterminado. Los identificadores de agente desconocidos producen un error antes de que comience la operación del almacén. La opción no cambia la ruta seleccionada cuando vault.scope es global.

Los clientes del Gateway siguen la misma regla: pasa agentId en las solicitudes wiki.* respaldadas por el almacén en una configuración multiagente con ámbito de agente. La ausencia de un identificador o un identificador desconocido es un error. Los turnos del agente, las herramientas de wiki, los complementos del corpus de memoria y los resúmenes compilados para prompts ya incluyen el contexto del agente activo en tiempo de ejecución.

Comandos

wiki status

Muestra el modo y el ámbito del almacén, el agente resuelto, el estado y la disponibilidad de la CLI de Obsidian. Úsalo primero para comprobar si el almacén previsto está inicializado, si el modo puente funciona correctamente o si la integración con Obsidian está disponible.

Cuando el modo puente está activo y configurado para leer artefactos de memoria, este comando consulta el Gateway en ejecución para usar el mismo contexto activo del Plugin de memoria que la memoria del agente o del entorno de ejecución.

wiki doctor

Ejecuta comprobaciones del estado de la wiki e informa de correcciones prácticas. Termina con un código distinto de cero cuando el estado no es correcto.

Cuando el modo puente está activo y configurado para leer artefactos de memoria, este comando consulta el Gateway en ejecución antes de generar el informe. Las importaciones del puente deshabilitadas y las configuraciones del puente que no leen artefactos de memoria permanecen en modo local/sin conexión.

Problemas habituales:

  • modo puente habilitado sin artefactos públicos de memoria
  • estructura del almacén no válida o ausente
  • falta la CLI externa de Obsidian cuando se espera el modo Obsidian

wiki init

Crea la estructura del almacén de la wiki y las páginas iniciales, incluidos los índices de nivel superior y los directorios de caché.

wiki ingest <path>

Importa un archivo Markdown o de texto local en la carpeta sources/ de la wiki como página de origen. <path> debe ser una ruta de archivo local; actualmente no se admite la ingesta desde URL. Rechaza los archivos binarios.

Las páginas de origen importadas incluyen frontmatter de procedencia (sourceType: local-file, sourcePath, ingestedAt). La ingesta siempre vuelve a compilar el almacén después.

Opciones: --title <title> sustituye el título del origen (valor predeterminado: derivado del nombre del archivo).

wiki okf import <path>

Importa un paquete descomprimido de Open Knowledge Format en páginas de conceptos de la wiki.

El importador lee cada documento de concepto .md no reservado del árbol de directorios de OKF, requiere un campo type no vacío y trata los valores desconocidos de type de OKF como conceptos genéricos. Los archivos reservados index.md y log.md de OKF no se importan como conceptos.

Las páginas importadas se organizan en una estructura plana bajo concepts/, para que los flujos existentes de compilación, búsqueda, obtención, resumen y panel de la wiki las detecten de inmediato. El identificador original del concepto de OKF, type, resource, tags, la marca de tiempo, la ruta de origen y el frontmatter completo se conservan en el frontmatter de la página. Los enlaces Markdown internos de OKF se reescriben para apuntar a las páginas generadas de la wiki; los enlaces rotos o externos no se modifican. La importación siempre vuelve a compilar el almacén después.

Ejemplos:

bash
openclaw wiki okf import ./bundles/ga4openclaw wiki okf import ./bundles/ga4 --jsonopenclaw wiki search "BigQuery Table" --mode source-evidence --jsonopenclaw wiki get <path-from-json-result>

wiki compile

Vuelve a generar los índices, los bloques relacionados, los paneles y los resúmenes compilados. Escribe artefactos estables destinados a máquinas en:

  • .openclaw-wiki/cache/agent-digest.json
  • .openclaw-wiki/cache/claims.jsonl

Si render.createDashboards está habilitado, la compilación también actualiza las páginas de informes.

wiki lint

Analiza el almacén y escribe un informe que abarca:

  • problemas estructurales (enlaces rotos, identificadores ausentes o duplicados, falta el tipo o el título de la página, frontmatter no válido)
  • carencias de procedencia (identificadores de origen ausentes, procedencia de importación ausente)
  • contradicciones (contradicciones marcadas, afirmaciones en conflicto)
  • preguntas abiertas
  • páginas y afirmaciones con poca confianza
  • páginas y afirmaciones obsoletas

Ejecuta este comando después de realizar actualizaciones importantes en la wiki.

wiki search <query>

Busca en el contenido de la wiki. El comportamiento depende de la configuración:

  • search.backend: shared o local
  • search.corpus: wiki, memory o all
  • --mode: auto, find-person, route-question, source-evidence o raw-claim

Usa wiki search para obtener una clasificación y una procedencia específicas de la wiki. Para realizar una única consulta amplia en la memoria compartida, es preferible usar openclaw memory search cuando el Plugin de memoria activo ofrece búsqueda compartida.

Modos de búsqueda:

  • find-person: alias, nombres de usuario, redes sociales, identificadores canónicos y páginas de personas
  • route-question: indicaciones sobre a quién preguntar o para qué resulta más útil, y contexto de relaciones
  • source-evidence: páginas de origen y campos de pruebas estructuradas
  • raw-claim: texto de afirmaciones estructuradas con metadatos de afirmaciones y pruebas

Ejemplos:

bash
openclaw wiki search "bgroux" --mode find-personopenclaw wiki search "who knows Teams rollout?" --mode route-questionopenclaw wiki search "maintainer-whois" --mode source-evidenceopenclaw wiki search "strong route Teams" --mode raw-claim --json

La salida de texto incluye las líneas Claim: y Evidence: cuando un resultado coincide con una afirmación estructurada. La salida JSON también expone matchedClaimId, matchedClaimStatus, matchedClaimConfidence, evidenceKinds y evidenceSourceIds para permitir al agente profundizar en los resultados.

wiki get <lookup>

Lee una página de la wiki por identificador o ruta relativa.

bash
openclaw wiki get entity.alphaopenclaw wiki get syntheses/alpha-summary.md --from 1 --lines 80

wiki apply

Aplica cambios específicos sin modificar libremente las páginas:

  • apply synthesis <title>: crea o actualiza una página de síntesis con un cuerpo de resumen administrado
  • apply metadata <lookup>: actualiza los metadatos de una página existente

Ambos aceptan --source-id, --contradiction, --question (cada uno se puede repetir), --confidence <n> (0-1) y --status <status>. apply metadata también acepta --clear-confidence para eliminar un valor de confianza almacenado. Esta es la forma admitida de modificar las páginas de la wiki para mantener intactos los bloques generados administrados.

wiki bridge import

Importa artefactos públicos de memoria desde el Plugin de memoria activo en páginas de origen respaldadas por el puente. Úsalo en el modo bridge para incorporar al almacén de la wiki los artefactos de memoria exportados más recientes.

Para las lecturas activas de artefactos del puente, la CLI dirige la importación mediante RPC del Gateway, de modo que use el contexto del Plugin de memoria del entorno de ejecución. Si las importaciones del puente están deshabilitadas o las lecturas de artefactos están desactivadas, el comando conserva el comportamiento local/sin conexión de cero importaciones. La actualización del índice tras la importación está condicionada por ingest.autoCompile.

wiki unsafe-local import

Importa desde rutas locales configuradas explícitamente (unsafeLocal.paths) en el modo unsafe-local. Es intencionadamente experimental y solo funciona en el mismo equipo. La actualización del índice tras la importación está condicionada por ingest.autoCompile.

wiki chatgpt import

Importa una exportación de ChatGPT en borradores de páginas de origen de la wiki.

bash
openclaw wiki chatgpt import --export ./chatgpt-exportopenclaw wiki chatgpt import --export ./conversations.json --dry-run
Opción Valor predeterminado Descripción
--export <path> (obligatorio) Directorio de exportación de ChatGPT o ruta a conversations.json.
--dry-run false Previsualiza los recuentos de elementos creados, actualizados y omitidos sin escribir páginas.

Una importación que no sea de prueba y que cambie alguna página registra un identificador de ejecución de importación, que se muestra en el resumen y es necesario para revertirla.

wiki chatgpt rollback <run-id>

Revierte una ejecución de importación de ChatGPT aplicada anteriormente, elimina las páginas que creó y restaura las páginas que sobrescribió. No realiza ninguna operación (e informa de alreadyRolledBack) si la ejecución ya se había revertido.

wiki obsidian ...

Comandos auxiliares de Obsidian para almacenes que se ejecutan en un modo compatible con Obsidian: status, search, open, command, daily. Requieren que la CLI oficial obsidian esté disponible en PATH cuando obsidian.useOfficialCli está habilitado.

La validación de la configuración rechaza obsidian.useOfficialCli: true cuando vault.scope es agent, porque obsidian.vaultName es una única configuración global, no una asignación por agente. La representación de Markdown compatible con Obsidian sigue disponible.

Guía de uso práctico

  • Usa wiki search + wiki get cuando la procedencia y la identidad de la página sean importantes.
  • Usa wiki apply en lugar de editar manualmente las secciones generadas administradas.
  • Usa wiki lint antes de confiar en contenido contradictorio o con poca confianza.
  • Usa wiki compile después de importaciones masivas o cambios en los orígenes cuando quieras disponer inmediatamente de paneles y resúmenes compilados actualizados.
  • Usa wiki okf import cuando un catálogo de datos, una exportación de documentación o una canalización de enriquecimiento de agentes ya genere paquetes Markdown de OKF.
  • Usa wiki bridge import cuando el modo puente dependa de artefactos de memoria recién exportados.

Relación con la configuración

El comportamiento de openclaw wiki depende de:

  • plugins.entries.memory-wiki.config.vaultMode
  • plugins.entries.memory-wiki.config.vault.scope
  • plugins.entries.memory-wiki.config.vault.path
  • plugins.entries.memory-wiki.config.search.backend
  • plugins.entries.memory-wiki.config.search.corpus
  • plugins.entries.memory-wiki.config.bridge.*
  • plugins.entries.memory-wiki.config.obsidian.*
  • plugins.entries.memory-wiki.config.ingest.autoCompile
  • plugins.entries.memory-wiki.config.render.*
  • plugins.entries.memory-wiki.config.context.includeCompiledDigestPrompt

Consulta Plugin Memory Wiki para ver el modelo de configuración completo.

Relacionado

Was this useful?
On this page

On this page