OpenClaw wiki CLI 用于维护 memory-wiki 知识库（vault），支持搜索、编译、lint、导入以及 Obsidian 集成。核心命令包括 wiki status（检查 vault 模式与健康状态）、wiki search（带多种搜索模式）、wiki apply（安全更新元数据/合成页）以及 wiki bridge import（从活跃 memory 插件拉取公开工件）。首次使用需先执行 wiki init 创建 vault 结构；依赖配置项位于 plugins.entries.memory-wiki.config。Obsidian 辅助子命令需要系统安装 obsidian CLI 并启用 obsidian.useOfficialCli。

OpenClaw wiki CLI 命令与知识库管理

openclaw wiki 命令用于检查和维护 memory-wiki 知识库（vault）。该命令由内置的 memory-wiki 插件提供。

相关文档：

• Memory Wiki 插件
• Memory 概述
• CLI: memory

适用场景

当你需要一个编译过的知识库，并具备以下能力时，使用 openclaw wiki：

• 原生 Wiki 搜索与页面读取
• 带来源追溯的综合摘要
• 矛盾与过时报告
• 从活跃 memory 插件通过 bridge 模式导入工件
• 可选的 Obsidian CLI 辅助命令

常用命令示例

openclaw wiki status
openclaw wiki doctor
openclaw wiki init
openclaw wiki ingest ./notes/alpha.md
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 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

命令详解

wiki status

检查当前 vault 模式、健康状态以及 Obsidian CLI 是否可用。

当你不确定 vault 是否已初始化、bridge 模式是否正常、或者 Obsidian 集成是否可用时，先执行此命令。如果 bridge 模式已启用且配置为读取 memory 工件，该命令会查询正在运行的 Gateway，从而获取与智能体/运行时 memory 一致的上下文。

wiki doctor

运行 vault 健康检查，并暴露配置或 vault 问题。

当 bridge 模式已启用且配置为读取 memory 工件时，该命令会在构建报告前查询正在运行的 Gateway。已禁用的 bridge 导入以及不读取 memory 工件的 bridge 配置仍保持本地/离线状态。

常见问题包括：

• bridge 模式已启用，但未公开 memory 工件
• vault 布局无效或缺失
• 预期使用 Obsidian 模式，但缺少外部 Obsidian CLI

wiki init

创建 wiki vault 结构和起始页面。初始化根目录结构，包括顶级索引和缓存目录。

wiki ingest <path-or-url>

将内容导入到 wiki 源层。

注意事项：

• URL 导入受 ingest.allowUrlIngest 配置控制
• 导入的源页面会在 frontmatter 中保留来源信息
• 启用后，导入完成后可自动运行编译

wiki compile

重建索引、相关块、仪表板和编译摘要。该命令会写入稳定的机器可读工件到以下路径：

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

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

wiki lint

对 vault 进行 lint 并报告：

• 结构问题
• 来源追溯缺失
• 矛盾
• 未解决问题
• 低置信度页面/声明
• 过时页面/声明

在重要 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（当活跃 memory 插件暴露了共享搜索时）。

搜索模式帮助智能体选择合适的结果表面：

• find-person：别名、用户名、社交信息、规范 ID 和人员页面
• route-question：询问/最佳用途提示及关系上下文
• 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 页面。

示例：

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

wiki apply

无自由格式页面编辑的情况下，应用精确修改。支持的流程包括：

• 创建/更新合成页
• 更新页面元数据
• 附加来源 ID
• 添加问题
• 添加矛盾
• 更新置信度/状态
• 写入结构化声明

此命令使 wiki 能够安全演化，而无需手动编辑管理的块。

wiki bridge import

从活跃 memory 插件导入公开工件到 bridge 支持的源页面。

在 bridge 模式下使用此命令时，会将最新的导出 memory 工件拉取到 wiki vault 中。对于活跃的 bridge 工件读取，CLI 通过 Gateway RPC 路由导入，以便使用运行时 memory 插件上下文。如果 bridge 导入被禁用或工件读取关闭，命令将保持本地/离线零导入行为。

wiki unsafe-local import

从 unsafe-local 模式下显式配置的本地路径导入。此命令是实验性的，仅限同机器使用。

wiki obsidian ...

在 Obsidian 友好模式下运行 vault 的 Obsidian 辅助命令。

子命令：

• status
• search
• open
• command
• daily

当启用了 obsidian.useOfficialCli 时，这些命令需要系统 PATH 中存在官方的 obsidian CLI。

实用建议

• 当来源和页面身份重要时，使用 wiki search + wiki get。
• 使用 wiki apply 而非手动编辑管理的生成部分。
• 在信任矛盾或低置信度内容前，先运行 wiki lint。
• 在批量导入或源更改后，如果需要立即获取最新仪表板和编译摘要，使用 wiki compile。
• 当 bridge 模式依赖于新导出的 memory 工件时，使用 wiki bridge import。

配置关联

openclaw wiki 的行为受以下配置项影响：

• plugins.entries.memory-wiki.config.vaultMode
• 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.render.*
• plugins.entries.memory-wiki.config.context.includeCompiledDigestPrompt

完整配置模型参见 Memory Wiki 插件文档。

常见问题

openclaw wiki init 创建失败怎么办？

首先检查 vault 目标目录是否存在写入权限。执行 openclaw wiki status 查看当前 vault 模式是否识别。如果提示“invalid or missing vault layout”，尝试手动删除 .openclaw-wiki 目录后重新运行 init。确保 plugins.entries.memory-wiki.config.vaultMode 配置正确（如 local 或 bridge）。

openclaw wiki search 搜索不到结果可能是什么原因？

检查配置项 search.corpus 是否为 wiki 或 all（如果只设了 memory 则不搜索 wiki）。如果 vault 从未编译，需要先运行 wiki compile 生成索引。另外确认 search.backend 是否支持当前 vault 类型（shared 需要 Gateway 运行且共享搜索可用）。运行 wiki doctor 可以定位配置问题。

openclaw wiki bridge import 不生效怎么办？

确认 bridge 模式已启用且 bridge.* 配置正确指向公开 memory 工件。执行 wiki status 检查 bridge 状态是否为“healthy”。如果 bridgeImportEnabled 或 bridge.readArtifacts 被设置为 false，导入会被跳过。确保 Gateway 正在运行（openclaw gateway status可验证）。如果问题持续，尝试重启 Gateway 后重试。