Local Deep Research

# Local Deep Research Skill

This skill interfaces with a locally-hosted LDR (Local Deep Research) service to perform multi-cycle, iterative research with full citations and source tracking.

## What to consider before installing

- **LDR service**: The script talks only to the URL in `LDR_BASE_URL` (default `http://127.0.0.1:5000`). Only point it at an LDR instance you control. Do not set it to an unknown or untrusted remote host.
- **Required binaries**: Ensure `curl` and `jq` are installed on the host where the skill runs.
- **Credentials**: If your LDR instance requires login, set `LDR_SERVICE_USER` and `LDR_SERVICE_PASSWORD` (or `LDR_USERNAME`/`LDR_PASSWORD`) via environment variables or a local `.env` file only. Use a dedicated, low-privilege LDR account (e.g. `openclaw_service`). Do not store secrets in committed config or in the skill directory.
- **Sourced .env**: The script optionally sources `~/.config/local_deep_research/config/.env` if that file exists. That file may expose any variables it contains to the script. Verify the contents of that path before use; do not place unrelated secrets there.
- **Review the script**: The script performs form-based session+CSRF login and uses an ephemeral cookie jar. It does not send data to any endpoint other than the configured LDR service. You can review `scripts/ldr-research.sh` before use. For higher assurance, run it in an isolated environment (e.g. container or VM) with network restricted to your LDR host.

## Configuration

### Credentials (local-only, never transmitted)

LDR uses **session-cookie auth with CSRF protection** (not HTTP Basic Auth). The skill script performs a proper login flow: GET login page → obtain session cookie and CSRF token → POST credentials + CSRF → reuse session cookie (and CSRF for POSTs) for all API calls. Username and password are used **only** to create a session with your **local** LDR instance; they are never sent to ClawHub, GitHub, or any other server.

**Do not** put credenti...

# Local Deep Research (LDR) — OpenClaw Skill

> Multi-cycle deep research using a **locally-hosted** Local Deep Research (LDR) service for OpenClaw / ClawHub. Use this skill when you need comprehensive research with citations, literature reviews, competitive intelligence, or exhaustive web search with iterative question generation.

**Triggers:** "deep research", "research this topic", "comprehensive analysis with sources", "literature review", "investigate [topic]", or when local LDR is preferred over cloud research.

---

## Before installing

- **Required**: `curl` and `jq` must be installed. The skill declares these in its manifest (`requires.bins`).
- **Environment / credentials**: The skill expects `LDR_BASE_URL` (default `http://127.0.0.1:5000`) and, if your LDR uses auth, `LDR_SERVICE_USER` and `LDR_SERVICE_PASSWORD` (or `LDR_USERNAME`/`LDR_PASSWORD`). These are declared in the skill manifest (`requires.env` / `primaryEnv`). Set them via your environment or a local `.env` file only; do not commit secrets.
- **Trust**: Only point `LDR_BASE_URL` at an LDR instance you control (e.g. localhost). The script sources `~/.config/local_deep_research/config/.env` if present—verify that file’s contents and do not put unrelated secrets there.
- **Optional**: Review `scripts/ldr-research.sh`; for higher assurance, run the skill in an isolated environment with network restricted to your LDR host.

---

## Requirements

- A running **LDR** instance (e.g. `http://127.0.0.1:5000`)
- OpenClaw with network and shell permissions
- `curl` and `jq` on the host
- (If LDR has auth enabled) LDR account credentials — **stored only locally**, see below

---

## Quick start

1. **Install the skill** (e.g. via ClawHub or copy into your OpenClaw skills directory).
2. **Set LDR URL** (optional if using default):
   ```bash
   export LDR_BASE_URL="http://127.0.0.1:5000"
   ```
3. **If your LDR instance requires login**, set credentials via **environment variables or a local `.env` file onl...