TinyClaw：TinyAGI 推出的轻量多智能体 AI 团队协作运行框架
一、TinyClaw是什么
TinyClaw是TinyAGI团队开源的一款轻量、高效、可私有化部署的多智能体协作AI框架，定位为“多智能体、多团队、多渠道、7×24小时不间断运行的AI助手”，核心设计理念是“用极简代码与轻量化架构，实现复杂的AI智能体团队协作”，让普通用户与开发者无需搭建重型系统，即可快速拥有一支可分工、可协作、可监控、可跨平台沟通的AI团队。
作为社区驱动的MIT授权开源项目，TinyClaw不依赖专属云端服务，可在macOS、Linux、Windows（WSL2）环境本地运行，复用用户已有的Anthropic Claude、OpenAI Codex订阅服务，不违反服务商使用条款，同时为每个智能体提供独立隔离的工作空间，保证会话上下文、执行环境、数据存储相互分离，避免任务冲突与信息干扰。
TinyClaw的核心由三大基础概念构成：
智能体（Agent）：具备专属角色与能力的单一AI实例，可设定为编码、写作、审核、助理等不同身份，拥有独立配置与工作目录；
团队（Team）：多个智能体的组合单元，支持链式执行、任务扩散两种协作模式，可指定团队负责人智能体，实现任务分发与流转；
渠道（Channel）：智能体接收与发送消息的入口，支持Discord、WhatsApp、Telegram三大主流即时通讯平台，用户可在任意渠道与同一AI团队交互。
区别于重型多智能体框架，TinyClaw主打“开箱即用、轻量无负担”，所有配置与管理通过CLI命令与简易JSON文件完成，无需复杂的容器编排、云端部署与专业运维知识，开发者、个人用户、小型团队均可快速上手，打造专属的自动化AI协作系统。
二、TinyClaw功能特色
TinyClaw围绕“多智能体协作、稳定运行、便捷管理、跨平台兼容”四大核心需求，打造了完整且实用的功能体系，核心特色可归纳为八大类，具体能力如下表所示：
| 功能分类 | 核心能力 | 详细说明 |
|---|---|---|
| 多维度协作 | 多智能体隔离运行、多团队链式/扩散协作 | 同时运行数十个独立智能体，每个智能体拥有专属提示词、AI模型与工作目录；团队支持任务接力分发与并行处理，实现复杂工作流自动化 |
| 多渠道接入 | Discord、WhatsApp、Telegram兼容 | 三大通讯渠道无缝对接，同一用户、同一对话可在任意平台切换使用，消息实时同步，无需重复配置 |
| 可视化监控 | 实时TUI仪表盘、团队对话观测 |
支持tinyclaw team visualize命令启动终端可视化界面，实时查看智能体消息流、任务状态、协作流程，全程可观测、可追溯 |
| AI生态兼容 | 多服务商支持、模型自由切换 | 兼容Anthropic Claude（Sonnet/Opus）、OpenAI Codex（GPT-5.3），复用现有订阅，支持动态切换服务商与模型，无需重新部署 |
| 高性能处理 | 并行消息处理、单智能体顺序执行 | 不同智能体并发处理消息提升效率，单个智能体内保持消息顺序，平衡处理速度与对话逻辑连贯性 |
| 稳定可靠 | 持久化会话、SQLite任务队列 | 重启后自动恢复对话上下文，任务队列支持原子事务、重试机制、死信管理，避免消息丢失与执行失败 |
| 7×24运行 | tmux守护进程、心跳检测 | 基于tmux实现后台不间断运行，支持自定义心跳间隔，智能体主动巡检待办任务、错误信息、未读消息 |
| 易用性 | 一键安装、交互式配置向导 | 提供一行命令自动安装脚本，首次运行启动交互式向导，引导完成渠道、令牌、工作区、智能体全流程配置 |
除此之外，TinyClaw还具备发送者配对安全机制，陌生用户发送消息需生成配对码并手动审批，防止垃圾信息与非法访问；支持CLI纯模式运行，无需配置通讯渠道，直接通过终端与智能体交互，满足本地自动化测试与脚本调用需求；内置自我更新能力，可一键从GitHub拉取最新版本，保留原有配置与数据，降低维护成本。
三、TinyClaw技术细节
（一）技术栈与运行环境
TinyClaw采用TypeScript+Shell双语言核心架构，兼顾脚本执行效率与逻辑开发便捷性，同时兼容Rust重构版本，提升跨平台与性能表现，完整技术栈与运行要求如下：
核心开发语言：TypeScript（主逻辑）、Shell（安装/启动/管理脚本）、Python（辅助工具）；
运行环境：macOS、Linux、Windows（WSL2），不支持原生Windows环境；
基础依赖：Node.js v18+、tmux（后台守护）、jq（JSON解析）、Bash 4.0+（macOS需手动升级）；
AI服务依赖：Anthropic Claude Code CLI、OpenAI Codex CLI，需提前配置好对应API密钥；
存储组件：SQLite（任务队列、会话数据、配置信息持久化）、本地文件系统（智能体工作空间、日志存储）。
（二）系统架构设计
TinyClaw采用分层解耦架构，各模块独立运行、相互通信，整体流程清晰、易于调试与扩展，核心架构分为五层：
消息渠道层：对接Discord、Telegram、WhatsApp机器人接口，监听用户消息，校验发送者权限，将合法消息写入任务队列；
任务队列层：基于SQLite实现原子化消息队列，管理消息状态（待处理/处理中/已完成/死信），支持重试、超时、死信回收机制；
队列处理层：监控队列状态，将消息分发给对应智能体或团队，协调并行处理与顺序执行逻辑，避免资源竞争；
智能体执行层：每个智能体在独立工作空间运行，调用对应AI服务商CLI完成任务处理，维护专属会话上下文与执行记录；
可视化与管理层：提供CLI命令集与TUI实时仪表盘，支持配置修改、状态查看、日志监控、团队协作观测、进程管理。
该架构的核心优势是确定性执行、高吞吐、易扩展，所有消息通过文件与数据库持久化，即使进程中断、系统重启，也能从断点恢复执行；同时采用模块化设计，可快速新增AI服务商、通讯渠道、智能体角色，无需改动核心代码。
（三）核心技术实现
隔离工作空间：每个智能体对应独立本地目录，存储会话历史、配置文件、执行日志、临时文件，彻底避免数据交叉污染；
并行处理引擎：多智能体并发消费队列消息，单智能体内部按消息顺序处理，兼顾并发效率与对话逻辑完整性；
心跳调度机制：基于定时任务触发智能体主动巡检，执行待办提醒、错误修复、消息同步等主动式任务，实现7×24小时自动化运行；
团队协作路由：支持两种协作模式——链式执行（任务按智能体顺序接力完成）、扩散执行（任务同时分发给多个智能体并行处理），通过
@符号指定智能体/团队触发；安全权限控制：发送者白名单+配对码审批机制，仅授权用户可与智能体交互，保护本地系统与数据安全。
（四）目录结构
TinyClaw目录结构简洁清晰，核心文件与目录功能明确：
tinyclaw/ ├── scripts/ # 安装、卸载、更新、打包自动化脚本 ├── tinyoffice/ # Web可视化仪表盘（Next.js项目） ├── src/ # 核心业务逻辑（渠道对接、队列处理、智能体管理） ├── lib/ # 公共工具库、通用函数 ├── bin/ # 可执行CLI命令入口 ├── docs/ # 官方文档（AGENTS.md/TEAMS.md/QUEUE.md/TROUBLESHOOTING.md） ├── tinyclaw.sh # 项目主入口脚本 ├── settings.json # 全局配置文件（渠道、智能体、团队、心跳参数） └── README.md # 项目说明文档
用户配置与数据默认存储在~/.tinyclaw/目录，包含队列数据、日志文件、配对信息、会话记录，升级与重装时不会丢失。
四、TinyClaw应用场景
TinyClaw轻量化、可协作、跨平台的特性，使其适用于个人、团队、小型组织的多种自动化与协作场景，核心落地场景如下：
1. 个人7×24小时AI助手
作为私人智能助理，TinyClaw可实现日程提醒、待办管理、信息查询、文件整理、邮件处理等日常任务，通过心跳机制主动推送提醒，无需用户主动询问，支持手机端（WhatsApp/Telegram）与桌面端（Discord/CLI）随时交互，成为全天候在线的私人助手。
2. 研发团队协作流水线
搭建研发专属AI团队，分配coder（编码修复）、reviewer（代码审核）、writer（文档生成）、tester（测试用例生成）等智能体角色，通过指令触发协作流程，例如发送@dev 修复auth.ts漏洞，团队负责人自动分配任务，编码智能体修复后通知审核智能体，审核完成后交付结果，实现研发任务自动化流转。
3. 多渠道客户服务助手
为小型团队/个人品牌搭建跨平台客服系统，统一对接Discord、Telegram、WhatsApp客户消息，智能体自动回复常见问题、记录客户需求、分发人工处理任务，无需在多个平台切换后台，提升客户响应效率。
4. 自动化任务执行引擎
配置定时心跳任务，实现数据汇总、报表生成、网络监控、文件备份等周期性自动化工作，例如每日定时整理工作文件、每周生成任务周报、实时监控指定服务状态，全程无需人工干预。
5. AI智能体学习与实验平台
对于AI开发者与学习者，TinyClaw提供极简的多智能体实验环境，无需搭建重型框架，即可快速测试智能体协作逻辑、提示词效果、模型表现，支持自定义角色与工作流，降低多智能体系统的学习与实验成本。
五、TinyClaw使用方法
（一）环境准备
确认系统为macOS/Linux/Windows WSL2；
安装Node.js v18+、tmux、jq、Bash 4.0+；
提前安装并配置Anthropic Claude Code CLI或OpenAI Codex CLI，确保API密钥可用；
如需使用通讯渠道，提前创建对应平台机器人并获取令牌（Discord/Telegram），或准备好WhatsApp扫码登录权限。
（二）安装方式（三种可选）
1. 一键安装（推荐，新手首选）
一行命令自动检测环境、安装依赖、配置环境变量，无需手动操作：
curl -fsSL https://raw.githubusercontent.com/TinyAGI/tinyclaw/main/scripts/remote-install.sh | bash
2. 从发布包安装
适合无网络环境或指定版本安装：
wget https://github.com/TinyAGI/tinyclaw/releases/latest/download/tinyclaw-bundle.tar.gz tar -xzf tinyclaw-bundle.tar.gz cd tinyclaw && ./scripts/install.sh
3. 从源码安装
适合开发者二次开发与定制：
git clone https://github.com/TinyAGI/tinyclaw.git cd tinyclaw && npm install && ./scripts/install.sh
（三）首次运行与配置
安装完成后，执行启动命令，自动进入交互式配置向导：
tinyclaw start
向导会依次引导完成以下配置：
选择启用的通讯渠道（Discord/Telegram/WhatsApp）；
输入对应渠道的机器人令牌；
设置智能体工作空间目录；
配置默认智能体名称、AI服务商、模型版本；
设置心跳检测间隔（默认1小时）；
配置完成后，系统自动启动tmux守护进程，进入7×24小时运行状态。
（四）核心CLI命令使用
进程管理：
tinyclaw start：启动服务tinyclaw stop：停止所有进程tinyclaw restart：重启服务tinyclaw status：查看运行状态智能体管理：
tinyclaw agent list：列出所有智能体tinyclaw agent add：新增智能体tinyclaw agent remove <名称>：删除智能体团队管理：
tinyclaw team list：列出所有团队tinyclaw team visualize <名称>：启动实时可视化仪表盘日志与监控：
tinyclaw logs all：查看全部日志tinyclaw attach：连接tmux会话更新与配置：
tinyclaw update：一键更新版本tinyclaw setup：重新运行配置向导
（五）聊天交互指令
在通讯渠道中，可通过以下指令与智能体交互：
@智能体名称 任务内容：指定单个智能体执行任务@团队名称 任务内容：分配任务给指定团队/agent：查看所有可用智能体/team：查看所有可用团队/reset：重置对话上下文
六、常见问题解答（FAQ）
Q：TinyClaw支持Windows原生系统运行吗？
A：不支持Windows原生系统，仅支持macOS、Linux以及Windows的WSL2子系统，WSL2可在微软商店免费安装，配置简单且兼容性良好。
Q：使用TinyClaw需要付费吗？
A：TinyClaw本身是MIT开源协议的免费项目，无任何付费功能与限制；但需要用户自行提供Anthropic Claude或OpenAI Codex的订阅服务与API密钥，相关费用由AI服务商收取。
Q：启动后机器人无法接收消息，如何排查？
A：首先执行tinyclaw logs all查看完整日志，检查机器人令牌是否正确、渠道权限是否开启（如Discord的Message Content Intent）、发送者是否完成配对审批，同时确认tmux进程正常运行。
Q：多个智能体同时运行会冲突吗？
A：不会冲突，TinyClaw为每个智能体分配独立隔离的工作空间、会话上下文与执行环境，任务队列通过原子事务管理，确保消息分发与执行互不干扰。
Q：重启电脑后TinyClaw会自动恢复吗？
A：会自动恢复，所有会话、配置、队列数据均持久化存储，重启后重新执行tinyclaw start即可从断点继续运行，无需重新配置。
Q：可以自定义智能体的角色与能力吗？
A：可以，通过修改智能体对应的工作空间配置文件、提示词模板，可自定义编码、写作、翻译、数据分析等任意角色，同时支持切换不同AI模型调整能力表现。
Q：如何禁止陌生用户与我的智能体对话？
A：TinyClaw默认开启发送者配对机制，陌生用户发送消息会生成配对码，需在终端执行tinyclaw pairing approve <配对码>手动批准后，才能正常交互，未批准的消息会被自动拦截。
Q：升级TinyClaw会丢失配置与数据吗？
A：不会丢失，tinyclaw update命令会自动备份原有配置与数据，安装新版本后直接复用，无需重新配置渠道、智能体与团队信息。
Q：不使用通讯渠道，可以运行TinyClaw吗？
A：可以，使用--cli-only参数启动纯终端模式，无需配置Discord/Telegram/WhatsApp，直接通过tinyclaw send命令与智能体交互，适合本地自动化脚本调用。
七、相关链接
项目GitHub主页：https://github.com/TinyAGI/tinyclaw
八、项目总结
TinyClaw是一款聚焦轻量化、易用性、实用性的开源多智能体协作框架，以“极简部署、稳定运行、灵活协作”为核心，打通多智能体分工、多团队协同、多渠道沟通、全天候运行的完整流程，无需重型架构与专业运维，即可让个人与团队快速拥有专属AI协作系统；项目基于TypeScript与Shell构建，兼容主流AI服务商与通讯平台，提供可视化监控、并行处理、持久会话、安全权限等企业级能力，同时保持开箱即用的极简体验，适用于个人助理、研发协作、客户服务、自动化任务等多种场景，是轻量级多智能体落地的优质选择，其开源开放的特性也为开发者提供了低门槛的多智能体学习与实验环境。
版权及免责申明：本文由@dotaai原创发布。该文章观点仅代表作者本人，不代表本站立场。本站不承担任何相关法律责任。
如若转载，请注明出处：https://www.aipuzi.cn/ai-news/tinyclaw.html
