A self-hosted AI assistant for academic research — manages your papers, searches literature, tracks deadlines, and answers you on the channels you already use.
# Add to your Claude Code skills
git clone https://github.com/nanoAgentTeam/research-clawGuides for using ai agents skills like research-claw.
Last scanned: 6/8/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-06-08T08:55:23.475Z",
"npmAuditRan": true,
"pipAuditRan": false
}No comments yet. Be the first to share your thoughts!
30 days in the Featured rail · terms & refunds
Your self-hosted AI research assistant — manage papers, search literature, track deadlines, and collaborate across channels.
https://github.com/user-attachments/assets/4bb9cdb6-6e4f-4325-9307-a8518d225761
Real user demo · Mobile · Powered by GLM-5 Papers produced: LLM-Based Autonomous Multi-Agent Systems Survey · Hierarchical Memory Sharing in MAS
Research Claw is a personal AI research assistant you run on your own machine. It manages your LaTeX projects, syncs with Overleaf, searches literature, tracks deadlines — and answers you on the channels you already use (CLI, Web UI, Telegram, Feishu, QQ, DingTalk).
Instead of switching between your editor, Overleaf, terminal, and search engine, you talk to one assistant that handles it all:
You: Create a paper project "MoE-Survey" and link it to Overleaf.
Bot: ✅ Project created. Overleaf linked. Switched to MoE-Survey.
You: Research the latest MoE papers and draft an introduction.
Bot: 🔎 Searching arXiv... 📝 Writing introduction... ✅ Compiled successfully.
You: /sync push
Bot: ✅ Pushed 3 files to Overleaf.
.tex / .bib files through chat/git mode for history, diff, and rollback/task mode decomposes goals into a DAG and executes in parallelWeb UI • CLI • Feishu (Lark) • Telegram • QQ • DingTalk — no public IP required
https://github.com/user-attachments/assets/fccb837c-cfc5-4063-b803-2ae900fb4a20
Linux / macOS:
git clone https://github.com/nanoAgentTeam/research-claw.git
cd research-claw
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
Research Claw relies on POSIX features (signal handling, process management, etc.) and does not run natively on Windows. The recommended approach is WSL2 (Windows Subsystem for Linux) — it runs a real Linux kernel, so networking, filesystem, and process management all behave natively. No code changes needed.
Step 1: Install WSL2
Run in PowerShell (Administrator):
get download list: wsl --list --online
NAME FRIENDLY NAME
Ubuntu Ubuntu
Ubuntu-18.04 Ubuntu 18.04 LTS
Ubuntu-20.04 Ubuntu 20.04 LTS
Choose a version to install.
wsl --install -d Ubuntu-20.04
Reboot after installation. On first launch you'll be asked to create a username and password.
Step 2: Install Python 3.11
sudo apt update && sudo apt install -y python3.11 python3.11-venv python3-pip git
Step 3: Clone and install
# Recommended: keep code on the Linux filesystem for better performance
git clone https://github.com/nanoAgentTeam/research-claw.git ~/research-claw
cd ~/research-claw
python3.11 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
Performance tip: Do not run the project under
/mnt/c/. Cross-filesystem IO between WSL and Windows is ~3-5x slower. Keep code under~/for near-native Linux performance.
Networking & ports: WSL2 networking (API calls, web search, academic search) works out of the box. When running in Gateway mode, Windows browsers can access the Web UI at http://localhost:18790 — ports are forwarded automatically.
Browser automation (optional): If you need the browser_use tool, install Chromium:
# Option A: install directly
sudo apt install -y chromium-browser
# Option B: via playwright
pip install playwright && playwright install --with-deps chromium
Windows 11 includes WSLg for GUI support; on Windows 10 headless mode works fine.
# Start the gateway — this launches the Web UI
python cli/main.py gateway --port 18790
Open http://localhost:18790/ui in your browser:
All settings are stored in
settings.json. Advanced users can edit this file directly — see Configuration Reference.
Overleaf sync enables bidirectional sync between your local LaTeX project and Overleaf — every AI edit can be pushed, and every collaborator's edit can be pulled.
python cli/main.py login
This will prompt you to choose an Overleaf instance:
| Option | Instance | Required package |
|---|---|---|
| 1 | Overleaf (default) | pip install overleaf-sync |
| 2 | CSTCloud (China Science & Technology Cloud) | pip install PySide6 (built-in, browser login only) |
The login command will call the corresponding login tool, generate .olauth, and save the instance config to settings.json.
Once .olauth is created, the system auto-detects it. Use /sync pull and /sync push inside any project.
Option A — CLI — interact directly in your terminal:
python cli/main.py agent
Option B — Gateway — Web UI + IM channels, chat from anywhere:
python cli/main.py gateway --port 18790
graph TB
subgraph Channels["Access Channels"]
direction LR
CLI["CLI"]
WebUI["Web UI"]
Feishu["Feishu"]
TG["Telegram"]
QQ["QQ"]
DT["DingTalk"]
end
Channels --> MB["MessageBus"]
MB --> AL["AgentLoop — Main Agent"]
AL --> CR["CommandRouter"]
AL --> CM["ContextManager"]
AL --> TR["ToolRegistry (40+ tools)"]
AL --> SA["Sub-Agents (Workers)"]
TR --> Proj["Project\nGit · LaTeX · Overleaf"]
TR --> LLM["LLM Provider\nOpenAI-compatible · Hot-swap"]
TR --> Auto["Automation\nScheduled cron jobs"]
The system has two spaces:
| Default (Lobby) | Project (Workspace) | |
|---|---|---|
| Purpose | Create, list, switch projects | Work on a specific paper |
| Available tools | Project management (create, import from Overleaf), Overleaf list | File editing, LaTeX compile, Git, Overleaf sync, sub-agents, literature search |
workspace/
├── Default/ # Lobby — project management & chat
└── MyPaper/
├── project.yaml # Project config
├── MyPaper/ # Core directory (LaTeX files + Git repo)
│ ├── main.tex
│ └── references.bib
└── 0314_01/