docs/en/about/02-changelog.md
All notable changes to OpenViking will be documented in this file. This changelog is automatically generated from GitHub Releases.
vlm.timeout for per-request HTTP timeouts.volcengine.api_key data-plane mode for accessing pre-created cloud VikingDB collections and indexes with an API key.write(mode="create") for creating new text resource files and automatically refreshing related semantics and vectors.OPENCLAW_STATE_DIR support for the OpenClaw plugin.recallTokenBudget and recallMaxContentChars to reduce the risk of overlong OpenClaw auto-recall context injection.ov add-memory now returns OK for asynchronous commit workflows instead of implying the background task has already finished.ov chat now reads authentication from ovcli.conf and sends the required request headers.role_id handling with the server multi-tenant model.toolResult errors caused by incompatible OpenClaw tool-call message formats.add_resource target fields, repo target URIs, filesystem mkdir, and the reindex maintenance route..bat environment read/write, shell escaping, ov.conf validation, and hardcoded paths.cache_control 400 errors for Gemini + tools and added support for OpenAI reasoning model families.write(mode=create), tools.mcp_servers, ov_tools_enable, Feishu thread settings, and VLM timeout.SECURITY.md and updated the README files, multilingual docs, and community QR code.ovcli.confopenviking-server init interactive setup wizard for local Ollama model deploymentupload.ignore_dirs in ovcli.conf to reduce noisy uploads."memory": { "version": "v1" } in ov.conf to fall back to the v1 memory pipeline.ov init or ov doctor, switch to openviking-server init and openviking-server doctor.extra_headers can now be used to inject required headers.storage.agfs.s3.disable_batch_delete.examples/codex-memory-plugin and examples/openclaw-plugin.recallPreferAbstract 与 ingestReplyAssist 的默认值以降低意外行为,PR #1204 PR #1206;新增 OpenClaw eval shell 脚本并修复评测导入问题,PR #1287 PR #1305;同时补齐 autoRecall 搜索范围与查询清洗、截断能力,PR #1225 PR #1297。main 并增加 Docker Hub push,PR #1229;修复 Docker maturin 路径并将 Gemini optional dependency 纳入镜像,PR #1295 PR #1254;CI 侧优化 API matrix、补充 timeout/SMTP 通知并修复 reusable workflow / action 问题,PR #1281 PR #1293 PR #1300 PR #1302 PR #1307。recallPreferAbstract 与 ingestReplyAssist 现在默认均为 false。如果你之前依赖默认开启行为,升级后需要显式配置,见 PR #1204 和 PR #1206。host=none 以使用双栈网络;如果你在 IPv4/IPv6 混合环境中部署,可考虑调整监听配置,见 PR #1273。recallPreferAbstract 设为 false,PR #1204 by @wlff123ingestReplyAssist 设为 false,PR #1206 by @wlff123skills 搜索范围,PR #1225 by @mvanhornadd_message 的 create time,PR #1288 by @wlff123Ciphertext too short 的问题,PR #1163 by @yc111233_wait_for_previous_archive_done 无限挂起问题,PR #1235 by @yc111233#1238、#1242 和 #1232 涉及的问题,PR #1243 by @MaojiaShenggateway.mode PR #1149,新增端到端 healthcheck 工具 PR #1180,支持 bypass session patterns PR #1194,并在 OpenViking 故障时避免阻塞 OpenClaw PR #1158。session_id PR #1074,CLI 聊天端点优先级与 grep --exclude-uri/-x 能力得到增强 PR #1143 PR #1174,目录导入 UX / 正确性与扫描 warning 契约也进一步改善 PR #1197 PR #1199。gateway.mode。如果你之前依赖安装流程自动改写该配置,升级后需要改为显式管理,见 PR #1149。--with-bot 进行安装或启动,失败时现在会直接返回错误码;依赖“失败但继续执行”行为的脚本需要同步调整,见 PR #1175。embed();此前依赖默认维度行为的调用方建议复核配置,见 PR #1183。ov status 现在会展示 embedding 与 rerank 模型使用情况,便于排障与环境核对,见 PR #1191。v0.3.3 的最终可用能力。litellm 依赖范围更新为 >=1.0.0,<1.83.1,升级时建议同步检查锁文件与兼容性,见 PR #1179。ov cli grep 新增 --exclude-uri / -x 选项,PR #1174 by @heaoxiang-aigateway.mode,PR #1149 by @LinQiang391session_id,PR #1074 by @likzncontext_type 的 URI 匹配逻辑,PR #1155 by @deepakdevpagent-only scope。.cc 文件,重复标题导致的文件名冲突得到修复,HTTP 上传链路改为更稳妥的 upload id 流程。parent_uri、Docker doctor 检查对齐,以及更细粒度的 eval token 指标。/bot/v1/chat 与 /bot/v1/chat/stream 已补齐鉴权,依赖未鉴权访问的调用方需要同步调整,见 #996。temp_upload -> temp_file_id 的方式接入上传链路,见 #1012。openclaw >= v2026.3.22,见 #1000。user_key 与 root_key 的区别说明,#1077 by @r266-tech.cc 文件,#1008 by @qin-ctx.zip 后缀的问题,#1021 by @Shawn-cf-o#833,要求 openclaw >= v2026.3.22,#1000 by @jcp0578DEFAULT_COMMIT_TOKEN_THRESHOLD 调整为 20000,#1052 by @wlff123ov reindex #795、ov doctor #851、Prometheus exporter #806、内存健康统计 API #706、可信租户头模式 #868 与 Helm Chart #800。litellm 集成,请关注这一版本中的安全策略调整:先临时硬禁用 #937,后恢复为仅允许 <1.82.6 的版本范围 #966。建议显式锁定依赖版本。zai/ 模型前缀处理,避免重复拼接 zhipu 前缀。PR #789inf/nan 分数,避免 JSON 失败。PR #824inf/nan,进一步避免 JSON crash。PR #882更新时间:2026-03-24
由于上游依赖 LiteLLM 出现公开供应链安全事件,OpenViking 在本次热修复中临时禁用所有 LiteLLM 相关入口,以避免继续安装或运行到受影响依赖。
litellmuv.lock 中的 litellm建议用户立即执行以下动作:
litellm可用命令:
这是一个以止损为目标的防御性热修复版本。LiteLLM 相关能力会暂时不可用,直到上游给出可信的修复版本和完整事故说明。
openclaw-plugin 升级到 2.0,从 memory plugin 进一步演进为 context engine。agentId 做记忆隔离。api_key 支持与默认配置能力,降低接入成本。used() 接口,用于上下文 / skill 使用追踪。commit_async(),减少阻塞风险,提升长会话稳定性。ov observer。.doc / .xls 格式的支持。~ 展开等问题。max_tokens 参数以避免 vLLM 拒绝请求,并支持 OpenAI-compatible VLM 的自定义 HTTP headers。<think> 标签,减少推理内容污染存储结果。agfs Makefile 完成跨平台兼容性重构。build_support/ 拷贝逻辑。ov chat 现在基于 rustyline 提供更完整的行编辑体验,终端交互更自然,不再出现常见的方向键控制字符问题。wait 参数控制是否同步等待结果。add-resource 工具,并支持飞书进度通知等扩展能力。preserve_structure 选项,扫描目录时可以保留原始目录层级,适合更复杂的知识组织方式。add-resource 等场景下的一些响应问题,提升日常使用稳定性。install.sh、ov.conf.example、setup 失败退出等问题,并补充了 openclaw memory plugin 的 npm 包安装路径,提升首次安装和配置过程的成功率。After upgrading, datasets/indexes generated by historical versions are not compatible with the new version and cannot be reused directly. Please rebuild the datasets after upgrading (a full rebuild is recommended) to avoid retrieval anomalies, inconsistent filtering results, or runtime errors. Stop the service -> rm -rf ./your-openviking-workspace -> restart the service with the openviking-server command.
Warning: This Release includes Breaking Chage! Before upgrading, you should stop VikingDB Server and clear workspace dir first.
openclaw-openviking-plugin (#307), strengthening integration with OpenClaw.opencode plugin and updated documentation (#351), extending capabilities for code-related scenarios.with_vector parameter from query APIs (#338) to simplify the interface design.is_leaf filters (#294), and fixed vector storage lock contention during fast restarts (#343).ov command wrapper (#325) and fixed bugs in the CLI wrapper, repo URI handling, and find command (#336, #339, #347).add-resource functionality with unit tests (#323) and added ZIP upload support for skills via the add_skill API (#312).ovcli.conf (#308) and fixed agent_id issues in the Rust CLI (#308).--version flag to openviking-server (#358) for easy version validation.Download the appropriate binary for your platform below, extract it, and add it to your PATH.
The CLI command is simply ov:
SHA256 checksums are provided for each binary for verification.
Download the appropriate binary for your platform below, extract it, and add it to your PATH.
The CLI command is simply ov:
SHA256 checksums are provided for each binary for verification.
Now you can try Server/CLI mode!
query