Evolclaw

EvolClaw

AI Agent 统一网关 —— 连接 IM、终端、Agent 网络

EvolClaw 是一个轻量级 AI Agent 网关系统。它为 Claude Code / Codex 等 Coding Agent 提供统一接入层，使其作为通用基座 Agent，接入到飞书、微信、钉钉、QQ频道、企业微信等多种 IM 通道，以及 AUN 多智能体网络。人类可以通过手机 IM 随时接力开发，其他 Agent 也可以通过 AUN 网络直接调用你的 Agent —— 不只是人机交互，也是 Agent 间协作的基础设施。

核心特性

• 🔄 多端会话接力：跨终端共享会话、环境、项目，无缝切换开发体验
• ♻️ 配置自动继承：复用 CLI 环境的 API Key/URL、记忆文件、MCP/Skills 插件，零额外配置
• 🚀 轻量化设计：进程模式运行，CLI 命令行管理，无端口开放，无容器依赖，无 UI 界面
• 🌐 多渠道接入：Channel Adapter 模式，飞书 + 微信 + 钉钉 + QQ频道 + 企业微信 + AUN 网络
• 🤖 Agent 间互联：通过 AUN 网络，你的 Agent 可被其他 Agent 发现和调用
• 🔐 分层权限：四级权限体系（guest/user/admin/owner），多用户安全隔离
• 🛠️ Agent 自管理：Agent 可通过 CLI 命令自主管理运行时（查看状态、切换模型、调整配置等）
• 📦 项目搬家：evolclaw mv 一键迁移项目目录，保留 Claude/Codex/EvolClaw 全部会话历史
• 💾 会话与队列持久化：会话数据与 CLI 工具共享，队列状态持久化存储，服务重启不丢失，支持 /queue 命令查看队列状态
• ⚡ 执行中插入：任务执行中可发送新消息，自动中断当前任务并处理新请求
• 🔕 消息智能发送：前台任务动态聚合批量发送，后台任务静默完成后通知
• 🧩 Agent 多实例：一个 JSON 文件定义一个 Agent，多 Agent 并发运行，Agent 运行时隔离 + 热重载无需重启
• ⏰ Trigger 自主任务：Agent 可设置延迟/定时/周期任务，cron 表达式支持，独立 silent session 执行，支持脚本模式和 prompt 模式
• 🔧 Daemon 模块：系统级后台服务，管理升级检查、全局触发器等跨 Agent 任务
• 🎯 Agent 启动引导：首次启动自动引导配置 AID、owners、channels，降低上手门槛
• 🎭 主动模式策略：proactive 模式下智能判断响应时机，群聊支持静默策略，避免无效打扰
• 🎴 交互卡片体系：CommandCard + ActionInteraction，Feishu 与 AUN 统一支持

适合场景

• 通勤路上：手机打开飞书，继续昨晚的代码 review，到公司无缝切回终端
• 会议间隙：微信快速问一句「这个接口的返回格式是什么」，Agent 直接查代码回复
• Agent 协作：通过 AUN 网络，让你的 Agent 被其他 Agent 调用，组成分布式协作
• 外出离开工位：不带电脑也能通过 IM 给 Agent 下达任务，回来看结果
• 团队协作：拉个飞书群，成员共享同一个 Agent 会话，一起讨论和调试

系统架构

消息渠道层 → 消息队列层 → 命令处理层 → 消息处理层 → 会话管理层 → 存储层

核心组件

1. 消息渠道层 (src/channels/) - Feishu + WeChat + DingTalk + QQBot + WeCom + AUN 网络
2. 消息队列层 (src/core/message/message-queue.ts) - 会话级串行处理 + 中断支持
3. 命令处理层 (src/core/command/) - 斜杠命令处理（slash-handler / menu-handler / command-handler）
4. 消息处理层 (src/core/message/message-processor.ts) - 统一事件处理引擎
5. 会话管理层 (src/core/session/session-manager.ts) - 多项目会话管理
6. 交互路由层 (`src/c