DuDuClaw

Name: DuDuClaw
Author: zhixuli0406

by zhixuli0406version 1.74.0i★ –iRuns on your computer

Registry nameio.github.zhixuli0406/duduclaw

Install

Overview

Description from the maker (original English)

Local persistent memory and Markdown wiki for AI coding agents: 24 MCP tools, no gateway required.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Developer tools
You need to fill in: DUDUCLAW_MCP_API_KEY

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
You fill in yourself: DUDUCLAW_MCP_API_KEY

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

npmNode.js installed (for the npx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "duduclaw": {
      "command": "npx",
      "args": [
        "-y",
        "duduclaw",
        "mcp-server"
      ],
      "env": {
        "DUDUCLAW_MCP_API_KEY": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add duduclaw --env DUDUCLAW_MCP_API_KEY=your-value -- npx -y duduclaw mcp-server

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "duduclaw": {
      "command": "npx",
      "args": [
        "-y",
        "duduclaw",
        "mcp-server"
      ],
      "env": {
        "DUDUCLAW_MCP_API_KEY": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "duduclaw": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "duduclaw",
        "mcp-server"
      ],
      "env": {
        "DUDUCLAW_MCP_API_KEY": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

DUDUCLAW_MCP_API_KEY secret required env
Key for the standalone server. Create one with `npx duduclaw mcp init` (prints it once; stored only as a hash).

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 8, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account zhixuli0406, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Developer toolsi

More stars than 0% of the other 4915 servers in this category
Published to the registry more recently than 64% of the other 4915 servers in this category
Basic checks equal to or better than 100% of the other 4915 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is DuDuClaw safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: DUDUCLAW_MCP_API_KEY

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (1.74.0) reached the registry 22 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: GitHub, Desktop Commander, Cloudflare MCP

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

GitHub

by github

GitHub’s official server lets AI read and manage code, issues and pull requests in your account. Use GitHub’s hosted version or run it locally with Docker.

Computer or cloud★ 34,245MITUpdated 4 days ago

Install

Desktop Commander

by wonderwhy-er

MCP server for terminal commands, file operations, and process management

Runs on your computer★ 10,225MITUpdated 16 days ago

Install

Cloudflare MCP

by cloudflare

Cloudflare MCP servers

Runs in the cloud★ 4,446Apache-2.0Updated 14 months ago

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

DuDuClaw

English · 繁體中文 · 日本語

DuDuClaw turns AI command-line tools such as Claude Code and Codex into AI employees who actually deliver: they staff eleven messaging apps like Telegram, LINE, and Discord, an independent judge reviews their work before it ships, and every dollar they spend gets logged.

All you need is one Rust binary. Channel routing, conversation memory, multi-account rotation, behavioral guardrails, local inference, and a web dashboard are built in; swap the AI brain between ten CLI backends (Claude Code, Codex, Grok and others) or any OpenAI-compatible API whenever you like, and your config and memory stay on your own machine. The core is Apache 2.0.

The task board in the v1.74.0 dashboard. The staff and tasks are demo data.

Quick start (needs Node.js 20+; prefer a desktop app? see Install):

npm install -g duduclaw

duduclaw run # then open http://localhost:18889

Why DuDuClaw?
Architecture at a glance
Prerequisites
Install
Quick start
Feature overview
CLI commands
Trust and security
Comparison
Documentation
License

Why DuDuClaw?

If you run claude or gemini in a terminal now and then, the native CLIs are all you need. The moment you want an AI staffing your LINE official account, covering your team's Discord, or running several agents with different jobs, you end up building a whole infrastructure layer yourself. DuDuClaw ships that layer:

Need	Native CLI	DuDuClaw
Telegram / LINE / Discord access	Terminal only	11 channels, per-agent bot tokens
Multi-LLM failover	Manual restart	4 rotation strategies + cross-provider failover
Context survives switching LLMs	Lost	Preserved
Conversation memory and knowledge base	Single session	SQLite temporal memory + layered wiki, auto-injected
Tools shared across LLMs	Rewrite per vendor	253 MCP tools written once, reachable from the Claude, Codex, Grok and OpenAI-compatible runtimes
Guardrails / audit / secret management	Build it yourself	Policy kernel + OS sandbox + AES-256-GCM built in
A whole box to hand to a customer	Install Linux yourself, manage updates and tamper resistance yourself	DuDuClaw OS image: A/B update with rollback + read-only root, plug in and go; a desktop shared by a person and the AI without getting in each other's way

v1.76.0: scheduled assignments let you hand work to an AI employee for later or on a repeat, from chat or the dashboard. Each run checks the creator's current permission.

Architecture at a glance

The AI runtime is the brain, DuDuClaw is the plumbing, and MCP (JSON-RPC 2.0) is the bridge. Swap the brain, keep the plumbing:

AI Runtime (brain) — Claude Code / Codex / Grok / … (10 CLIs) / OpenAI-compat

↕ MCP Protocol (JSON-RPC 2.0, stdin/stdout) DuDuClaw (plumbing) ├─ Channel Router — Telegram / LINE / Discord / Slack / WhatsApp / Feishu │ / Google Chat / Microsoft Teams / WeCom / DingTalk / WebChat ├─ Multi-Runtime — 11 runtime ids (10 CLIs + OpenAI-compat), auto-detected, per agent ├─ Session Memory — native --resume + temporal memory + key facts + layered wiki ├─ MCP Server — 253 tools (channels, memory, agents, skills, tasks, wiki, ERP) ├─ Evolution Engine — prediction-driven + AEE playbook rules + MistakeNotebook ├─ Security — PolicyKernel reference monitor + OS sandbox + redaction vault ├─ Inference Engine — OpenAI-compatible local server (llama-server / Ollama / vLLM) / llamafile ├─ Account Rotator — OAuth + API key rotation, budgets, health checks └─ Web Dashboard — React 19 SPA, embedded via rust-embed

The Rust workspace is 24 crates: the duduclaw-core foundation, the duduclaw-gateway service layer, the duduclaw-llm unified API layer, duduclaw-inference for local models, duduclaw-memory for cognitive memory, duduclaw-security, and more. Full design in ARCHITECTURE.md.

Experimental calibrated local routing uses Varun Kotte's UCCI (arXiv:2605.18796). See UCCI calibrated cascade for configuration and data preparation.

The same gateway + dashboard also ships as a whole machine: DuDuClaw OS is a Yocto-built appliance image. Its Yocto layer and release pipeline live in their own repo and vendor this repo's Rust workspace as a trimmed snapshot; see the Install section below.

Prerequisites

DuDuClaw doesn't ship its own LLM — you need an AI brain first. Pick one (you can also set this up later in the browser wizard):

Install one of the supported AI CLIs, such as Claude Code or Codex (the full list is in multi-runtime); Gemini CLI is no longer a DuDuClaw runtime. Anthropic's policy does not permit third-party products to offer Claude.ai login, route requests through Free/Pro/Max plan credentials on their users' behalf, or store those credentials, and Anthropic may enforce this without notice (users have reported suspended accounts). An API key is the supported path; subscription sign-in stays available behind a risk notice you have to accept
Bring an API key for any OpenAI-compatible provider
Or run a local model behind an OpenAI-compatible server (llama-server, Ollama, vLLM, llamafile) — no cloud account needed

In the Dashboard, one-click login supports Claude, Codex, Grok, Kimi, Copilot, Kiro and OpenCode when the CLI is installed. Codex uses codex login --device-auth: open the verification page shown by the CLI, enter its device code, and wait for completion. The browser does not need access to a Docker callback port, and pasting a callback URL code into the Dashboard does not authenticate. On the Accounts page, the API Token card can delete a saved account after you confirm its account id; revoke the key separately at its provider if needed.

Install

Desktop app (recommended for personal use)

A native Tauri build that starts the local gateway automatically when you launch it — no terminal required — and shares ~/.duduclaw with the CLI. Download from Releases:

Platform	File	Notes
macOS (Apple Silicon / Intel)	`DuDuClaw_*.dmg`	Signed + Apple notarized, opens cleanly
Windows x64	`DuDuClaw_*_x64_en-US.msi`	No Authenticode certificate yet, so SmartScreen warns; click "More info" then "Run anyway" to install — unblock details in docs/guides/desktop-unblock.md
Linux	`*_amd64.AppImage` / `.deb`	No signing needed

The macOS desktop build is available again from v1.68.1 (signed and notarized). v1.67.0 through v1.68.0 have no macOS build; Windows and Linux builds exist for those versions.

Open it and you're done — the in-app wizard walks you through picking an AI backend and creating your first agent, no commands needed.

npm (advanced / server use, all platforms including Windows)

For running on a server, scripting automation, or if you just prefer the command line. The only prerequisite is Node.js 20+:

npm install -g duduclaw

This installs a prebuilt binary for your platform (macOS ARM64/x64, Linux x64/ARM64, Windows x64). No compiler, no Rust.

⚠️ If the install asks you for Rust / MSVC Build Tools and a 1.5-hour compile, you took a wrong turn. That path is "build from source" for contributors; regular users should use the npm command above.

DuDuClaw OS (appliance image, pre-GA)

If you would rather not dedicate a computer, get a box that runs the moment you plug it in: DuDuClaw OS is a Yocto-built Linux operating system in which the AI agent is a native resident: it boots into its own desktop (compositor / shell, lock screen, Cmd+K delegation bar), so a person and the AI share one x86-64 box without getting in each other's way — the agent's GUI work runs in a shadow workspace by default, and the moment you touch the keyboard or mouse, whatever it was driving on your desktop yields. The desktop edition ships with A/B atomic updates and rollback, a read-only root, and preloaded Chromium / LibreOffice (Steam installs from Flathub) plus a Chinese IME; Secure Boot signing, dm-verity and TPM2 are build-time overlay options that remain disabled as of the current v0.4.0 release, so boot with Secure Boot turned off in the BIOS/UEFI.

The current release is v0.4.0 (embedding platform v1.73.4). The gateway now runs as a non-root user with its containers on rootless Podman, SSH is off by default, and the base image gets the same firewall as the desktop edition. The upgrade is one-way: once v0.4.0 has booted successfully, a device cannot roll back to v0.3.0 or earlier, which stay on the Releases page only as older releases. Download the whole-disk .wic.zst (desktop edition), the installer-desktop installer .iso (writes the desktop edition), or the plain installer .iso (writes the base image, without the app layer) from DuDuClaw-OS Releases; every file comes with a .sha256 and a minisign signature, and the verification commands are on the OS README on the docs site. This is a bring-up line (0.x): QEMU-verified, not yet booted on real hardware, and upgrading an existing v0.3.0 box through the A/B update has not been verified yet. Hardware requirements and compatible machines: docs/guides/hardware-requirements.md; product overview: docs/features/50-duduclaw-os-appliance.md.

Build from source

Prerequisites: Rust 1.85+, Node.js 20+.

git clone https://github.com/zhixuli0406/DuDuClaw.git

cd DuDuClaw cd web && npm ci --legacy-peer-deps && npm run build && cd .. cargo build --release -p duduclaw-cli -p duduclaw-gateway --features duduclaw-gateway/dashboard ./target/release/duduclaw run

Python SDK (optional library)

The core

Only the beginning is shown; read the rest in the repo

DuDuClaw

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Developer toolsi

Common questions

Alternatives

GitHub

Desktop Commander

Cloudflare MCP

README from the maker

DuDuClaw

Table of contents

Why DuDuClaw?

Architecture at a glance

Prerequisites

Install

Desktop app (recommended for personal use)

npm (advanced / server use, all platforms including Windows)

DuDuClaw OS (appliance image, pre-GA)

Build from source

Python SDK (optional library)