环境Win11WSL2Ubuntu24.04一、相关文档记忆提供程序Memory Providersopenviking简介openviking快速开始在线服务OpenViking Service火山引擎云产品介绍二、切换vlm模型VLM视觉语言模型doubao-seed-2-0-lite面向企业规模化部署的轻量级全模态模型支持文本、图片、语音、视频四模态跨模态联合理解。集成音画协同分析、长视频时序检索、全维度音频解析、代码开发、智能Agent与GUI闭环操作能力适配大批量全模态推理业务场景。输入文本、图片、视频、音频qwen3.6-flashQwen3.6原生视觉语言系列Flash模型模型效果相较3.5-Flash显著提升。本模型重点提升agentic coding能力在多项代码智能体基准上大幅超越前代、数学推理和代码推理能力视觉方面在空间智能能力上显著增强物体定位与目标检测提升尤为突出。输入模态文本、图片、视频qwen3.7-plusQwen3.7系列中高性价比Plus模型在强大文本能力的基础上全面升级了视觉-语言能力同时保持了在编码、工具使用和生产力工作流方面的完整智能体能力。其核心特色为多模态交互混合智能体能力能够感知真实世界场景、读取屏幕并操作 GUI、基于视觉参考生成代码、端到端导航移动应用。该模型版本功能等同于快照模型qwen3.7-plus-2026-05-26输入模态文本、图片、视频openviking-server init操作uadminUD26:~$ openviking-server init ╭─────────────────────────────────────────────────────────╮ │ OpenViking Setup │ │ Context database for AI agents — data in, context out │ ╰─────────────────────────────────────────────────────────╯ Data will be stored under /home/uadmin/.openviking/data unless you edit ov.conf later. Existing config found: /home/uadmin/.openviking/ov.conf Current configuration Embedding: volcengine · doubao-embedding-vision-251215 (1024d) VLM: volcengine · doubao-seed-2-0-lite-260428 Query planner: litellm · ollama/guoxuter/ov_intent_analysis_sft:v7_q8 Server: 127.0.0.1:1933 · auth dev (no auth) What would you like to do? ↑/↓ move · enter select ❯ Start over (full setup, current config backed up as .bak) Update VLM (now: volcengine · doubao-seed-2-0-lite-260428) Update embedding (now: volcengine · doubao-embedding-vision-251215 (1024d)) Update server auth (now: 127.0.0.1:1933 · auth dev (no auth)) Cancel 选 Update VLM ---------------------------------------------------------------------------------------- ❯ Update VLM Current VLM: volcengine · doubao-seed-2-0-lite-260428 VLM provider: ↑/↓ move · enter select ❯ VolcEngine (火山引擎) (API) BytePlus (API) OpenAI (API) OpenAI Codex (Subscription) Kimi (Subscription API Key) GLM (Subscription API Key) Custom (OpenAI-compatible) (Any OpenAI-compatible endpoint) Local via Ollama (no API key, runs on this machine) 选Custom (OpenAI-compatible) ---------------------------------------------------------------------------------------- ❯ Custom (OpenAI-compatible) Custom OpenAI-compatible VLM configuration API Base URL: 输入API Base URL ---------------------------------------------------------------------------------------- API Base URL: https://dashscope.aliyuncs.com/compatible-mode/v1 API Key: 输入API Key ---------------------------------------------------------------------------------------- API Key: sk-59b0************************abcd Model: 输入模型 ---------------------------------------------------------------------------------------- Model: qwen3.6-flash Change: volcengine · doubao-seed-2-0-lite-260428 → openai · qwen3.6-flash Save configuration? [Y/n]: 输入Y ---------------------------------------------------------------------------------------- Save configuration? [Y/n]: Y Existing config backed up to /home/uadmin/.openviking/ov.conf.bak OK Configuration updated Validate the setup now? (runs openviking-server doctor) [Y/n]: 输入Y ---------------------------------------------------------------------------------------- Validate the setup now? (runs openviking-server doctor) [Y/n]: Y OpenViking Doctor Config: PASS /home/uadmin/.openviking/ov.conf Python: PASS 3.11.15 ( 3.10 required) Native Engine: PASS variantx86_avx2 AGFS: PASS AGFS SDK 0.1.7 Embedding: PASS volcengine/doubao-embedding-vision-251215 api_basehttps://ark.cn-beijing.volces.com/api/v3 dimension1024 probe ok (dimension1024) VLM: PASS openai/qwen3.6-flash Ollama: PASS running at localhost:11434 VikingBot: PASS VikingBot aligned with dev OpenViking auth Disk: PASS 948.3 GB free in /home/uadmin/.openviking/data All checks passed. Start the server now? [y/N]: 输入N ---------------------------------------------------------------------------------------- Start the server now? [y/N]: Nopenviking-server init操作日志uadminUD26:~$ openviking-server init ╭─────────────────────────────────────────────────────────╮ │ OpenViking Setup │ │ Context database for AI agents — data in, context out │ ╰─────────────────────────────────────────────────────────╯ Data will be stored under /home/uadmin/.openviking/data unless you edit ov.conf later. Existing config found: /home/uadmin/.openviking/ov.conf Current configuration Embedding: volcengine · doubao-embedding-vision-251215 (1024d) VLM: volcengine · doubao-seed-2-0-lite-260428 Query planner: litellm · ollama/guoxuter/ov_intent_analysis_sft:v7_q8 Server: 127.0.0.1:1933 · auth dev (no auth) What would you like to do? ↑/↓ move · enter select ❯ Update VLM Current VLM: volcengine · doubao-seed-2-0-lite-260428 VLM provider: ↑/↓ move · enter select ❯ Custom (OpenAI-compatible) Custom OpenAI-compatible VLM configuration API Base URL: https://dashscope.aliyuncs.com/compatible-mode/v1 API Key: sk-59b0************************abcd Model: qwen3.6-flash Change: volcengine · doubao-seed-2-0-lite-260428 → openai · qwen3.6-flash Save configuration? [Y/n]: Y Existing config backed up to /home/uadmin/.openviking/ov.conf.bak OK Configuration updated Validate the setup now? (runs openviking-server doctor) [Y/n]: Y OpenViking Doctor Config: PASS /home/uadmin/.openviking/ov.conf Python: PASS 3.11.15 ( 3.10 required) Native Engine: PASS variantx86_avx2 AGFS: PASS AGFS SDK 0.1.7 Embedding: PASS volcengine/doubao-embedding-vision-251215 api_basehttps://ark.cn-beijing.volces.com/api/v3 dimension1024 probe ok (dimension1024) VLM: PASS openai/qwen3.6-flash Ollama: PASS running at localhost:11434 VikingBot: PASS VikingBot aligned with dev OpenViking auth Disk: PASS 948.3 GB free in /home/uadmin/.openviking/data All checks passed. Start the server now? [y/N]: N三、切换embedding模型doubao-embedding-vision新版本Seed-1.6-embedding图文多模态向量化模型全新上线主要面向图文多模向量检索的使用场景支持图片输入及中、英双语文本输入最长 8K 上下文长度。输入文本、图片、视频text-embedding-v4通用文本向量V4版本是通义实验室基于Qwen3训练的多语言文本统一向量模型相较V3版本在文本检索、聚类、分类性能大幅提升在MTEB多语言、中英、Code检索等评测任务上效果提升15%~40%支持64~2048维用户自定义向量维度。输入模态文本千问也有多模态嵌入模型但是应该是openviking不支持其他厂商嵌入模型的多模态能力。就选普通个文本嵌入模型吧openviking-server init操作uadminUD26:~$ openviking-server init ╭─────────────────────────────────────────────────────────╮ │ OpenViking Setup │ │ Context database for AI agents — data in, context out │ ╰─────────────────────────────────────────────────────────╯ Data will be stored under /home/uadmin/.openviking/data unless you edit ov.conf later. Existing config found: /home/uadmin/.openviking/ov.conf Current configuration Embedding: volcengine · doubao-embedding-vision-251215 (1024d) VLM: openai · qwen3.6-flash Query planner: litellm · ollama/guoxuter/ov_intent_analysis_sft:v7_q8 Server: 127.0.0.1:1933 · auth dev (no auth) What would you like to do? ↑/↓ move · enter select ❯ Start over (full setup, current config backed up as .bak) Update VLM (now: openai · qwen3.6-flash) Update embedding (now: volcengine · doubao-embedding-vision-251215 (1024d)) Update server auth (now: 127.0.0.1:1933 · auth dev (no auth)) Cancel 选Update embedding ---------------------------------------------------------------------------------------- ❯ Update embedding Current embedding: volcengine · doubao-embedding-vision-251215 (1024d) Embedding setup: ↑/↓ move · enter select ❯ Cloud API (VolcEngine, BytePlus, OpenAI) Local via Ollama (no API key, runs on this machine) Lightweight CPU embedding (llama.cpp, ~24 MB, no Ollama needed) 选Cloud API ---------------------------------------------------------------------------------------- ❯ Cloud API Embedding provider: ↑/↓ move · enter select · ← back ❯ VolcEngine (火山引擎) BytePlus OpenAI Other (manual) 选Other (manual) ---------------------------------------------------------------------------------------- ❯ Other (manual) Config path: /home/uadmin/.openviking/ov.conf Set $EDITOR to open the config file automatically.没什么合适的选择手动修改ov.conf~/.openviking/ov.confembedding: { dense: { provider: openai, model: text-embedding-v4, api_key: sk-59b0************************abcd, api_base: https://dashscope.aliyuncs.com/compatible-mode/v1, dimension: 1024 } },openviking-server init操作日志uadminUD26:~$ openviking-server init ╭─────────────────────────────────────────────────────────╮ │ OpenViking Setup │ │ Context database for AI agents — data in, context out │ ╰─────────────────────────────────────────────────────────╯ Data will be stored under /home/uadmin/.openviking/data unless you edit ov.conf later. Existing config found: /home/uadmin/.openviking/ov.conf Current configuration Embedding: volcengine · doubao-embedding-vision-251215 (1024d) VLM: openai · qwen3.6-flash Query planner: litellm · ollama/guoxuter/ov_intent_analysis_sft:v7_q8 Server: 127.0.0.1:1933 · auth dev (no auth) What would you like to do? ↑/↓ move · enter select ❯ Update embedding Current embedding: volcengine · doubao-embedding-vision-251215 (1024d) Embedding setup: ↑/↓ move · enter select ❯ Cloud API Embedding provider: ↑/↓ move · enter select · ← back ❯ Other (manual) Config path: /home/uadmin/.openviking/ov.conf Set $EDITOR to open the config file automatically.四、处理向量数据更换嵌入模型后向量数据需要处理。如果是少量测试数据可以清理了。如果想保留数据可以重建向量数据。清理向量数据停止服务CtrlC 或pkill -f openviking-server备份数据目录cp -r ~/.openviking/data ~/.openviking/data_backup_volc_embedding删除目录rm -rf ~/.openviking/data/*#mv ~/.openviking/data ~/.openviking/data1重启服务会生成data目录openviking-server重建向量数据备份停止服务CtrlC 或pkill -f openviking-server备份数据目录cp -r ~/.openviking/data ~/.openviking/data_backup_volc_embedding启动服务报错openviking-server 启动服务报错openviking.storage.errors.EmbeddingRebuildRequiredError: Existing collection embedding metadata does not match current configuration. Rebuild is required before using the current embedding model, or set embedding.allow_metadata_overridetrue to keep existing vectors when only provider/model changed (dimension must remain the same).------------------------------------2026-07-25 06:26:44,212 - uvicorn.error - ERROR - Application startup failed. Exiting.修改ov.conf整理数据目录~/.openviking/data手动修改ov.conf~/.openviking/ov.conf在embedding下加入allow_metadata_override: trueembedding: { dense: { provider: openai, model: text-embedding-v4, api_key: sk-59b0************************abcd, api_base: https://dashscope.aliyuncs.com/compatible-mode/v1, dimension: 1024 }, allow_metadata_override: true },重启服务重建向量数据# 1. 重建全局资源库的向量手动导入的文档、素材、公共资源ov reindex viking://resources/ --mode vectors_only --wait true# 2. 重建默认用户的所有对话记忆与个人数据的向量ov reindex viking://user/default/ --mode vectors_only --wait true# 看根目录有什么 uadminUD26:~$ ov ls viking:/// cmd: ov ls viking:/// -l 256 -n 256 1. dir · 2026-07-25 07:10 viking://resources 本资源目录是Hermes智能代理框架的官方配套资源总仓当前核心承载Hermes框架内存扩展能力的全链路参考 内容覆盖跨会话持久化内存、多代理上下文管理、honcho.json配置等核心场景面向Hermes普通用户、... 2. dir · 2026-07-25 06:51 viking://user uadminUD26:~$ ov reindex viking://resources/ --mode vectors_only --wait true status completed uri viking://resources object_type resource mode vectors_only scanned_records 12 rebuilt_records 17 deleted_records 0 would_delete_records 0 unsupported_records 0 failed_records 0 duration_ms 1156 warnings [] uadminUD26:~$ ov reindex viking://user/default/ --mode vectors_only --wait true status completed uri viking://user/default object_type user_namespace mode vectors_only scanned_records 34 rebuilt_records 27 deleted_records 0 would_delete_records 0 unsupported_records 1 failed_records 0 duration_ms 1002 warnings [No semantic source found for viking://user/default/peers/hermes]测试ov finduadminUD26:~$ ov find 测试标记 cmd: ov find --uri -n 10 测试标记 10 results Ranked by relevance · limit 10 final results 1. memory · Level 2 · score 0.422 viking://user/default/memories/preferences/2026/07/24/凌晨开发_openviking-20260724.md 测试标记为 openviking-20260724开发者凌晨仍在开发中。 2. memory · Level 1 · score 0.407 viking://user/default/memories/cases/.overview.md No abstract available. 3. memory · Level 2 · score 0.396 viking://user/default/memories/trajectories/开发环境信息存储与验证_20260723085606.md # 开发环境信息存储与验证 - Domain: 长期记忆管理与知识仓库浏览 - Trigger: 用户需要保存开发环境相关事实验证语义搜索有效性浏览viking根目录结构 - Operation Intent: -...uadminUD26:~$ openviking-server --versionopenviking-server 0.4.10uadminUD26:~$ ov --helpOpenViking v0.4.11.dev0重新生成语义摘要和重建向量索引一般重建向量数据即可不用重建语义摘要。# 1. 全局资源库重新生成语义摘要 重建向量索引ov reindex viking://resources/ --mode semantic_and_vectors --wait true# 2. 默认用户记忆库重新生成语义摘要 重建向量索引ov reindex viking://user/default/ --mode semantic_and_vectors --wait trueuadminUD26:~$ ov reindex viking://resources/ --mode semantic_and_vectors --wait true status completed uri viking://resources object_type resource mode semantic_and_vectors scanned_records 12 rebuilt_records 17 deleted_records 0 would_delete_records 0 unsupported_records 0 failed_records 0 duration_ms 31131 warnings [] uadminUD26:~$ ov reindex viking://user/default/ --mode semantic_and_vectors --wait true status completed uri viking://user/default object_type user_namespace mode semantic_and_vectors scanned_records 34 rebuilt_records 29 deleted_records 0 would_delete_records 0 unsupported_records 0 failed_records 0 duration_ms 39375 warnings []uadminUD26:~$ ov reindex --helpOpenViking v0.4.11.dev0手动修改ov.conf~/.openviking/ov.conf在embedding下去掉allow_metadata_override: true重启服务