360 Secure SkillHub
360 安全技能中心

ResearchVault

ResearchVault 是本地优先的研究编排引擎：用 Python CLI 管理本地 SQLite 持久研究状态，支持初始化项目、抓取入库 URL、生成策略与综合分析、运行验证，并提供需手动启动的 MCP/Watchdog 后台服务与带令牌鉴权的本地门户，默认启用 SSRF 防护且不上云。

lraivisto
lraivisto
热度 78.02
最近更新 2026-05-11 15:53:07
分类：知识依赖：代码执行 / 读写文件 / 第三方 API / MCP 服务 / 联网浏览搜索应用场景：研究 / 摘要总结 / 笔记整理 / 工作流 ...

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add researchvault
Metadata
name
researchvault
description
Local-first research orchestration engine. Manages state, synthesis, and optional background services (MCP/Watchdog).
homepage
https://github.com/lraivisto/ResearchVault
disable-model-invocation
true
user-invocable
true
metadata
{"openclaw":{"emoji":"🦞","requires":{"python":">=3.13","env":{"RESEARCHVAULT_DB":{"description":"Optional: Custom path to the SQLite database file.","required":false},"BRAVE_API_KEY":{"description":"Optional: Brave Search API key.","required":false},"SERPER_API_KEY":{"description":"Optional: Serper API key.","required":false},"SEARXNG_BASE_URL":{"description":"Optional: SearXNG base URL.","required":false},"RESEARCHVAULT_PORTAL_TOKEN":{"description":"Optional: static portal token. If unset, start_portal.sh sources/generates .portal_auth and exports this env var.","required":false},"RESEARCHVAULT_PORTAL_ALLOWED_DB_ROOTS":{"description":"Optional: comma-separated absolute DB roots. Default: ~/.researchvault,/tmp.","required":false},"RESEARCHVAULT_PORTAL_STATE_DIR":{"description":"Optional: portal state directory (default ~/.researchvault/portal).","required":false},"RESEARCHVAULT_PORTAL_HOST":{"description":"Optional: backend bind host.","required":false},"RESEARCHVAULT_PORTAL_PORT":{"description":"Optional: backend bind port.","required":false},"RESEARCHVAULT_PORTAL_FRONTEND_HOST":{"description":"Optional: frontend bind host.","required":false},"RESEARCHVAULT_PORTAL_FRONTEND_PORT":{"description":"Optional: frontend bind port.","required":false},"RESEARCHVAULT_PORTAL_CORS_ORIGINS":{"description":"Optional: comma-separated CORS origins for backend.","required":false},"RESEARCHVAULT_PORTAL_RELOAD":{"description":"Optional: set to 'true' for backend auto-reload.","required":false},"RESEARCHVAULT_PORTAL_COOKIE_SECURE":{"description":"Optional: set to 'true' to mark auth cookie Secure.","required":false},"RESEARCHVAULT_PORTAL_PID_DIR":{"description":"Optional: start_portal.sh PID/log directory.","required":false},"RESEARCHVAULT_PORTAL_SHOW_TOKEN":{"description":"Optional: set to '1' to print tokenized portal URLs.","required":false},"RESEARCHVAULT_SEARCH_PROVIDERS":{"description":"Optional: search provider order override.","required":false},"RESEARCHVAULT_WATCHDOG_INGEST_TOP":{"description":"Optional: watchdog ingest top-k override.","required":false},"RESEARCHVAULT_VERIFY_INGEST_TOP":{"description":"Optional: verify ingest top-k override.","required":false},"RESEARCHVAULT_MCP_TRANSPORT":{"description":"Optional: MCP server transport override.","required":false},"REQUESTS_CA_BUNDLE":{"description":"Optional: custom CA bundle for HTTPS verification.","required":false},"SSL_CERT_FILE":{"description":"Optional: custom CA certificate file.","required":false}}}}}

ResearchVault 🦞

Local-first research orchestration engine.

ResearchVault manages persistent state, synthesis, and autonomous verification for agents.

Security & Privacy (Local First)

  • Local Storage: All data is stored in a local SQLite database (~/.researchvault/research_vault.db). No cloud sync.
  • Network Transparency: Outbound connections occur ONLY for user-requested research or Brave Search (if configured).
  • SSRF Hardening: Strict internal network blocking by default. Local/private IPs (localhost, 10.0.0.0/8, etc.) are blocked. Use --allow-private-networks to override.
  • Manual Opt-in Services: Background watchers and MCP servers are in scripts/services/ and must be started manually.
  • Strict Control: disable-model-invocation: true prevents the model from autonomously starting background tasks.

Installation

python3 -m venv .venv
source .venv/bin/activate
pip install -e .

Quick Start

  1. Initialize Project:

    python scripts/vault.py init --objective "Analyze AI trends" --name "Trends-2026"

  2. Ingest Data:

    python scripts/vault.py scuttle "https://example.com" --id "trends-2026"

  3. Autonomous Strategist:

    python scripts/vault.py strategy --id "trends-2026"

Portal (Manual Opt-In)

Start the portal explicitly:

./start_portal.sh
  • Backend: 127.0.0.1:8000
  • Frontend: 127.0.0.1:5173
  • Backend auth strictly uses RESEARCHVAULT_PORTAL_TOKEN
  • ./start_portal.sh loads/generates .portal_auth and exports RESEARCHVAULT_PORTAL_TOKEN before backend launch
  • Token login: URL hash #token=<token> (token from .portal_auth)
  • Allowed DB roots are controlled by RESEARCHVAULT_PORTAL_ALLOWED_DB_ROOTS (default ~/.researchvault,/tmp)
  • OpenClaw workspace DBs are never discovered or selectable in Portal mode
  • Provider secrets are env-only (BRAVE_API_KEY, SERPER_API_KEY, SEARXNG_BASE_URL) and are not injected into vault subprocesses
  • Both hosts are supported for browser access:
    • http://127.0.0.1:5173/#token=<token>
    • http://localhost:5173/#token=<token>

Operational commands:

./start_portal.sh --status
./start_portal.sh --stop

Security parity with CLI:

  • SSRF blocking is on by default (private/local/link-local targets denied).
  • Portal toggle Allow private networks is equivalent to CLI --allow-private-networks.

Optional Services (Manual Start)

  • MCP Server: python scripts/services/mcp_server.py
  • Watchdog: python scripts/services/watchdog.py --once

Provenance & Maintenance