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 插件提供。

适用场景

当你需要一个编译过的知识库，并具备以下能力时，使用 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 后重试。

OpenClaw wiki CLI 命令与知识库管理 #

适用场景 #

常用命令示例 #

命令详解 #

wiki status #

wiki doctor #

wiki init #

wiki ingest &lt;path-or-url&gt; #

wiki compile #

wiki lint #

wiki search &lt;query&gt; #

wiki get &lt;lookup&gt; #

wiki apply #

wiki bridge import #

wiki unsafe-local import #

wiki obsidian ... #

实用建议 #

配置关联 #

常见问题 #

openclaw wiki init 创建失败怎么办？ #

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

openclaw wiki bridge import 不生效怎么办？ #