DuDuClaw：把 AI 编程 CLI 变成聊天员工

项目简介

DuDuClaw 是一个用 Rust 编写的自托管 AI 员工平台：它把 Claude Code、Codex、Grok 等 AI 命令行工具接到 Telegram、LINE、Discord、Slack 等聊天软件里，让它们在群里实际干活。单个 Rust 二进制就内置通道路由、会话记忆、多账号轮换、行为护栏、本地推理与 Web 控制台；AI 大脑可在多个 CLI 后端或任意 OpenAI 兼容 API 之间切换，配置和记忆都留在自己的机器上，核心采用 Apache 2.0 许可。

主要功能

• 11 个聊天通道：Telegram、LINE、Discord、Slack、WhatsApp、飞书、Google Chat、Microsoft Teams、企业微信、钉钉、WebChat，每个 agent 可使用独立的 bot token。
• 多运行时：11 个 runtime id（10 种 CLI + OpenAI 兼容），自动检测，可按 agent 指定；提供 4 种轮换策略和跨供应商故障转移。
• 独立裁判：结果交付前由独立裁判复核，每一笔花费都会被记录。
• 会话记忆：原生 --resume + 时序记忆 + 关键事实 + 分层 wiki，自动注入，切换 LLM 后上下文不丢。
• MCP Server：253 个工具（频道、记忆、agent、技能、任务、wiki、ERP）写一次即可被 Claude、Codex、Grok 与 OpenAI 兼容运行时调用；也可作为独立的 MCP 记忆服务器运行。
• 进化引擎：预测驱动 + AEE playbook 规则 + MistakeNotebook。
• 安全：PolicyKernel 参考监控器、操作系统沙箱、脱敏保险库与 AES-256-GCM。
• 本地推理：可接 OpenAI 兼容的本地服务（llama-server、Ollama、vLLM、llamafile）。
• 账号轮换：OAuth 与 API key 轮换、预算控制、健康检查。
• Web 控制台：React 19 SPA，通过 rust-embed 内嵌。
• 定时派活：把任务交给 AI 员工稍后执行或重复执行，每次运行都会校验创建者当前权限。

安装与使用

前置条件：Node.js 20+；另外需要先准备一个 AI 大脑——安装受支持的 AI CLI（如 Claude Code、Codex），或提供任意 OpenAI 兼容供应商的 API key，或使用本地模型。

npm 方式（服务器、脚本自动化或偏好命令行时使用）：

npm install -g duduclaw
duduclaw run                  # 然后打开 http://localhost:18889

该命令会为你的平台安装预编译二进制（macOS ARM64/x64、Linux x64/ARM64、Windows x64），不需要编译器。

桌面版（Tauri，个人使用推荐）：从 Releases 下载对应安装包，启动后自动拉起本地 gateway，与 CLI 共用 ~/.duduclaw，无需终端，应用内向导会引导选择 AI 后端并创建第一个 agent。

• macOS（Apple Silicon / Intel）：DuDuClaw_*.dmg，已签名并通过 Apple 公证；macOS 桌面版自 v1.68.1 起恢复提供。
• Windows x64：DuDuClaw_*_x64_en-US.msi。
• Linux：*_amd64.AppImage / .deb。

从源码构建需要 Rust 1.85+ 与 Node.js 20+：

git clone https://github.com/zhixuli0406/DuDuClaw.git
cargo build --release -p duduclaw-cli -p duduclaw-gateway --features duduclaw-gateway/dashboard
./target/release/duduclaw run

注意事项

• Windows 桌面包暂无 Authenticode 证书，SmartScreen 会告警，需点击「更多信息」再选择「仍要运行」。
• Anthropic 政策不允许第三方产品提供 Claude.ai 登录、代用户使用 Free/Pro/Max 订阅凭据或存储这些凭据；API key 是受支持的方式，订阅登录仍可用但需接受风险提示。
• 控制台一键登录支持 Claude、Codex、Grok、Kimi、Copilot、Kiro、OpenCode（需已安装对应 CLI）；Codex 使用 codex login --device-auth，需要在 CLI 给出的验证页输入设备码。
• 另提供 DuDuClaw OS 整机镜像（Yocto 构建，当前 v0.4.0，预 GA）：仅在 QEMU 验证，尚未在真机启动，Secure Boot、dm-verity、TPM2 仍为禁用状态，需在 BIOS 中关闭 Secure Boot；升级为单向，v0.4.0 启动后无法回退到 v0.3.0 或更早版本。

---

本作品整理自 GitHub 开源项目 zhixuli0406/DuDuClaw，原作者 @zhixuli0406，许可证 Apache-2.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。