project
TinyClaw - TinyAGI开源的轻量级多智能体协作框架
TinyClaw 是 TinyAGI 开源的轻量级多智能体协作框架,专为资源受限环境设计。TinyClaw支持在树莓派等设备上同时运行多个专业 AI Agent(如 @coder、@writer)...
TinyClaw是什么
TinyClaw 是 TinyAGI 开源的轻量级多智能体协作框架,专为资源受限环境设计。TinyClaw支持在树莓派等设备上同时运行多个专业 AI Agent(如 @coder、@writer),智能体间可通过链式执行和扇出模式协作完成任务。系统覆盖 Discord、WhatsApp、Telegram 三大渠道并共享对话上下文,内置 SQLite 消息队列保障可靠传输,配合实时 TUI 仪表板与 TinyOffice Web 后台,适合构建 7×24 小时运行的边缘 AI 助手团队。
TinyClaw的主要功能
-
多代理系统:支持同时运行多个相互隔离的智能体,每个智能体拥有独立的工作目录、对话历史和配置文件。
-
团队协作:智能体之间可通过链式执行顺序交接任务,或通过扇出模式并行分发给多个队友处理。
-
多渠道接入:集成 Discord、WhatsApp、Telegram 三大平台,所有渠道共享同一套智能体对话上下文。
-
消息队列:采用 SQLite 原子事务队列处理消息,内置重试机制和死信管理确保消息可靠传输。
-
实时可视化:提供 TUI 终端仪表板实时监控团队状态,以及 TinyOffice Web 后台管理任务看板。
-
灵活路由:用户通过
@agent或@team前缀即可将消息精准路由到指定代理或团队处理。 -
Provider 切换:支持 Anthropic Claude 和 OpenAI Codex,可为每个智能体单独配置不同的 AI 提供商和模型。
-
7×24 运行:基于 tmux 实现守护进程模式,配合心跳检测机制确保系统长期稳定在线。
-
访问控制:内置配对码验证机制,管理员可审批发送者加入白名单,防止未授权用户访问代理。
如何使用TinyClaw
- 安装部署:执行官方提供的一键安装脚本即可完成环境部署,命令为 curl 加官方脚本地址后通过管道传给 bash 执行。
- 初始化配置:运行 tinyclaw start 命令进入交互式配置向导,按提示选择需要的通讯渠道、配置 AI 提供商密钥、命名工作区并设置默认代理。
- 创建代理:使用 tinyclaw agent add 命令交互式创建专业角色代理,用 tinyclaw agent provider 加代理名、提供商和模型参数为每个智能体单独指定 AI 配置。
- 配置团队:通过 tinyclaw team add 命令创建协作团队,指定团队成员和负责人,实现代理间的任务分发与协作。
- 消息路由:在任意已接入的通讯渠道中,使用艾特代理名或艾特团队名的前缀方式将消息精准路由给指定处理者,例如@ coder 写代码或@ dev 修复 bug。
- 监控管理:通过 tinyclaw status 命令了解系统运行情况,使用 tinyclaw logs all 命令排查问题,或执行 tinyclaw team visualize 加团队名启动终端可视化面板实时监控工作流程。
- Web 后台:进入 TinyOffice 目录后依次执行安装依赖和启动开发服务器命令,可在浏览器中通过本地地址访问可视化界面管理任务看板和代理配置。
- 日常维护:用 tinyclaw stop、start、restart 命令控制服务状态,通过 tinyclaw update 升级到最新版本,或使用 tinyclaw reset 清空对话历史但保留系统配置。
TinyClaw的项目地址
- GitHub仓库:https://github.com/TinyAGI/tinyclaw
TinyClaw的应用场景
- 个人智能助手:在树莓派或旧电脑上部署全天候运行的个人 AI 助手,通过多渠道随时接收提醒、管理日程,用心跳检测主动推送待办事项。
- 开发团队协作:搭建代码审查工作流,让编码代理负责实现功能,审查代理检查质量,文档代理同步撰写说明,三者通过团队模式自动交接任务。
- 边缘设备部署:在资源受限的嵌入式设备上运行轻量级 AI 服务,模块化设计按需启用功能,最大化利用有限算力实现本地智能处理。
- 智能家居中枢:构建低成本的智能家居控制中心,通过 WhatsApp 或 Telegram 远程发送语音指令,代理协调控制各类物联网设备并反馈执行状态。