openclaw wiki¶

检查并维护 memory-wiki 知识库。由随附的可选 memory-wiki 插件提供。首次使用前先启用：

openclaw plugins enable memory-wiki
openclaw gateway restart

相关：Memory Wiki 插件、Memory 概述、CLI: memory

常用命令¶

openclaw wiki status
openclaw wiki doctor
openclaw wiki init
openclaw wiki ingest ./notes/alpha.md
openclaw wiki okf import ./knowledge-catalog/okf/bundles/ga4
openclaw wiki compile
openclaw wiki lint
openclaw wiki search "alpha"
openclaw wiki search "who should I ask about Teams?" --mode route-question
openclaw 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 import
openclaw wiki unsafe-local import
openclaw wiki chatgpt import --export ./chatgpt-export --dry-run
openclaw wiki chatgpt rollback <run-id>

openclaw wiki obsidian status
openclaw wiki obsidian search "alpha"
openclaw wiki obsidian open syntheses/alpha-summary.md
openclaw wiki obsidian command workspace:quick-switcher
openclaw wiki obsidian daily

智能体选择¶

当 plugins.entries.memory-wiki.config.vault.scope 为 agent 时，使用命令的 --agent <id> 选项选择知识库：

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

省略 --agent 时，CLI 操作使用配置的默认智能体，这与其他按智能体作用域的 CLI 系列一致。传入该标志可选择其他智能体。未知的智能体 id 会在 vault 操作开始前失败。如果无法解析默认智能体，错误信息会提示你传入 --agent <id> 或配置一个智能体。当 vault.scope 为 global 时，该选项不会改变所选路径。

Gateway 客户端仍需显式指定：在按智能体作用域的多智能体环境中，对基于 vault 的 wiki.* 请求传入 agentId。缺失或未知的 id 会报错。智能体回合、wiki 工具、记忆语料补充以及编译后的提示词摘要已携带当前运行时智能体上下文。

命令¶

wiki status¶

显示 vault 模式和范围、解析出的智能体、健康状况以及 Obsidian CLI 可用性。请先使用此命令检查目标 vault 是否已初始化、桥接模式是否正常，或 Obsidian 集成是否可用。

当桥接模式处于活动状态并配置为读取记忆工件时，此命令会查询正在运行的 Gateway，从而与智能体/运行时内存看到相同的活动内存插件上下文。

wiki doctor¶

运行 wiki 健康检查并报告可操作的修复建议。当不健康时以非零状态退出。

当桥接模式处于活动状态并配置为读取记忆工件时，此命令会在生成报告前查询正在运行的 Gateway。已禁用的桥接导入以及不读取记忆工件的桥接配置仍保持本地/离线。

常见问题：

• 已启用桥接模式但没有公开的记忆工件
• vault 布局无效或缺失
• 期望使用 Obsidian 模式时缺少外部 Obsidian CLI

wiki init¶

创建 wiki vault 布局和起始页面，包括顶层索引和缓存目录。

wiki ingest <path>¶

将本地 Markdown 或文本文件作为来源页面导入到 wiki 的 sources/ 文件夹中。<path> 必须是本地文件路径；目前不支持 URL 导入。拒绝二进制文件。

导入的来源页面带有溯源 frontmatter（sourceType: local-file、sourcePath、ingestedAt）。导入后始终会重新编译 vault。

标志：--title <title> 覆盖来源标题（默认：从文件名派生）。

wiki okf import <path>¶

将解包后的 Open Knowledge Format 包导入为 wiki 概念页面。

导入器会读取 OKF 目录树中的每个非保留 .md 概念文档，要求存在非空的 type 字段，并将未知的 OKF type 值视为通用概念。保留的 OKF index.md 和 log.md 文件不会作为概念导入。

导入的页面会扁平化放在 concepts/ 下，因此现有的 wiki 编译、搜索、获取、摘要和仪表盘流程立即可见。原始 OKF 概念 ID、type、resource、tags、时间戳、来源路径以及完整 frontmatter 都会保留在页面 frontmatter 中。OKF 内部 Markdown 链接会被重写为生成的 wiki 页面；损坏的或外部链接保持不变。导入后始终会重新编译 vault。

示例：

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

wiki compile¶

重建索引、相关块、仪表盘以及编译后的查询/提示词快照。该快照持久化在 OpenClaw 的共享 SQLite 插件状态中，并保存在内存中用于同步提示词投影；它不会在 vault 中创建缓存文件。

如果启用了 render.createDashboards，编译还会刷新报告页面。

wiki lint¶

对 vault 执行 lint 并生成一份报告，涵盖：

• 结构问题（损坏的链接、缺失/重复的 id、缺少页面类型或标题、无效的 frontmatter）
• 溯源缺口（缺失来源 id、缺失导入溯源信息）
• 矛盾（被标记的矛盾、冲突的声明）
• 未解决的问题
• 低置信度的页面和声明
• 过时的页面和声明

在重要的 wiki 更新后运行此命令。

wiki search <query>¶

搜索 wiki 内容。行为取决于配置：

• search.backend：shared 或 local
• search.corpus：wiki、memory 或 all
• --mode：auto、find-person、route-question、source-evidence 或 raw-claim

