mcpField
D
DuDuClaw

DuDuClaw

本地服务
github.comAI 与智能体50今天更新

关于 DuDuClaw

DuDuClaw 是面向 AI 编码 Agent 的本地运行层,提供持久记忆、分层 Markdown wiki 和多种 Agent 管理能力。它通过 MCP 将工具提供给不同 AI 运行时,无需独立网关。

主要功能

  1. 01SQLite 时间记忆与分层 wiki
  2. 02跨运行时共享 MCP 工具
  3. 03多渠道消息路由
  4. 04多运行时切换与故障转移
  5. 05策略限制与审计

适用场景

  1. 01在切换 LLM 后保留会话上下文
  2. 02将 Agent 接入 Telegram 或 Discord
  3. 03为多个 Agent 配置不同工作
  4. 04审查并记录 Agent 操作

MCP 相关

DuDuClaw 以 MCP 服务形式提供 247 项工具,涵盖渠道、记忆、Agent、技能、任务、wiki 和 ERP。AI 运行时通过 JSON-RPC 2.0 与其通信。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"zhixuli0406-duduclaw": {
"command": "npx",
"args": [
"-y",
"duduclaw"
],
"env": {
"DUDUCLAW_MCP_API_KEY": "<DUDUCLAW_MCP_API_KEY>"
}
}
}
}
启动命令npx -y duduclaw
需要配置的环境变量
DUDUCLAW_MCP_API_KEY密钥Key for the standalone server. Create one with `npx duduclaw mcp init` (prints it once; stored only as a hash).

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmduduclaw1.74.0

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

DuDuClaw

DuDu Technology Ltd. 推出的 DuDuClaw。将 AI 编码工具引入团队聊天。审查结果。追踪成本。保留上下文。

English · 繁體中文 · 日本語

DuDuClaw 将 Claude Code、Codex 和 Antigravity 等 AI 命令行工具变成真正能交付成果的 AI 员工:它们可以入驻 Telegram、LINE 和 Discord 等 11 款即时通讯应用,在成果发布前由独立评审员审核工作,并记录每一笔开销。

你只需要一个 Rust 二进制文件。频道路由、对话记忆、多账号轮换、行为护栏、本地推理和 Web 仪表板均已内置;你可以随时在 11 种 CLI 后端(Claude Code、Codex、Antigravity、Grok 等)或任意兼容 OpenAI 的 API 之间切换 AI 大脑,而配置和记忆始终保留在自己的设备上。核心采用 Apache 2.0 许可证。

DuDuClaw v1.74.0 Web 仪表板,列表视图中的任务看板:7 个演示任务分为待办、进行中、审核中、已完成和受阻,每项任务都包含 ID、支持或营销等标签,以及优先级
v1.74.0 仪表板中的任务看板。员工和任务均为演示数据。

CI Version npm Glama MCP server score License: Apache-2.0

快速开始(需要 Node.js 20+;想使用桌面应用?请参阅安装):

npm install -g duduclaw
duduclaw run                  # then open http://localhost:18889

目录

为什么选择 DuDuClaw?

如果你偶尔在终端中运行 claude 或 gemini,原生 CLI 就足够了。但当你想让 AI 管理 LINE 官方账号、负责团队的 Discord,或运行多个各司其职的 Agent 时,就不得不自己搭建整套基础设施。DuDuClaw 提供了这一层:

需求原生 CLIDuDuClaw
Telegram / LINE / Discord 接入仅限终端11 个渠道,每个 Agent 可使用独立的机器人令牌
多个大模型故障转移手动重启4 种轮换策略 + 跨提供商故障转移
切换大模型后保留上下文丢失保留
对话记忆和知识库单个会话SQLite 时序记忆 + 分层 Wiki,自动注入
多个大模型共享工具针对每个厂商重写一次编写 247 个 MCP 工具,即可通过 Claude、Codex、Antigravity、Grok 和 OpenAI 兼容运行环境访问
防护措施 / 审计 / 密钥管理自行构建内置策略内核 + OS 沙盒 + AES-256-GCM
可交付给客户的整套设备自行安装 Linux、自行管理更新并防止篡改DuDuClaw OS 镜像:支持回滚的 A/B 更新 + 只读根文件系统;插上即可使用;由人与 AI 共享桌面,互不干扰

v1.76.0:定时分配任务让你可以通过聊天或仪表板,将工作交给 AI 员工稍后执行或定期重复执行。每次运行都会检查创建者当前的权限。

架构概览

