TinyClaw 是什么
TinyClaw 核心功能全解析
多代理系统
智能团队协作
多渠道无缝接入
可靠消息队列机制
双端实时可视化监控
精准灵活路由
多 Provider 自由切换
7×24 小时稳定运行
安全访问控制
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. 一键安装（推荐，新手首选）
一行命令自动检测环境、安装依赖、配置环境变量，无需手动操作：
2. 从发布包安装
适合无网络环境或指定版本安装：
3. 从源码安装
适合开发者二次开发与定制：
（三）首次运行与配置
安装完成后，执行启动命令，自动进入交互式配置向导：
向导会依次引导完成以下配置：
- 选择启用的通讯渠道（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命令与智能体交互，适合本地自动化脚本调用。
TinyClaw的项目地址
- 项目GitHub主页：https://github.com/TinyAGI/tinyclaw
TinyClaw的应用场景
- 个人智能助手：在树莓派或旧电脑上部署全天候运行的个人 AI 助手，通过多渠道随时接收提醒、管理日程，用心跳检测主动推送待办事项。
- 开发团队协作：搭建代码审查工作流，让编码代理负责实现功能，审查代理检查质量，文档代理同步撰写说明，三者通过团队模式自动交接任务。
- 边缘设备部署：在资源受限的嵌入式设备上运行轻量级 AI 服务，模块化设计按需启用功能，最大化利用有限算力实现本地智能处理。
- 智能家居中枢：构建低成本的智能家居控制中心，通过 WhatsApp 或 Telegram 远程发送语音指令，代理协调控制各类物联网设备并反馈执行状态。
写到最后
TinyClaw是一款聚焦轻量化、易用性、实用性的开源多智能体协作框架，以“极简部署、稳定运行、灵活协作”为核心，打通多智能体分工、多团队协同、多渠道沟通、全天候运行的完整流程，无需重型架构与专业运维，即可让个人与团队快速拥有专属AI协作系统；项目基于TypeScript与Shell构建，兼容主流AI服务商与通讯平台，提供可视化监控、并行处理、持久会话、安全权限等企业级能力，同时保持开箱即用的极简体验，适用于个人助理、研发协作、客户服务、自动化任务等多种场景，是轻量级多智能体落地的优质选择，其开源开放的特性也为开发者提供了低门槛的多智能体学习与实验环境。
相关文章
