The job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
Research workflow harness for Claude Code and Codex
Dr. Claw gives agents a structured research workspace with stages for survey, ideation, experiments, paper writing, and promotion. The harness wires those stages to a skill library and multiple execution backends, so you can keep the same process while switching between Claude Code, Gemini CLI, Codex, or OpenRouter models.
Builders who want their agent to handle literature review, experiments, and paper drafting in one workflow.
You can move from research idea to paper draft with reusable skills and a consistent agent workflow.
What it does
Research pipeline stages
Runs a staged workflow across Survey, Ideation, Experiment, Publication, and Promotion.
Built-in skill library
Ships more than 100 research skills for ideation, analysis, writing, rebuttals, and delivery.
Multi-backend execution
Lets you switch between Claude Code, Gemini CLI, Codex, and OpenRouter models.
Terminal harness
Provides the `drclaw` CLI for login, project control, chat, and workflow status.
OpenClaw integration
Exposes JSON commands and watcher events for mobile or chat-based control.
How to get it
- 1No cloning or manual setup required β just run
npx dr-claw
- 2Or install globally for repeated use
npm install -g dr-claw dr-claw
- 3Clone the repository
git clone https://github.com/OpenLAIR/dr-claw.git cd dr-claw
- 4Install dependencies
npm install
- 5Configure environment
cp .env.example .env # Edit .env with your preferred settings (port, etc.)
- 6Start the application
# Development mode (with hot reload) npm run dev
README
Dr. Claw: Your AI Research Assistant
Full-stack research workspace.
π Accepted to EMNLP 2026 System Demonstrations
[!NOTE] Excited about Anthropic's Claude Science (launched June 30, 2026)? Dr. Claw has been shipping the same vision since February 2026 β and it's fully open source, model-agnostic (Claude Code, Gemini CLI, Codex, plus hundreds of models via OpenRouter), and runs on your own machine with your own data and GPUs. It also covers the full research lifecycle β survey β ideation β experiments β paper writing β slides & promotion β not just computational analysis. Free to use; no subscription required.
Table of Contents
- Overview
- What's New
- Highlights
- Quick Start
- Configuration
- OpenClaw Integration
- Research Lab - Quick Example
- Usage Guide
- Claude Code Plugin
- Additional Details
- Contributing
- FAQ
- License
- Citation
- Acknowledgments
- Support & Community
Overview
Dr. Claw is a general-purpose AI research assistant designed to help researchers and builders execute end-to-end projects across different domains. From shaping an initial idea to running experiments and preparing publication-ready outputs, Dr. Claw keeps the full workflow in one place so teams can focus on research quality and iteration speed.
Product Screenshot
π° News Dashboard β A unified, scored feed across arXiv, HuggingFace, GitHub, WeChat ε ¬δΌε·, X, and Xiaohongshu
Filter by source, configure your research domains, and never leave your workspace to keep up with the field β covers arXiv, HuggingFace (Daily Papers + Models / Datasets / Spaces), GitHub trending & new repos, WeChat ε ¬δΌε· (via RSSHub), X, and Xiaohongshu.
π Skills Library β 100+ built-in research skills, auto-discovered and applied by agents
Browse skills spanning ideation, code survey, experiment development & analysis, paper writing, review response, and delivery β agents auto-discover and apply them as task-level assistance throughout the pipeline.
The Philosophy: Leveraged Cognition
Manual work is too slow. Fully automated AI is too generic. Vibe Researching is the new frontier. Dr. Claw turns your Research Taste into outsized outcomes with Agentic Execution--so you can move faster, think bigger, and still hold the line on scientific rigor.
What's New
- π Accepted to EMNLP 2026
2026-08-22β Our paper Dr. Claw: An AI Scientist Workspace for Vibe Research has been accepted to the EMNLP 2026 System Demonstrations track! Catch the live demo in Budapest, Hungary, October 24β29, 2026. - π§ͺ Auto Research Hub
2026-04-08β One click to launch fully autonomous research! Pick a tool pack (ARIS, Autoresearch, DeepScientist), hit configure, choose a workflow in Chat β and watch the agent run your entire research pipeline from idea to paper while you sleep. - π₯οΈ Desktop App & npx
2026-04-06β Dr. Claw now runs as a native desktop app! Grab the.dmg/.exefrom GitHub Releases, or runnpx dr-clawfor zero-setup instant start. - ποΈ Multi-Tab Sidebar
2026-04-06β Research Lab and Files now live side-by-side as switchable tabs in the right sidebar β everything you need, one glance away. - π File Preview Overlay
2026-04-06β Preview any project file inline with a sleek pill toggle and sidebar browser β no more context-switching! - π¬ Terminal Chat
2026-04-06β Love the terminal? Rundr-claw chatfor a fully agentic session with any OpenRouter model β zero browser required. - ποΈ Reasoning Controls
2026-03-30β Fine-tune your AI's thinking! Codex reasoning effort and Gemini thinking strength selectors are now right in Chat. - π₯οΈ Local GPU Detection
2026-03-30β Dr. Claw automatically detects your local GPU resources β ready to put that hardware to work. - π OpenRouter Provider
2026-03-28β Unlock hundreds of models (GPT-5, Claude, Gemini, DeepSeek, Llama, Kimi, and more) with a single API key. The world's models at your fingertips! - π Session Recovery
2026-03-26β Crashed mid-session? No sweat β hit the retry button and pick up right where you left off.
Earlier updates
- π‘ Auto Port Fallback
2026-03-26β Port already taken? Dr. Claw finds a free one automatically. One less thing to worry about. - π·οΈ Smart Prompt Loading
2026-03-26β Tasks auto-load into Chat with a handy badge dropdown β just click and go! - π·οΈ Session Stage Tags
2026-03-26β Sessions are now auto-tagged by research stage β instantly see where each conversation stands. - βοΈ Rebuttal Skill
2026-03-24β New skill for crafting review rebuttals β turn reviewer feedback into publication-ready responses. - π§βπ» Multi-Session Support
2026-03-21β Run multiple sessions in parallel with smart naming β juggle projects like a pro! - ποΈ Trash Bin
2026-03-21β Accidentally deleted a project? Relax β it's in the trash, ready to be restored. - π€ Dr. Claw CLI & OpenClaw
2026-03-21β Full CLI control plus an OpenClaw integration for mobile-friendly, voice-ready research management. - π Reference Library
2026-03-20β Manage your papers with a streamlined picker and local Zotero support β your literature, organized. - π Git Source Control
2026-03-20β Stage, commit, diff, and switch branches without ever leaving the app. Version control, built in. - π° News Dashboard
2026-03-14β Stay on top of research-relevant updates right inside your workspace β never miss a trending paper!
Highlights
- π¬ Research Lab β Structured dashboard for end-to-end research: define your brief, generate a pipeline of tasks, track progress across Survey β Ideation β Experiment β Publication β Promotion, and inspect source papers, ideas (rendered with LaTeX math), and cache artifacts β all at a glance
- β‘ Auto Research β Start one-click sequential task execution directly from the Project Dashboard, open the generated session live, and receive an email when the run completes
- π 100+ Research Skills β A curated library spanning idea generation, code survey, experiment development & analysis, paper writing, review response, and delivery β automatically discovered by agents and applied as task-level assistance
- ποΈ Chat-Driven Pipeline β Describe your research idea in Chat; the agent uses the
inno-pipeline-plannerskill to interactively generate a structured research brief and task list β no manual templates needed - π€ Multi-Agent Backend β Seamlessly switch between Claude Code, Gemini CLI, Codex, and OpenRouter as your execution engines
What the Pipeline Produces
| Artifact | Location | Description | |
|---|---|---|---|
| π | Survey reports | Survey/reports/ | Literature reviews with citations from arXiv, Semantic Scholar, and web sources |
| π‘ | Research ideas | Ideation/ideas/ | Brainstorming outputs with multi-persona evaluation scores |
| π¬ | Experiment code | Experiment/core_code/ | Implementation from the plan β implement β judge loop |
| π | Analysis results | Experiment/analysis/ | Statistical analysis, tables, and paper-ready figures |
| π | Paper draft | Publication/paper/ | Academic manuscript (IEEE/ACM format) with citations and LaTeX math |
| ποΈ | Presentation | Promotion/slides/ | Slide deck, TTS narration audio, and demo video |
See docs/pipeline-outputs.md for the full artifact list and project directory structure.
More Features
- π¬ Interactive Chat + Shell β Chat with your agent or drop into a full terminal β side by side with your research context
- π File & Git Explorer β Browse files with syntax highlighting, live-edit, stage changes, commit, and switch branches without leaving the UI
- π± Responsive & PWA-Ready β Desktop, tablet, and mobile layouts with bottom tab bar, swipe gestures, and Add-to-Home-Screen support
- π Session Management β Resume conversations, manage multiple sessions, and track full history across projects
Feature Gallery
Expand screenshots
Project Dashboard β Start from the project overview, review status, and launch end-to-end automation.
Skill Library β Browse reusable research skills across ideation, experimentation, and writing.
News Dashboard β Follow research-relevant updates without leaving the workspace.
Quick Start
Desktop App (Beta): Want to skip the setup below? Download the latest
.dmg(macOS) or.exe(Windows) installer from GitHub Releases and run it directly. The desktop app is currently in beta β for a more stable experience, follow the full installation steps below.
Prerequisites
- Node.js v20 or higher (v22 LTS recommended, see
.nvmrc) - At least one of the following CLI tools installed and configured:
- Some systems need native build tools for dependencies like
node-ptyandbetter-sqlite3. Ifnpm installfails, see FAQ.
Cursor agent support is in progress and coming soon.
Option 1: Run with npx (Recommended)
No cloning or manual setup required β just run:
npx dr-claw
Or install globally for repeated use:
npm install -g dr-claw
dr-claw
Then open your browser at http://localhost:3001 to create your account and start using Dr. Claw.
Option 2: Install from Source (For Development)
- Clone the repository:
git clone https://github.com/OpenLAIR/dr-claw.git
cd dr-claw
- Install dependencies:
npm install
- Configure environment:
cp .env.example .env
# Edit .env with your preferred settings (port, etc.)
Need custom ports, auth, or workspace settings? See docs/configuration.md.
- Start the application:
# Development mode (with hot reload)
npm run dev
Then create your account via the browser http://localhost:5173.
- Use the application
There are two ways to interact with Dr. Claw: the frontend UI workflow or the terminal-only. The UI provides richer visualization but may encounter occasional bugs; the terminal approach is more stable and lightweight.
Option A: Frontend UI
Open the web UI in your browser
Open your browser at http://localhost:5173 (or the port you configured in .env).
Option B: Terminal Only
Use the CLI harness with your preferred agent
Open a second terminal (keep npm run dev running in the first) and install the drclaw CLI harness:
pip install -e ./agent-harness
Then log in with the credentials you created during setup:
drclaw auth login --username YOUR_USERNAME --password YOUR_PASSWORD
Install at least one agent CLI (if you haven't already):
| Agent | Install | Auth |
|---|---|---|
| Claude Code | npm install -g @anthropic-ai/claude-code@2.1.170 | claude β follow OAuth prompt |
| Gemini CLI | npm install -g @google/gemini-cli@0.46.0 | gemini β Google sign-in, or export GOOGLE_API_KEY=... |
| Codex CLI | npm install -g @openai/codex | codex login, or export OPENAI_API_KEY=... |
| OpenRouter | No CLI needed | export OPENROUTER_API_KEY=sk-or-... (get a key at openrouter.ai/keys) |
OpenRouter lets you use any model (GPT-5, Claude, Gemini, DeepSeek, Llama, Mistral, Qwen, etc.) through a single API key. Select your model in the UI or set
OPENROUTER_MODELin.env.
Navigate to the project directory you want to work in and launch any of the agents:
cd /path/to/your/project
claude # or: gemini | codex
Skills from dr-claw/skills/ are automatically symlinked into each project's .claude/skills/ directory when the project is created, so the agent discovers them without extra configuration. You can also reference any skill manually inside a session:
> Read .claude/skills/inno-experiment-analysis/SKILL.md and follow it to analyze my results.
Option C: OpenRouter Terminal Chat
Lightweight terminal chat with any OpenRouter model
For a lightweight terminal-only experience using any OpenRouter model, use the built-in dr-claw chat command. No browser or UI required β just an interactive agentic session with full tool-calling capabilities (file I/O, shell, grep, glob, web search/fetch).
# Make sure OPENROUTER_API_KEY is set (or pass --key)
export OPENROUTER_API_KEY=sk-or-...
# Launch a chat session with any model
node server/cli.js chat --model moonshotai/kimi-k2.5
You can also pass the API key inline:
node server/cli.js chat --model anthropic/claude-sonnet-4 --key sk-or-your-key
| Flag | Description |
|---|---|
--model <slug> | OpenRouter model slug (e.g., moonshotai/kimi-k2.5, anthropic/claude-sonnet-4, deepseek/deepseek-r1) |
--key <key> | OpenRouter API key (defaults to OPENROUTER_API_KEY env var). Prefer the env var over --key to avoid exposing secrets in shell history. |
Browse all available models at openrouter.ai/models.
Option D: Desktop App
Run as a standalone desktop application (macOS & Windows)
# Development mode (launches Electron with hot reload)
npm run desktop:dev
# Build distributable installer (.dmg / .exe)
npm run desktop:dist
For details on the desktop architecture, IPC bridge, and CI/CD release process, see electron/README.md.
If agent web search does not work later, see Troubleshooting Web Search below.
OpenClaw Integration
Turn Dr. Claw into a mobile-ready, voice-friendly research secretary
OpenClaw connects to Dr. Claw through the
drclawCLI, giving you project control, smart digests, and proactive notifications β all from your phone or chat app.
Architecture
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β User (mobile / chat / voice) β
β β β
β OpenClaw ββ secretary layer βββββββββββββββββββββββββββ β
β β runs local `drclaw ...` receives push msgs β β
β β β β β
β drclaw CLI ββ stable control plane βββββββββββββββ β β
β β JSON + openclaw.* schema WebSocket β β β
β β β β β β
β Dr. Claw Server Watcher βββββ β β
β (projects, sessions, pipelines, artifacts) β β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
The integration has three layers:
| Layer | What it does |
|---|---|
| Control plane | OpenClaw executes drclaw --json ... commands locally |
| Structured contract | JSON responses carry a versioned openclaw.* schema payload |
| Proactive delivery | An event-driven watcher pushes important changes to Feishu / Lark |
Quick Start (6 steps)
Prerequisites
- Dr. Claw server running locally (
npm run devordrclaw server on) - At least one project and one execution backend (Claude Code, Gemini CLI, or Codex)
- OpenClaw with local shell /
execcapability - (Optional) Feishu / Lark channel access for push notifications
1. Start the server
npm install && npm run dev # or: drclaw server on
drclaw --json auth status # verify reachability
drclaw server statusonly reports the daemon fromdrclaw server on. If you started Dr. Claw withnpm run dev, it may showSTOPPEDeven thoughhttp://localhost:3001is working β useauth statusas the real check.
2. Install the CLI
pip install -e ./agent-harness
drclaw --help
If drclaw is not on your PATH:
PYTHONPATH=agent-harness python3 -m cli_anything.drclaw.drclaw_cli --help
3. Authenticate
drclaw auth login --username <user> --password <pass>
drclaw --json projects list # should return your projects
4. Link OpenClaw
drclaw install --server-url http://localhost:3001
# with push channel:
drclaw install --server-url http://localhost:3001 --push-channel feishu:<chat_id>
This copies the Dr. Claw skill, installs wrapper scripts, and saves the server URL and CLI path.
5. Verify the core loop
Run these four commands from OpenClaw β if they all return valid JSON, the integration is live:
drclaw --json projects list # resolve projects
drclaw --json chat waiting # find sessions needing input
drclaw --json digest portfolio # cross-project summary
drclaw --json workflow status --project <project> # single-project status
6. Reply into a session
drclaw --json chat waiting # pick a session
drclaw --json chat reply --project <proj> --session <sid> -m βContinue with option B.β
drclaw --json chat waiting --project <proj> # confirm it cleared
For multi-turn discussion within the same project:
drclaw --json chat project --project <proj> --session <sid> -m βSummarize blockers.β
Structured Schema
Machine-facing commands return a versioned openclaw field. Current families:
| Schema | Purpose |
|---|---|
openclaw.turn.v1 | Single chat turn summary |
openclaw.project.v1 | Project digest with status, counts, and next actions |
openclaw.portfolio.v1 | Cross-project overview with recommendations |
openclaw.daily.v1 | Daily digest |
openclaw.report.v1 | Mobile-ready report payload |
openclaw.event.v1 | Watcher event with derived signals |
Client rendering tips:
| When you need to... | Read this field |
|---|---|
| Decide whether to interrupt the user | openclaw.decision.needed |
| Show quick actions or voice suggestions | openclaw.next_actions |
| Render a compact summary | openclaw.turn.summary or openclaw.focus |
| Handle watcher notifications | openclaw.event.v1.event.signals |
Always prefer the
openclawpayload over rawreplytext when both are present.
Full contract: agent-harness/cli_anything/drclaw/SCHEMA.md
Proactive Watcher
The watcher is event-driven β it subscribes to Dr. Claw WebSocket events and only notifies on attention-worthy changes.
# Configure push channel
drclaw openclaw configure --push-channel feishu:<chat_id>
# Manage the watcher
drclaw --json openclaw-watch on --to feishu:<chat_id>
drclaw --json openclaw-watch status
drclaw --json openclaw-watch off
How it works:
WebSocket event β project resolution β snapshot diff β signal derivation
β
dedup (6h TTL) β stable signature + signal kinds
β
openclaw agent --deliver β Feishu / Lark summary
(fallback: plain bridge push)
Derived signals:
| Signal | Meaning |
|---|---|
human_decision_needed | Agent requests permission for a tool call |
waiting_for_human | Session is blocked on user input |
blocker_detected | A task transitioned to blocked state |
| `b |
Files in the repo
- .claude
- .github
- agent-harness
- community-tools
- docs
- electron
- public
- scripts
- server
- shared
- skills
- src
- test
- .cursorindexingignore
- .env.example
- .gitignore
- .npmignore
- .nvmrc
- .release-it.json
- CHANGELOG.md
- CITATION.cff
- index.html
- LICENSE
- modify_composer.py
- NOTICE
- package-lock.json
- package.json
- playwright.config.ts
- postcss.config.js
- README.md
- README.zh-CN.md
- release.sh
- tailwind.config.js
- tsconfig.json
- vite.config.js
- vitest.config.ts
Discussion (0)
Ask about usage, or say what you built with itSign in to join the discussion.
No comments yet. Be the first to say what this is good for.
More harnesses

The most RAM efficient harness
Open-source agentic workspace enterprises can make their own. Connect the systems you already run β 100+ integrations, MCP, chat tools, apps, browser, local files β with shared memory. Any agent (Claude Code, Codex), any model, or BYOK. Set up in clicks, not months. Local-first: your data never leaves your machines.
Annotate and review coding agent plans and code diffs visually, share with your team, send feedback to agents with one click.
Public results and task definitions for FrontierHarness Eval

Comet: agent skill harness for turning ideas into evaluated workflows