SuperAPI AI 工具集
合作ENAI 行业资讯收藏
全部工具AI智能体claudeclaw

claudeclaw

ClaudeClaw 是一个基于 Claude Code 的常驻智能体编排插件，源自 NanoClaw 项目。它提供持续运行的消息循环，监听 Slack、WhatsApp、Telegram 等渠道，将消息路由到运行在隔离沙箱中的 Claude 智能体，并通过结构化记忆管理持续对话。核心特性包括多渠道路由、线程管理、上下文累积、Webhook 触发、按组配置智能体、成本追踪、扩展系统，以及基于 Anthropic sandbox-runtime 的操作系统级沙箱隔离（macOS 使用 Seatbelt，Linux 使用 bubblewrap），也支持容器运行时。项目以 Claude Code 插件形式运行，当前目录即实例，状态文件存放在工作目录中，代码量小到可放入 Claude 上下文窗口，强调通过代码修改而非配置文件进行定制。

访问官网

工具介绍

用途

ClaudeClaw 是一个面向个人用户的常驻智能体编排器，以 Claude Code 插件形式运行。它提供始终在线的消息循环，监听 Slack、WhatsApp、Telegram 等渠道，将消息路由到运行在隔离沙箱中的 Claude 智能体，并管理持续进行的对话。项目基于 NanoClaw 构建，移植到 Claude Code 插件架构，并采用 Anthropic 的沙箱运行时。

主要能力

核心编排器

  • 常驻消息循环：持久监听器，而非一次性执行
  • 多渠道路由：Slack、WhatsApp、Telegram（可插拔）
  • 线程管理：自动创建线程，后续回复无需重新提及
  • 上下文累积：消息在触发之间批量处理
  • 结构化记忆：每日日志、主题文件、可搜索归档，支持 QMD 升级路径
  • Webhook 触发：带 HMAC-SHA256 认证的 HTTP POST，用于 CI/CD、GitHub、监控
  • 按组智能体配置：每组可设置模型、工具、系统提示、成本限制
  • 成本追踪：记录每次智能体运行的 token 用量和预估成本
  • 扩展系统：可插入分诊、SWE 队列或自定义能力
  • 双运行时：操作系统级沙箱（默认）或容器隔离

分诊扩展

  • 一级支持智能体：调查 bug、分析功能请求
  • 用通俗语言回复用户（用户线程中不出现代码）
  • 需要代码变更时创建 GitHub issue
  • 发布到开发频道以提供技术可见性
  • SWE 任务队列用于顺序编码工作

记忆系统

智能体拥有结构化记忆工具，用于跨对话持久回忆。Claude 内置的自动记忆与 memory_save 工具写入同一 memory/ 目录，形成统一存储。在上下文压缩前，PreCompact 钩子归档对话并将摘要写入每日记忆日志；PostCompact 验证刷新成功。API 错误（速率限制、认证失败）时，StopFailure 钩子通过渠道通知用户，而非静默失败。QMD 升级：运行 /add-qmd 可将基于 grep 的搜索替换为 QMD 的混合 BM25 + 向量语义搜索 + LLM 重排序，完全本地运行。

使用方式

安装与设置

/setup 交互式处理所有事项：依赖、运行时选择（默认沙箱）、通过平台 API 进行渠道认证、组注册和服务启动。

运行时选项

在 .env 中设置 RUNTIME：

沙箱运行时（推荐） 使用 Anthropic 的 @anthropic-ai/sandbox-runtime 进行操作系统级进程沙箱。macOS 上使用 Apple Seatbelt 框架，Linux 上使用 bubblewrap。无需容器或虚拟机，在普通进程上实施内核级限制。安全模型：真实凭证传递给智能体，但网络仅限 api.anthropic.com 和 localhost。文件系统访问由内核根据生成的设置文件强制执行。智能体以 permissionMode: 'bypassPermissions' 运行——沙箱即信任边界。

容器运行时 使用 Apple Container（macOS）或 Docker 进行容器隔离。智能体在带卷挂载的 Linux VM 中运行。localhost 上的凭证代理注入真实 API 密钥，容器永远看不到实际凭证。

按组覆盖：在注册的组配置中设置 "runtime": "sandbox"，可为特定组使用沙箱，其他组使用容器。

触发方式

  1. 渠道消息：使用触发词（默认 @ClaudeClaw）与助手对话
  2. Webhook 触发：外部系统通过 HTTP POST 触发智能体运行，需在 .env 中设置 WEBHOOK_SECRET，支持 HMAC-SHA256 签名验证（时序安全）、按组速率限制（10 请求/分钟）、健康检查 GET /health，响应通过组的渠道路由
  3. 主频道管理：管理组和任务

定制方式

ClaudeClaw 不使用配置文件。要更改行为，直接告诉 Claude Code 你的需求，例如：

  • "将触发词改为 @Bob"
  • "添加一个早上 7 点运行并发布到 Slack 的晨间简报"
  • "让家庭组访问我的 Obsidian 库"
  • "开发团队组使用 opus，其他所有组使用 haiku"

或运行 /customize 进行引导式更改。每次更改都是代码更改，提交到你的 fork，可用 git revert 回滚。

适用场景

  • 个人用户希望拥有一个常驻的、可通过多种消息渠道交互的 AI 助手
  • 需要将不同群组（如家庭、工作）的对话上下文完全隔离
  • 需要通过 Webhook 从 CI/CD、GitHub 或监控系统触发智能体
  • 需要结构化记忆和可搜索归档的持续对话场景
  • 希望以代码而非配置来定制行为的开发者

限制与说明

  • 项目定位为面向个人用户，而非单体框架
  • 定制即代码更改，没有配置蔓延
  • 沙箱模式无需 Docker；容器模式作为按组回退方案
  • 代码库约 35K token，可放入 Claude 上下文窗口
  • 安全模型依赖操作系统级沙箱，网络限制为 Anthropic API 和 localhost
  • 更多扩展（Discord、Gmail、QMD Memory、Obsidian、TUI）为计划中功能
  • 多模型智能体路由（支持多个 LLM 提供商）为分阶段计划功能

相关项目

  • NanoClaw：上游项目，最小智能体编排器
  • dotclaude.com：Claude Code 参考站点
  • Anthropic sandbox-runtime：ClaudeClaw 使用的操作系统级沙箱
  • QMD：混合语义搜索引擎（计划中的记忆升级）
  • Claude Agent SDK：驱动 ClaudeClaw 智能体的 SDK

同类工具

查看分类