对于 wiki 特定的排序和溯源，请使用 wiki search。如果活动内存插件暴露了共享搜索，且你需要一次广泛的共享召回，请优先使用 openclaw memory search。

搜索模式¶

• find-person：别名、用户名、社交链接、规范 ID 和人物页面
• route-question：ask-for/best-used-for 提示与关系上下文
• source-evidence：来源页面和结构化证据字段
• raw-claim：带有声明/证据元数据的结构化声明文本

示例：

openclaw wiki search "bgroux" --mode find-person
openclaw wiki search "who knows Teams rollout?" --mode route-question
openclaw wiki search "maintainer-whois" --mode source-evidence
openclaw wiki search "strong route Teams" --mode raw-claim --json

当结果匹配结构化声明时，文本输出包含 Claim: 和 Evidence: 行。JSON 输出还额外暴露 matchedClaimId、matchedClaimStatus、matchedClaimConfidence、evidenceKinds 和 evidenceSourceIds，供智能体侧进行下钻分析。

wiki get <lookup>¶

按 ID 或相对路径读取 wiki 页面。首先解析已编译的声明 ID。 vault 激活后，现有且可见的规范 Markdown 路径只会读取 所请求的页面。新的 CLI 进程仍会对照 vault 验证已编译的 快照；缺失的索引或快照可能触发自动编译。 缺失或无效的候选路径、无扩展名路径、基名和页面 ID 保留其现有的查找回退逻辑，并可能扫描整个 vault。

Wiki 页面读取支持大文件和硬链接。读取操作会拒绝 逃逸出 vault 或经过 vault 内部符号链接的路径。

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

wiki apply¶

在无需对页面进行自由式大改的情况下应用精细变更：

• apply synthesis <title>：创建或刷新综合页面，并带有受管的摘要正文
• apply metadata <lookup>：更新现有页面上的元数据

两者都接受 --source-id、--contradiction、--question（均可重复）、--confidence <n>（0-1）和 --status <status>。apply metadata 还接受 --clear-confidence 以移除已存储的置信度值。这是演进 wiki 页面的受支持方式，可确保受管生成的块保持完整。

wiki bridge import¶

将当前启用的记忆插件中的公共记忆工件导入到 bridge 支持的来源页面。在 bridge 模式下使用此命令，将最新导出的记忆工件拉取到 wiki vault 中。

当 bridge 工件读取处于启用状态时，CLI 通过 Gateway RPC 路由导入，以便使用运行时记忆插件上下文。如果 bridge 导入被禁用或工件读取关闭，该命令保持本地/离线的零导入行为。导入后的索引刷新由 ingest.autoCompile 控制。

wiki unsafe-local import¶

在 unsafe-local 模式下，从显式配置的本地路径（unsafeLocal.paths）导入。有意保持实验性，且仅限同一台机器使用。导入后的索引刷新由 ingest.autoCompile 控制。

wiki chatgpt import¶

将 ChatGPT 导出数据导入到草稿 wiki 来源页面。

openclaw wiki chatgpt import --export ./chatgpt-export
openclaw wiki chatgpt import --export ./conversations.json --dry-run

任何更改页面的非 dry-run 导入都会记录一个导入运行 ID（打印在摘要中），回滚时需要用到它。

wiki chatgpt rollback <run-id>¶

回滚先前应用的 ChatGPT 导入运行，移除其创建的页面并恢复其覆盖的页面。导入后被更改的页面会被移动到该运行的 .openclaw-wiki/import-runs/<run-id>/recovered/ 目录下，而不是被删除。在重试和后续的 alreadyRolledBack 响应中，恢复路径仍保留在命令结果中。当目标恢复或派生工件编译未完成时，被中断的运行保持 rolling_back 状态。一个持久化的进程重启栅栏将这些阶段分隔开来：在此之后，重试会重建索引和编译缓存，而不会重写来源页面或移动后续的路径名写入。后续的正常编译可能会刷新机器管理的 Related 块。这涵盖进程内故障以及普通文件系统调用返回后的进程重启，但不涵盖内核或主机断电时的排序保证。

wiki obsidian ...¶

面向以 Obsidian 友好模式运行的 vault 的 Obsidian 辅助命令：status、search、open、command、daily。当启用 obsidian.useOfficialCli 时，这些命令要求 PATH 中存在官方 obsidian CLI。

当 vault.scope 为 agent 时，配置验证会拒绝 obsidian.useOfficialCli: true，因为 obsidian.vaultName 是一个全局设置，而非按智能体映射。Obsidian 友好的 Markdown 渲染仍然可用。

实用使用指南¶

• 当来源出处和页面身份很重要时，使用 wiki search + wiki get。
• 使用 wiki apply，而不是手动编辑受管生成的部分。
• 在信任相互矛盾或低置信度的内容之前，使用 wiki lint。
• 在进行批量导入或来源更改后，如果希望立即获得最新的仪表板和编译摘要，请使用 wiki compile。
• 当数据目录、文档导出或智能体富化管道已经输出 OKF Markdown 包时，使用 wiki okf import。
• 当 bridge 模式依赖于新导出的记忆工件时，使用 wiki bridge import。

配置关联¶

openclaw wiki 的行为由以下配置决定：

• 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

有关完整配置模型，请参阅 Memory Wiki 插件。

相关¶

• CLI 参考
• Memory wiki