文章目录什么是 OpenViking1. 文件系统管理范式FileSystem Paradigm2. 模型准备3. 环境配置来源 https://github.com/volcengine/OpenViking什么是 OpenVikingOpenViking 是火山开源的一种AI Agent 能力的开源上下文数据库。使用 OpenViking开发者可以像管理本地文件一样构建智能体的大脑文件系统管理范式 → 解决碎片化基于文件系统范式统一管理记忆、资源和技能。分层上下文加载 → 降低 Token 消耗L0/L1/L2 三层结构按需加载显著节省成本。目录递归检索 → 提升检索效果支持原生文件系统检索方式结合目录定位和语义搜索实现递归精准的上下文获取。可视化检索轨迹 → 可观察上下文支持目录检索轨迹可视化让用户清晰观察问题根源指导检索逻辑优化。自动会话管理 → 上下文自迭代自动压缩对话中的内容、资源引用、工具调用等提取长期记忆让智能体越用越聪明。1. 文件系统管理范式FileSystem ParadigmOpenViking 使用 viking:// 协议来统筹 Agent 需要的所有上下文。你可以像管理电脑文件夹一样把 Agent 的能力分为• viking://user/memories/存储用户的长期偏好和习惯。• viking://agent/skills/存储 Agent 可调用的工具和技能描述。• viking://resources/存储外部文档、知识库资源。 这种层级化的管理让开发者可以精确控制检索范围避免全量搜索带来的“噪声”。2. 模型准备volcengine 火山引擎豆包模型openai OpenAI 官方litellm 统一调用多种第三方模型 (Anthropic, DeepSeek, Gemini, vLLM, Ollama 等)3. 环境配置创建配置文件 ~/.openviking/ov.conf{storage:{workspace:/home/your-name/openviking_workspace},log:{level:INFO,output:stdout// 日志输出stdout或file},embedding:{dense:{api_base:api-endpoint, // API 端点地址api_key:your-api-key, // 模型服务 API Keyprovider:provider-type, // 提供商类型volcengine或openai当前支持dimension:1024, // 向量维度model:model-name// Embedding 模型名称如 doubao-embedding-vision-250615 或 text-embedding-3-large},max_concurrent:10// 最大并发 embedding 请求默认10},vlm:{api_base:api-endpoint, // API 端点地址api_key:your-api-key, // 模型服务 API Keyprovider:provider-type, // 提供商类型(volcengine, openai, deepseek, anthropic 等)model:model-name, // VLM 模型名称如 doubao-seed-2-0-pro-260215 或 gpt-4-vision-previewmax_concurrent:100// 语义处理的最大并发 LLM 调用默认100}}创建配置文件后设置环境变量指向它Linux/macOSexportOPENVIKING_CONFIG_FILE~/.openviking/ov.conf# 默认值在 Windows 上使用以下任一方式PowerShell$env:OPENVIKING_CONFIG_FILE$HOME/.openviking/ov.conf命令提示符 (cmd.exe)setOPENVIKING_CONFIG_FILE%USERPROFILE%\.openviking\ov.conf