AI 运行环境是大脑,DuDuClaw 是管道,而 MCP(JSON-RPC 2.0)是桥梁。更换大脑,保留管道:

AI Runtime (brain) — Claude Code / Codex / Antigravity / Grok / … (11 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 — 12 runtime ids (11 CLIs + OpenAI-compat), auto-detected, per agent
  ├─ Session Memory — native --resume + temporal memory + key facts + layered wiki
  ├─ MCP Server — 247 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

Rust 工作区包含 24 个 crate:基础层 duduclaw-core、服务层 duduclaw-gateway、统一 API 层 duduclaw-llm、用于本地模型的 duduclaw-inference、用于认知记忆的 duduclaw-memory、duduclaw-security 等。完整设计请参阅 ARCHITECTURE.md。

实验性的校准本地路由使用 Varun Kotte 的 UCCI (arXiv:2605.18796)。配置和数据准备请参阅 UCCI 校准级联。

同一套网关和仪表板也以整机形式提供:DuDuClaw OS 是基于 Yocto 构建的设备镜像。其 Yocto 层和发布流水线位于独立仓库中,并将本仓库的 Rust 工作区以精简快照的形式纳入其中;请参阅下方的安装部分。

前置条件

DuDuClaw 不附带自己的 LLM——你需要先准备一个 AI 大脑。选择一种(也可以稍后在浏览器向导中设置):

  • 安装一种受支持的 AI CLI,例如 Claude Code、Codex 或 Antigravity(完整列表见 multi-runtime);Gemini CLI 已不再是 DuDuClaw 运行时。Anthropic 的政策不允许第三方产品提供 Claude.ai 登录、代表用户通过 Free/Pro/Max 套餐凭据转发请求或存储这些凭据,且 Anthropic 可能在不事先通知的情况下执行该政策(有用户报告称账号被暂停)。Google 的 Antigravity 条款(第 6 节)指出,从第三方软件访问其服务可能导致账号被暂停或终止。推荐的方式是使用 API 密钥;接受风险提示后,仍可使用订阅登录
  • 准备任意 OpenAI 兼容服务提供商的 API 密钥
  • 或在 OpenAI 兼容服务端后运行本地模型(llama-server、Ollama、vLLM、llamafile)——无需云端账号

在 Dashboard 中,如果已安装 CLI,一键登录支持 Claude、Codex、Grok、Kimi、Copilot、Kiro 和 OpenCode。Codex 使用 codex login --device-auth:打开 CLI 显示的验证页面,输入设备代码,然后等待完成。浏览器无需访问 Docker 回调端口,将回调 URL 中的 code 粘贴到 Dashboard 也无法完成身份验证。在 Accounts 页面中,API Token 卡片可在你确认账号 ID 后删除已保存的账号;如有需要,请另外在相应服务提供商处撤销密钥。

安装

桌面应用(个人使用推荐)

原生 Tauri 版本,启动时会自动启动本地网关——无需终端——并与 CLI 共用 ~/.duduclaw。从 Releases 下载:

平台文件说明
macOS(Apple Silicon / Intel)DuDuClaw_*.dmg已签名并经 Apple 公证,可直接打开
Windows x64DuDuClaw_*_x64_en-US.msi尚无 Authenticode 证书,因此 SmartScreen 会发出警告;点击“更多信息”,然后选择“仍要运行”以安装——解除阻止的详情见 docs/guides/desktop-unblock.md
Linux*_amd64.AppImage / .deb无需签名

从 v1.68.1 起,macOS 桌面版已重新提供(已签名并经公证)。v1.67.0 至 v1.68.0 没有 macOS 版本;这些版本提供 Windows 和 Linux 版本。

打开应用即可——应用内向导会引导你选择 AI 后端并创建第一个 Agent,无需运行任何命令。

npm(进阶 / 服务端用途,支持所有平台,包括 Windows)

适用于在服务端运行、编写自动化脚本,或偏好命令行的场景。唯一前置条件是 Node.js 20+:

npm install -g duduclaw

这会为你的平台安装预构建二进制文件(macOS ARM64/x64、Linux x64/ARM64、Windows x64)。无需编译器,也无需 Rust。

⚠️ 如果安装时提示你需要 Rust / MSVC Build Tools,并且要编译 1.5 小时,那说明你走错了路。这条路径是供贡献者使用的“从源码构建”;普通用户应使用上面的 npm 命令。

DuDuClaw OS(设备镜像,正式发布前)

如果你不想专门腾出一台电脑,可以选一台插上电就能运行的设备:DuDuClaw OS 是基于 Yocto 构建的 Linux 操作系统,AI agent 是其中的原生常驻功能:系统启动后会进入专属桌面(合成器 / shell、锁屏、Cmd+K 委派栏),让用户和 AI 共用一台 x86-64 设备而互不干扰——默认情况下,Agent 的 GUI 操作会在影子工作区中运行;只要你触碰键盘或鼠标,它在桌面上操控的任何内容都会让出控制权。桌面版提供 A/B 原子更新和回滚、只读根文件系统,并预装 Chromium / LibreOffice(Steam 可从 Flathub 安装)以及中文输入法;安全启动签名、dm-verity 和 TPM2 是构建时的覆盖选项,截至当前的 v0.4.0 版本仍处于禁用状态,因此请在 BIOS/UEFI 中关闭安全启动后再启动。

当前版本为 v0.4.0(嵌入平台 v1.73.4)。网关现在以非 root 用户身份运行,其容器使用 rootless Podman;SSH 默认关闭,基础镜像也采用与桌面版相同的防火墙设置。此次升级是单向的:设备成功启动 v0.4.0 后,便无法回退到 v0.3.0 或更早版本;这些旧版本仅作为较早发布版本保留在 Releases 页面。请从 DuDuClaw-OS Releases 下载整盘 .wic.zst(桌面版)、installer-desktop 安装程序 .iso(写入桌面版)或普通的 installer .iso(写入不含应用层的基础镜像);每个文件都附带 .sha256 和 minisign 签名,验证命令见文档网站上的 OS README。这是一个 bring-up 阶段的版本线(0.x):已通过 QEMU 验证,尚未在真实硬件上启动,通过 A/B 更新将现有 v0.3.0 设备升级的流程也尚未验证。硬件要求和兼容设备见:docs/guides/hardware-requirements.md;产品概览见:docs/features/50-duduclaw-os-appliance.md。

从源代码构建

先决条件: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(可选库)

核心网关 / CLI 是一个 Rust 二进制文件,无需 Python。PyPI 上的 duduclaw 包是一个纯库,用于 import duduclaw(agents / channels / mcp / memory_eval 模块),没有命令行入口,因此 pipx install duduclaw 按设计无法运行。如果你需要它:

pip install duduclaw

快速开始

  • 桌面应用:直接打开即可——网关会自动启动,向导会直接显示在应用中。

  • npm / 从源代码构建:

    duduclaw run                  # start everything (gateway + channels + scheduler + dispatcher)
    open http://localhost:18889   # open the dashboard
    

无论采用哪种方式,首次访问时都会进入向导:选择 AI 后端、创建第一个 Agent,然后在内置 WebChat 中与它聊天——无需先在终端运行 duduclaw onboard。之后,在 Channels 页面粘贴机器人令牌,即可让同一个 Agent 服务于 Telegram、LINE、Discord 等平台,无需重启。

后续建议:

duduclaw agent create      # create more agents
duduclaw wizard            # industry-template setup
duduclaw status            # system health snapshot
duduclaw update            # check for and install updates
duduclaw service install   # start on boot (launchd / systemd)

功能概览

领域内置功能了解更多
通道11 个通道(Telegram / LINE / Discord / Slack / WhatsApp / Feishu / Google Chat / Teams / WeCom / DingTalk / WebChat)、每个 Agent 配备独立机器人、热启动/停止、平台原生格式、输入指示器、实时任务进度看板;Telegram 语音消息通过 OpenAI Whisper API 转录。Discord 语音频道是非默认构建功能,不包含在发布二进制文件中docs/features
多运行时12 个运行时 ID:Claude Code / Codex / Antigravity / Grok / Qwen Code / Kimi Code / GitHub Copilot CLI / Kiro / Cursor / Mistral Vibe / OpenCode,以及 OpenAI-compat;自动检测、每个 Agent 单独配置,切换后端时上下文仍会保留docs/features/13
统一大模型 API 层duduclaw-llm 使用一个规范化请求覆盖 4 种原生协议(Anthropic Messages / OpenAI Responses / Gemini / OpenAI-compat),并提供 8 种 OpenAI-compat 预设(DeepSeek / MiniMax / Groq / Together / Mistral / OpenRouter / xAI / Qwen)、定价注册表和跨提供商故障切换ARCHITECTURE.md
MCP 服务247 个工具:通道、记忆、Agent 编排、技能市场、任务看板、共享维基、Odoo ERP、计算机使用、实时分叉;支持 stdio 和 HTTP/SSE 传输;外部客户端密钥默认只能使用 7 个基础工具,除非操作员授予其记忆、维基或消息范围;连接器、执行和管理工具绝不会对外部开放docs/api
记忆SQLite 时序记忆(事实取代链)、HippoRAG-lite 知识图谱检索(个性化 PageRank)、艾宾浩斯遗忘曲线归档、跨 Agent 共享维基docs/features
自我进化由预测驱动(按设计,大多数对话结束时不会调用大模型)+ AEE 操作手册进化:Agent 只能读取 SOUL.md,不可写入;学习到的行为以小型规则呈现,每条规则都关联一个评测用例;只有在匹配或优于当前操作手册时才会提交规则,并在 24 小时后自动定稿;MistakeNotebook 跨轮次记忆evolution-engine.md
安全PolicyKernel 参考监视器(零大模型、故障时默认拒绝)、macOS Seatbelt / Linux Landlock 原生沙箱(按 Agent 设置,默认关闭)、容器沙箱(任务沙箱:仅支持 Docker,默认关闭;脚本沙箱:支持 Docker,在 Windows 上优先尝试 WSL2)、密钥脱敏保险库、CONTRACT.toml 行为契约 + 红队 CLISECURITY.md
账户与成本OAuth + API 密钥轮换(4 种策略)、速率限制和账单冷却、成本遥测及缓存效率分析。每次调用都会以全新进程运行官方 CLI(PTY 会话池已于 2026-09 移除;对于 Grok 等需要 TTY 的 CLI,仍保留一次性伪终端)。Anthropic 的政策不允许第三方产品通过 Claude 订阅凭据转发请求;Google 的 Antigravity 条款也指出,通过订阅 OAuth 登录进行第三方访问可能导致账户被暂停或终止,因此请使用 API 密钥;明确确认风险后仍可使用订阅登录(多运行时)docs/features
本地推理任意 OpenAI 兼容的本地服务(llama-server / Ollama / vLLM / SGLang)或 llamafile,支持三级置信度路由docs/features
微调根据本机对话、任务结果和审批决定构建 SFT / DPO 数据集(ShareGPT / Alpaca),在自己的 GPU 主机(SSH + LLaMA-Factory)或 Together 云端训练,然后将 GGUF / LoRA 导入本地模型目录。不在本地训练——集成显卡无法训练;数据离开本机前需要明确确认docs/features/54
实时分叉RFC-26:将进行中的任务分叉为 N 个竞争分支,每个分支都在写时复制隔离环境中运行,由 AI 评审选出胜者并合并(默认关闭;在 v1.67.0 中请勿在 Windows 上启用,参见 CHANGELOG)docs/rfc
自动更新可在仪表板上一键更新,或启用无人值守更新(auto_update = true);SHA-256 + Ed25519 验证、原位重启、已打开的标签页自动重新加载deployment-guide.md
Web 仪表板内嵌于二进制文件的 React 19 + TypeScript 单页应用;zh-TW / en / jadocs/features
ERPOdoo 桥接,提供 17 个 MCP 工具(CRM / 销售 / 库存 / 会计)、自动检测 CE/EE、按 Agent 隔离凭据docs/rfc
DuDuClaw OSYocto 设备映像(当前版本 v0.4.0,内嵌平台版本 v1.73.4):自有合成器 / shell,支持键盘快捷键;人机协同驾驶(专用 Agent 座位、影子工作区、人类输入会冻结 Agent、Super+Esc 紧急停止;已编译,默认关闭);A/B 原子更新并支持回滚(无法回滚至 v0.4.0 以下版本);只读根文件系统;以非 root 身份运行的网关,搭配 rootless Podman 容器;SSH 默认关闭;首次启动配置 + LAN 仪表板;应用兼容层(Flatpak / Bottles / Waydroid);Secure Boot 签名 / dm-verity / TPM2 是构建叠加层选项(截至 v0.4.0 仍未启用);独立仓库和版本线,尚未正式发布docs/features/50 · 52
完整功能列表见 docs/features/feature-inventory.md;版本历史见 CHANGELOG.md。

CLI 命令

duduclaw onboard             # first-run setup; the browser wizard covers this now, use for headless/scripted setups (--yes to skip prompts)
duduclaw run                 # start everything (gateway + channels + heartbeat + cron + dispatcher)
duduclaw agent               # interactive chat; subcommands create / list / inspect / pause / resume / run
duduclaw wizard              # industry-template setup
duduclaw status              # system health snapshot
duduclaw doctor              # diagnostics
duduclaw test <agent>        # red-team security test (9 built-in scenarios)
duduclaw eval                # run the agent behavior eval suite
duduclaw update              # check for and install updates
duduclaw service install     # install as a system service; also start / stop / status / logs / uninstall
duduclaw export / import     # export / import ~/.duduclaw (portable personal data)
duduclaw migrate from openclaw   # painless migration from OpenClaw / Hermes / paperclip (dry-run by default, --apply to write)
duduclaw mcp-server          # start the MCP server (stdio JSON-RPC 2.0)
duduclaw http-server         # start the MCP HTTP/SSE transport (Bearer auth)
duduclaw acp                 # start the Agent Client Protocol server (Zed / JetBrains / Neovim agent panels)
duduclaw acp server          # start the A2A server (agent-to-agent interop)
duduclaw license             # license management (activate / status / redeem / rebind / …)

运行 duduclaw --help 查看完整命令列表和子命令;开发者相关主题请参阅开发指南。

信任与安全

你安装的内容完全透明:

  • npm 包中的内容:一个小型 JS 包装器和平台二进制文件(@duduclaw/<platform> optionalDependencies)。postinstall 只会检查平台包是否存在(install.js);不会从任意 URL 下载或执行任何内容
  • 无遥测:不会向我们发送使用数据或对话内容。网关每 6 小时检查一次 GitHub Releases 的更新;安装付费许可证后,还会向许可证服务刷新许可证(根据套餐不同,每 3–7 天一次),并每日获取撤销列表。没有许可证文件时,不会产生许可证相关网络流量。密钥会留在你的设备上,并使用 AES-256-GCM 加密
  • 不提升权限:完全在用户空间运行
  • 维护方:Dudu Technology Ltd.(在台湾注册,税号 94139082)
  • 聊天中的高风险操作:员工会在其频道中请求批准高风险的计算机操作步骤,你需要用请求的完整 ID 回复。结果未知的操作绝不会自动重新发送;管理员会在控制面板中处理。请参阅操作员指南
  • 浏览器登录持久化(v1.76.0):可选的加密员工级容器快照,默认关闭,并提供重置和交接保护。最终容器验收尚待完成。请参阅指南。
  • 团队浏览器查看(v1.76.0):汇报关系中的经理可以查看经过遮罩处理的快照,并停止下属手动启动的容器会话。现有的直接绑定仍保留其控制功能。与会话绑定的查看链接可在登录后返回此处,并显示在已验证的对话或匹配的任务/运行记录中。请参阅指南。

每个发布资产都附带三种验证方式:SHA-256 校验和、cosign 无密钥签名,以及 minisign Ed25519 签名(内置自动更新程序会强制执行此项验证,并拒绝未签名或遭篡改的发布版本):

# SHA-256
shasum -a 256 -c duduclaw-darwin-arm64.tar.gz.sha256

# minisign (the same public key is pinned inside the binary)
minisign -Vm duduclaw-darwin-arm64.tar.gz \
  -P RWTh5pOpk0YmdBgm3VyB2bzxFtajNLXr7zFDhbcc75TgM8YfeV+NSzXh

不信任预构建的二进制文件?从源代码构建只需三条命令。请通过 SECURITY.md 报告漏洞。

为什么一个“新”包会从 1.3x 版本开始?DuDuClaw 在公开发布前,曾在私有仓库中开发数月(提交超过 400 次);完整历史记录见 git log。

对比

DuDuClawOpenClawIronClawDify
语言RustTypeScriptRustPython
频道1125+80(API)
多运行时12 个运行时 ID(11 个 CLI + OpenAI 兼容)单一单一多 LLM
MCP 服务247 个工具无无无
自我进化引擎AEE 操作手册规则(由预测驱动)无无无
本地推理OpenAI 兼容的本地服务 / llamafile + 置信度路由无无无
行为契约CONTRACT.toml + 红队测试无WASM 沙箱无
许可证Apache 2.0(开放核心)MIT开源$59+/月

文档

企业个人 Google 连接(v1.76.0):连接自己的账号,允许个别 AI 员工访问,并在我的连接中撤回授权。

许可证

开放核心:核心部分采用 Apache License 2.0,可免费使用、修改和分发。商业附加组件(commercial/,不在此仓库中),例如高级行业套件,均为闭源付费内容;使用许可证密钥即可解锁。许可证验证客户端(crates/duduclaw-license)属于 Apache 2.0 核心部分。详见 LICENSING.md。

商业许可证、企业推广、培训和支持由我们的授权分销商 Future Corp (未來企業股份有限公司) 提供。我们不直接销售。

由 louis.li 构建

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。