🎭 session-invite

Clawdbot Skill: 邀请 Agent 加入对话

✨ 功能

让 Clawdbot 的多个 Agent 可以互相邀请加入对话，实现多 Agent 协作。

🚀 安装

方法一：使用安装脚本

# 克隆仓库
git clone https://github.com/Ghoscro/clawdbot-session-invite.git

# 复制到 Clawdbot 目录
cp -r clawdbot-session-invite /path/to/clawd/skills/session-invite

# 运行安装脚本
chmod +x /path/to/clawd/skills/session-invite/install.sh
/path/to/clawd/skills/session-invite/install.sh

# 重启 Clawdbot
pkill -f clawdbot && nohup clawdbot > /dev/null 2>&1 &

方法二：手动安装

1. 复制文件到 ~/.clawdbot/skills/session-invite/
2. 复制 hook 到 ~/.clawdbot/hooks/session-invite-notify/
3. 编辑 ~/.clawdbot/clawdbot.json 添加配置：

{
  "skills": {
    "entries": {
      "session-invite": {
        "enabled": true
      }
    }
  },
  "hooks": {
    "internal": {
      "enabled": true,
      "entries": {
        "session-invite-notify": {
          "enabled": true
        }
      }
    }
  }
}

📖 使用方法

邀请 Agent

花火: 我想邀请流萤加入对话
→ 使用 sessions_invite { targetAgent: "liuying" }

接受邀请

流萤收到通知: 📩 收到邀请！花火 邀请你加入对话
→ 使用 sessions_accept_invite { inviteId: "inv_xxx" }

查看参与者

sessions_participants
→ 返回当前对话的所有参与者列表

🔧 工作原理

┌─────────────┐     invite      ┌─────────────┐
│   Agent A   │ ───────────────→│   Agent B   │
│  (花火)      │                 │  (流萤)      │
└─────────────┘                 └─────────────┘
      │                               │
      │  ① sessions_invite            │
      │     - 创建邀请记录             │
      │     - 写入通知文件             │
      │                               │
      │                    ② bootstrap hook
      │                       - 检查通知
      │                       - 注入提示
      │                               │
      │                    ③ sessions_accept_invite
      │  ④ 收到接受通知                │
      │     - 更新参与者列表           │
      │←──────────────────────────────┘
      │
      ▼
  多人对话开始！

📁 文件结构

session-invite/
├── index.ts                 # Skill 主文件
├── package.json             # 包配置
├── install.sh               # 安装脚本
├── README.md                # 说明文档
├── DEPLOY_LOG.md            # 部署日志
└── hooks/
    └── session-invite-notify/
        └── handler.ts       # 通知 Hook

📊 状态存储

状态文件存储在 /home/micker/clawd/session-state/:

• invitations.json - 邀请记录
• participants.json - 参与者列表
• notifications/<agentId>/ - 通知队列

⚠️ 注意事项

1. 需要 Clawdbot 配置 tools.agentToAgent.enabled = true
2. Agent 需要启动新会话才能收到邀请通知
3. 基于文件系统的简单实现，适合单机部署

📜 License

MIT License - 详见 LICENSE 文件

🤝 贡献

欢迎提交 Issue 和 Pull Request！

Made with ❤️ by Micker Team