TinyClaw

TinyClaw 是一个开源、本地优先的 AI 助手平台，允许你在 macOS 或 Linux 系统上运行多个具备专业角色的 AI 智能体，并通过 Discord、Telegram 和 WhatsApp 与它们交互。所有智能体在隔离的工作空间中运行，支持持久会话、并行处理和团队协作，适合开发者、研究者或任何希望构建可定制、可观察、可控制的 AI 工作流的用户。

核心功能

• 多智能体架构：每个智能体拥有独立身份、模型配置和工作目录，互不干扰。
• 多团队协作：支持链式任务交接（如 coder → reviewer）和扇出式并行处理（如同时调用 writer 和 researcher）。
• 三通道支持：无缝接入 Discord、Telegram 和 WhatsApp，消息体验一致。
• 实时可视化：通过 tinyclaw team visualize 命令，在终端中实时观察智能体之间的协作流程。
• 合规使用现有 API：直接复用你已有的 Anthropic Claude 或 OpenAI Codex 订阅，无需额外服务，不违反 ToS。
• 可靠消息队列：基于文件系统的队列机制，避免竞态条件，确保消息顺序与完整性。
• 持久化上下文：重启后对话历史和工作状态自动恢复。
• 7×24 运行保障：依托 tmux 守护进程，确保服务长期在线。

快速开始

前置依赖

• macOS 或 Linux
• Node.js v14+
• tmux
• Bash 4.0+（macOS 用户可通过 brew install bash 安装）
• Claude Code CLI（Anthropic）
• Codex CLI（OpenAI）

安装方式（推荐一键安装）

curl -fsSL https://raw.githubusercontent.com/jlia0/tinyclaw/main/scripts/remote-install.sh | bash

首次运行

tinyclaw start

交互式向导将引导你完成：

• 选择启用的通信通道（Discord / Telegram / WhatsApp）
• 输入各平台的 Bot Token
• 配置工作空间路径
• 设置默认智能体、AI 提供商（Anthropic / OpenAI）及模型（如 Sonnet、Opus、GPT-5.3）
• 定义心跳检查频率（用于主动提醒或任务轮询）

通道配置简要

• Discord：在 Discord 开发者门户 创建 Bot，启用“Message Content Intent”，并通过 OAuth2 邀请到服务器。
• Telegram：通过 @BotFather 创建 Bot，获取 Token 后主动与 Bot 对话以激活。
• WhatsApp：启动后扫描终端显示的二维码，在手机端“设置 → 已链接设备”中确认绑定。

智能体与团队管理

智能体示例配置（.tinyclaw/settings.json）

"agents": {
  "coder": {
    "name": "Code Assistant",
    "provider": "anthropic",
    "model": "sonnet",
    "working_directory": "~/tinyclaw-workspace/coder"
  },
  "writer": {
    "name": "Technical Writer",
    "provider": "openai",
    "model": "gpt-5.3-codex",
    "working_directory": "~/tinyclaw-workspace/writer"
  }
}

每个智能体拥有：

• 独立工作目录（含 .claude/、heartbeat.md、AGENTS.md）
• 专属对话历史
• 可单独重置（tinyclaw agent reset coder）

团队协作示例

@dev fix the auth bug

→ 自动路由至团队 leader（如 coder）
→ coder 修复后提及 @reviewer
→ reviewer 被自动触发，完成审查
→ 最终结果返回给用户

支持串行链与并行扇出，完整逻辑见 docs/TEAMS.md。

安全与访问控制

TinyClaw 默认启用发送者配对机制：

• 未知用户首次发消息 → 收到配对码和批准指引
• 待批准期间，后续消息被静默丢弃
• 管理员通过 tinyclaw pairing approve ABCD1234 手动授权

所有通道均受此机制保护，确保只有授权用户可与智能体交互。

常用命令速查

设计理念

TinyClaw 受 OpenClaw 启发，但更轻量、聚焦于多智能体协作与跨通道一致性。它不依赖云端服务，所有数据保留在本地，强调：

• 本地优先：无数据上传，无第三方依赖
• 可审计性：配置文件透明，代码开源（MIT 许可）
• 可扩展性：通过 CLI 和脚本轻松集成自动化流程