Open Source · Runs Locally · Powered by Ollama

Your system's
diagnostic companion.

DoctorClaw is a lightweight AI agent that diagnoses and fixes computer problems through natural conversation. It reads, executes, and repairs — but only when you say so.

100% Local by default
No Cloud required
Every Action requires approval
DoctorClaw
Connected
System check
Network issue
+
YOU
My network connection keeps dropping every few minutes
DOCTORCLAW
I'll help diagnose the intermittent network drops. Let me start by checking your network interface status and recent system logs.

I'd like to run: ip link show && journalctl -u NetworkManager --since "1 hour ago" --no-pager | tail -30
Approve action to continue

Everything you need to diagnose
and fix system issues.

DoctorClaw combines the power of local AI with deep system access — all under your explicit control.

Natural Conversation

Describe problems in plain language. DoctorClaw understands context and guides troubleshooting step by step, just like working with a real technician.

Multi-Session Tabs

Run parallel troubleshooting sessions with persistent browser history. Tackle multiple issues simultaneously.

OS-Aware Commands

Commands adapt automatically to Linux, macOS, or Windows. No manual translation needed.

Script Execution

Run .sh, .bash, .bat, .cmd, and .ps1 scripts from configured directories with sandboxed execution.

Dark Mode

Full dark mode support with a clean theme toggle. Easy on the eyes during those late-night debugging sessions.

Settings UI

Configure every parameter through a clean graphical interface. Model selection, path permissions, port settings, and more — no config file editing required.

Three steps to a healthy system.

DoctorClaw keeps you in control at every stage. Nothing happens without your explicit approval.

01

Describe the Problem

Tell DoctorClaw what's going wrong in plain language. Slow network? Disk filling up? Service crashing? Just describe it like you would to a colleague.

My server keeps running out of memory and crashing overnight
02

Review & Approve Actions

DoctorClaw proposes diagnostic commands and explains what each one does. You review and approve every single action before it runs on your system.

Action requires approval
free -h && ps aux --sort=-%mem | head -20
03

Get a Diagnosis & Fix

DoctorClaw analyzes the results, explains the root cause, and proposes a fix. Backups are created automatically before any file modifications.

Root cause identified: A memory leak in the Node.js process at PID 2847. Memory usage grew from 256MB to 3.8GB over 6 hours.

I recommend restarting the service and setting a memory limit. Shall I create a systemd override?

Built with paranoia,
so you don't have to be.

Every design decision prioritizes your system's safety. DoctorClaw has guardrails at every level.

Approval-Gated Actions

Every file read, command execution, script run, and file write requires your explicit approval. Nothing happens in the background.

Command Blocklist

Dangerous operations like rm -rf, mkfs, and shutdown are blocked at the pattern level. They can't even be proposed.

Automatic Backups

Before modifying any file, DoctorClaw creates a backup in .doctorclaw-backups/. Roll back instantly if anything goes wrong.

Execution Timeouts

Individual commands timeout after 30 seconds. Scripts timeout after 60 seconds. Runaway processes are automatically terminated.

Path Restrictions

File operations are sandboxed to configured directories. DoctorClaw can't access paths you haven't explicitly allowed.

Local by Default

Runs on your machine via Ollama with local models. Cloud models are supported if you choose to enable them, but never required.

Up and running in under a minute.

DoctorClaw requires Node.js 18+ and Ollama. Install with a single command or clone and configure manually.

Recommended

Quick Install

Run the automated installer for your platform. It handles dependencies and configuration.

# Clone the repository
git clone https://github.com/fusionpoweredsoftware/DoctorClaw.git
cd DoctorClaw

# Run the installer
chmod +x install.sh
./install.sh

Manual Setup

For those who prefer full control over the installation process.

# Clone and install dependencies
git clone https://github.com/fusionpoweredsoftware/DoctorClaw.git
cd DoctorClaw
npm install

# Start the server
npm start

# Open in browser
# http://localhost:3333

Requirements

  • Node.js 18 or higher
  • Ollama installed & running
  • An LLM model pulled in Ollama