researchvault
Local-first research orchestration engine. Manages state, synthesis, and optional background services (MCP/Watchdog).
- License 许可
- MIT
- 最近更新
- 2026-06-07
- Stars
- ★ 0
- Forks
- 1
01 前言 Front Matter
- name
- researchvault
- homepage
- https://github.com/lraivisto/ResearchVault
- metadata
- { "openclaw": { "emoji": "🦞", "install": [ { "id": "vault-venv", "kind": "exec", "label": "Initialize ResearchVault (Standard)", "command": "python3 -m venv .venv && . .venv/bin/activate && pip install -e ." } ], "requires": { "env": { "BRAVE_API_KEY": { "required": false, "description": "Optional: Brave Search API key." }, "SSL_CERT_FILE": { "required": false, "description": "Optional: custom CA certificate file." }, "SERPER_API_KEY": { "required": false, "description": "Optional: Serper API key." }, "RESEARCHVAULT_DB": { "required": false, "description": "Optional: Custom path to the SQLite database file." }, "SEARXNG_BASE_URL": { "required": false, "description": "Optional: SearXNG base URL." }, "REQUESTS_CA_BUNDLE": { "required": false, "description": "Optional: custom CA bundle for HTTPS verification." }, "RESEARCHVAULT_PORTAL_HOST": { "required": false, "description": "Optional: backend bind host." }, "RESEARCHVAULT_PORTAL_PORT": { "required": false, "description": "Optional: backend bind port." }, "RESEARCHVAULT_PORTAL_TOKEN": { "required": false, "description": "Optional: static portal token. If unset, start_portal.sh sources/generates .portal_auth and exports this env var." }, "RESEARCHVAULT_MCP_TRANSPORT": { "required": false, "description": "Optional: MCP server transport override." }, "RESEARCHVAULT_PORTAL_RELOAD": { "required": false, "description": "Optional: set to 'true' for backend auto-reload." }, "RESEARCHVAULT_PORTAL_PID_DIR": { "required": false, "description": "Optional: start_portal.sh PID/log directory." }, "RESEARCHVAULT_PORTAL_STATE_DIR": { "required": false, "description": "Optional: portal state directory (default ~/.researchvault/portal)." }, "RESEARCHVAULT_SEARCH_PROVIDERS": { "required": false, "description": "Optional: search provider order override." }, "RESEARCHVAULT_PORTAL_SHOW_TOKEN": { "required": false, "description": "Optional: set to '1' to print tokenized portal URLs." }, "RESEARCHVAULT_VERIFY_INGEST_TOP": { "required": false, "description": "Optional: verify ingest top-k override." }, "RESEARCHVAULT_PORTAL_CORS_ORIGINS": { "required": false, "description": "Optional: comma-separated CORS origins for backend." }, "RESEARCHVAULT_WATCHDOG_INGEST_TOP": { "required": false, "description": "Optional: watchdog ingest top-k override." }, "RESEARCHVAULT_PORTAL_COOKIE_SECURE": { "required": false, "description": "Optional: set to 'true' to mark auth cookie Secure." }, "RESEARCHVAULT_PORTAL_FRONTEND_HOST": { "required": false, "description": "Optional: frontend bind host." }, "RESEARCHVAULT_PORTAL_FRONTEND_PORT": { "required": false, "description": "Optional: frontend bind port." }, "RESEARCHVAULT_PORTAL_SCAN_OPENCLAW": { "required": false, "description": "Optional: set to '1' to request OpenClaw workspace DB scan." }, "RESEARCHVAULT_PORTAL_INJECT_SECRETS": { "required": false, "description": "Optional: set to '1' to inject configured provider env vars into vault subprocesses." }, "RESEARCHVAULT_PORTAL_ALLOWED_DB_ROOTS": { "required": false, "description": "Optional: comma-separated absolute DB roots. Default: ~/.researchvault,/tmp." } }, "python": ">=3.13" } } }
- description
- Local-first research orchestration engine. Manages state, synthesis, and optional background services (MCP/Watchdog).
- user-invocable
- true
- disable-model-invocation
- true
03 SKILL.md 正文
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-networksto override. - Manual Opt-in Services: Background watchers and MCP servers are in
scripts/services/and must be started manually. - Strict Control:
disable-model-invocation: trueprevents the model from autonomously starting background tasks.
Installation
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
Quick Start
-
Initialize Project:
python scripts/vault.py init --objective "Analyze AI trends" --name "Trends-2026" -
Ingest Data:
python scripts/vault.py scuttle "https://example.com" --id "trends-2026" -
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.shloads/generates.portal_authand exportsRESEARCHVAULT_PORTAL_TOKENbefore 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 scan is effective only when
RESEARCHVAULT_PORTAL_SCAN_OPENCLAW=1and~/.openclaw/workspaceis inside allowed DB roots - Provider secrets are env-only (
BRAVE_API_KEY,SERPER_API_KEY,SEARXNG_BASE_URL) and injected into subprocesses only whenRESEARCHVAULT_PORTAL_INJECT_SECRETS=1 - 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
- Maintainer: lraivisto
- License: MIT
- Issues: GitHub Issues
- Security: See SECURITY.md
04 同仓库更多 Skills
crowd-prompting
A marketplace where AI agents improve prompts, system instructions, tool descriptions, and other text-based content with domain expertise from real-world operations — and earn tokens for valuable contributions.
ceaser
Interact with the Ceaser privacy protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- shield, unshield, note management, and protocol queries. All ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). Ceaser is a privacy-preserving ETH wrapper using Noir/UltraHonk zero-knowledge proofs on Base L2 (chain ID 8453).
ceaser-send
Fully automated private ETH transfer via Ceaser Protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- all ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). WARNING -- creates observable on-chain links between user wallet and hot wallet (see Privacy Warning). Generates an ephemeral hot wallet with BIP-39 mnemonic recovery, user funds it, agent signs and broadcasts the Shield TX automatically. Exactly one manual step required (funding the hot wallet with ETH). Uses Noir/UltraHonk zero-knowledge proofs.
dilemm-ai
Compete in DilemmAI, the prisoner's dilemma AI arena at dilemm.ai. Use when an OpenClaw agent wants to create an account, design and submit strategy prompts for their bot, enter matchmaking, analyze historical matches and leaderboards, and iterate on bot strategy. Requires headless browser automation (no API available yet).
moldium
Post and manage content on the Moldium blog platform. Triggered by "post to Moldium", "write a blog post", "publish an article", etc.
arxiv-paper-reviews
Interact with arXiv Crawler API to fetch papers, read reviews, submit comments, search papers, and import papers. Use when working with arXiv papers, fetching paper lists by date/category/interest, viewing paper details with comments, submitting paper reviews, searching papers by title, or importing papers from arXiv URLs via API at http://weakaccept.top:8000/.