关于 DuDuClaw
DuDuClaw 是面向 AI 编码 Agent 的本地运行层,提供持久记忆、分层 Markdown wiki 和多种 Agent 管理能力。它通过 MCP 将工具提供给不同 AI 运行时,无需独立网关。
主要功能
- 01SQLite 时间记忆与分层 wiki
- 02跨运行时共享 MCP 工具
- 03多渠道消息路由
- 04多运行时切换与故障转移
- 05策略限制与审计
适用场景
- 01在切换 LLM 后保留会话上下文
- 02将 Agent 接入 Telegram 或 Discord
- 03为多个 Agent 配置不同工作
- 04审查并记录 Agent 操作
MCP 相关
DuDuClaw 以 MCP 服务形式提供 247 项工具,涵盖渠道、记忆、Agent、技能、任务、wiki 和 ERP。AI 运行时通过 JSON-RPC 2.0 与其通信。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
DuDuClaw
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 许可证。
v1.74.0 仪表板中的任务看板。员工和任务均为演示数据。
快速开始(需要 Node.js 20+;想使用桌面应用?请参阅安装):
npm install -g duduclaw
duduclaw run # then open http://localhost:18889
目录
为什么选择 DuDuClaw?
如果你偶尔在终端中运行 claude 或 gemini,原生 CLI 就足够了。但当你想让 AI 管理 LINE 官方账号、负责团队的 Discord,或运行多个各司其职的 Agent 时,就不得不自己搭建整套基础设施。DuDuClaw 提供了这一层:
| 需求 | 原生 CLI | DuDuClaw |
|---|---|---|
| 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 x64 | DuDuClaw_*_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。
从源代码构建
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 行为契约 + 红队 CLI | SECURITY.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 / ja | docs/features |
| ERP | Odoo 桥接,提供 17 个 MCP 工具(CRM / 销售 / 库存 / 会计)、自动检测 CE/EE、按 Agent 隔离凭据 | docs/rfc |
| DuDuClaw OS | Yocto 设备映像(当前版本 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。
对比
| DuDuClaw | OpenClaw | IronClaw | Dify | |
|---|---|---|---|---|
| 语言 | Rust | TypeScript | Rust | Python |
| 频道 | 11 | 25+ | 8 | 0(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 员工访问,并在我的连接中撤回授权。
- 只读团队对话:Enterprise 仪表板和 API(v1.76.0)可用于报告 WebChat 和经过脱敏的外部对话,并包含员工通知、生效边界和强制审计。直接使用 Viewer/Operator 查看历史记录时,现在可完整查看自己的 WebChat,对外部对话进行脱敏,并隐藏其他账号的记录;Owner/Admin 仍可完整查看。此行为变更提供了明确的迁移设置。
- 自助服务:谁查看了我的对话仅显示你自己的团队历史记录回执(指南)。
- ARCHITECTURE.md:完整的系统架构
- docs/README.md:公开文档索引(架构 / RFC / ADR / 规范 / 指南)
- docs/guides/deployment-guide.md:生产环境部署(Tailscale / Docker / systemd / 自动更新 / 监控)
- docs/guides/development-guide.md:开发环境和 Agent 开发
- MCP 调用生命周期:主机 API 参考(v1.76.0),介绍各操作的 HTTP 权限
- docs/guides/custom-mcp-tool.md:编写自定义 MCP 工具
- docs/spec:SOUL.md 和 CONTRACT.toml 格式规范
- docs/features/50-duduclaw-os-appliance.md:DuDuClaw OS 设备;52-desktop-edition.md:桌面版,一台机器由个人和 AI 共用;硬件要求见 hardware-requirements.md;应用兼容性、镜像构建和发布均位于 DuDuClaw-OS 仓库(参见其中的
docs/guides/app-compat.md) - CHANGELOG.md:版本历史
许可证
开放核心:核心部分采用 Apache License 2.0,可免费使用、修改和分发。商业附加组件(commercial/,不在此仓库中),例如高级行业套件,均为闭源付费内容;使用许可证密钥即可解锁。许可证验证客户端(crates/duduclaw-license)属于 Apache 2.0 核心部分。详见 LICENSING.md。
商业许可证、企业推广、培训和支持由我们的授权分销商 Future Corp (未來企業股份有限公司) 提供。我们不直接销售。
由 louis.li 构建
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。