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
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 dailySelecció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>:
openclaw wiki --agent support statusopenclaw wiki --agent support search "refund policy"openclaw wiki --agent marketing ingest ./campaign-notes.mdEn 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:
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:sharedolocalsearch.corpus:wiki,memoryoall--mode:auto,find-person,route-question,source-evidenceoraw-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 personasroute-question: indicaciones sobre a quién preguntar o para qué resulta más útil, y contexto de relacionessource-evidence: páginas de origen y campos de pruebas estructuradasraw-claim: texto de afirmaciones estructuradas con metadatos de afirmaciones y pruebas
Ejemplos:
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 --jsonLa 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.
openclaw wiki get entity.alphaopenclaw wiki get syntheses/alpha-summary.md --from 1 --lines 80wiki 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 administradoapply 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.
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 getcuando la procedencia y la identidad de la página sean importantes. - Usa
wiki applyen lugar de editar manualmente las secciones generadas administradas. - Usa
wiki lintantes de confiar en contenido contradictorio o con poca confianza. - Usa
wiki compiledespués de importaciones masivas o cambios en los orígenes cuando quieras disponer inmediatamente de paneles y resúmenes compilados actualizados. - Usa
wiki okf importcuando 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 importcuando 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.vaultModeplugins.entries.memory-wiki.config.vault.scopeplugins.entries.memory-wiki.config.vault.pathplugins.entries.memory-wiki.config.search.backendplugins.entries.memory-wiki.config.search.corpusplugins.entries.memory-wiki.config.bridge.*plugins.entries.memory-wiki.config.obsidian.*plugins.entries.memory-wiki.config.ingest.autoCompileplugins.entries.memory-wiki.config.render.*plugins.entries.memory-wiki.config.context.includeCompiledDigestPrompt
Consulta Plugin Memory Wiki para ver el modelo de configuración completo.