claw-me-maybe

用途

claw-me-maybe 是 Clawdbot 的一个技能，用于接入 Beeper。Beeper 是一款把多个聊天平台统一到一起的应用，通过它，Clawdbot 可以在多个聊天网络上发送消息、搜索聊天记录、汇总未读消息等。技能本身不直接连接各聊天平台，而是调用本机运行的 Beeper Desktop 提供的 API。

主要能力

搜索：在全部 Beeper 聊天中检索消息，例如查找某人上周关于某项目的发言。
发送消息：向任意 Beeper 网络发送消息，无需切换应用。
汇总收件箱：获取所有 Beeper 网络中未读消息的摘要。
设置提醒：为某个聊天设置提醒时间。
获取附件：从任意 Beeper 会话下载文件、图片和媒体。
表情回应：对任意 Beeper 网络中的消息添加表情回应。
标记已读：将会话标记为已读，保持收件箱整洁。

支持的平台

资料列出的 Beeper 网络及状态：WhatsApp、Telegram、Signal、Discord、Slack、Instagram DMs、Facebook Messenger、LinkedIn Messages、X (Twitter) DMs、Google Messages、Google Chat 均为完整支持；iMessage 仅限 macOS。

使用方式

获取 Beeper：下载并安装 Beeper 应用。
启用 Beeper Desktop API：打开 Beeper Desktop → Settings → Developers → 打开 “Beeper Desktop API” 开关。
（可选）添加 Beeper 令牌：在 Beeper Desktop → Settings → Developers 中点击 “Create Access Token”，然后写入 ~/.clawdbot/clawdbot.json，配置示例：

{
  "skills": {
    "entries": {
      "claw-me-maybe": {
        "enabled": true,
        "env": {
          "BEEPER_ACCESS_TOKEN": "your-token-here"
        }
      }
    }
  }
}

注意：BEEPER_API_URL 默认是 http://localhost:23373，除非 Beeper 运行在其他端口，否则无需设置。

配置完成后可用自然语言向 Clawdbot 下达指令，例如：

“Show me my unread messages in Beeper”
“Search my Beeper chats for messages about dinner plans”
“Send a WhatsApp message to John saying I'm on my way”
“What's the latest in my Signal group chat?”
“Message the #general channel on Slack: standup in 5 minutes”
“Find all messages from Lisa in the last week”
“React with 👍 to that last message”
“Mark my Discord chats as read”

技术接口概览

基础地址：http://localhost:23373（需 Beeper Desktop 正在运行）。使用令牌时请求头为：

-H "Authorization: Bearer ${BEEPER_ACCESS_TOKEN}"

资料中给出的主要端点包括：

账户：列出账户 GET /v1/accounts
聊天：列出聊天 GET /v1/chats；搜索聊天 GET /v1/chats/search?q=...；获取聊天详情 GET /v1/chats/{chatID}；创建聊天 POST /v1/chats；归档/取消归档 POST /v1/chats/{chatID}/archive
消息：列出聊天消息 GET /v1/chats/{chatID}/messages；跨网络搜索消息 GET /v1/messages/search?q=...；发送消息 POST /v1/chats/{chatID}/messages；回复消息（在发送请求体中带 replyTo）；标记已读 POST /v1/chats/{chatID}/read
表情回应：添加 POST /v1/chats/{chatID}/messages/{messageID}/reactions；移除 DELETE /v1/chats/{chatID}/messages/{messageID}/reactions
联系人：搜索联系人 GET /v1/accounts/{accountID}/contacts?q=...
提醒：创建 POST /v1/chats/{chatID}/reminders；删除 DELETE /v1/chats/{chatID}/reminders
附件：下载 POST /v1/assets/download
健康检查：GET /health

资料还提供了若干实用示例，如获取未读摘要、查找 WhatsApp 聊天、批量标记已读、快速回应最后一条消息、检查 Beeper 是否就绪、获取最近 24 小时消息、按服务过滤聊天等。

适用场景

适合需要在多个聊天平台之间统一收发消息、检索历史记录、汇总未读、批量处理会话的用户，尤其是已使用 Beeper 并希望让 Clawdbot 代为操作聊天数据的场景。

限制与注意事项

Beeper Desktop 必须正在运行，API 内置于 Beeper Desktop，没有 Beeper 就无法连接。
本地且私密：Beeper API 完全在本机运行，通过该技能的消息不会经过外部服务器。
尊重各网络规则：仅供个人使用，发送过多消息可能触发 WhatsApp 等平台的速率限制。
iMessage 需要 macOS。
表情回应因网络而异，并非所有平台支持所有 emoji，Beeper 会负责转换。
资料未提供收费、价格、平台兼容性之外的更多信息。