BotTalk - 开源免费的微信推送服务

BotTalk 是什么

「BotTalk」是一款基于微信ClawBot 机器人通道的消息推送服务。它让你的服务器、脚本、IoT 设备可以直接把消息推送到你的个人微信。

简单说来，就是从服务器、路由器等设备上推消息到手机的工具。不需要企业微信，不需要关注公众号，扫一次码就永久绑定。

和 Server酱不同的是，BotTalk 走的是微信机器人通道——消息直接由微信ClawBot 发送到你的微信私聊，体验就像一个朋友给你发消息。而且 BotTalk 完全开源（MIT 协议），你可以自己部署，也可以直接用我们提供的免费托管服务。

开通并使用上它，只需要一分钟：

1

微信扫码登入

扫码即注册，无需填写任何信息

2

获取 SendKey

登录后自动生成，复制即可使用

3

发消息

一个 HTTP 请求即可推送到微信

发消息有两种方式：

在支持 Server酱的软件界面或配置文件中，将 API 地址替换为 BotTalk 的地址即可使用
你也可以直接访问推送 URL 发送请求，就可以收到消息啦

💡 由于微信 ClawBot 当前策略是同一微信号只保持一个活跃通道，绑定新应用会自动失效之前的连接。如果发现消息未收到，只需重新扫码即可恢复，秒级完成。

📋 微信官方限制（非 BotTalk bug）：微信 ClawBot 是腾讯设计的智能体聊天通道。实测中：连续收 7-10 条消息不回必触发限流，回一字即可恢复——哪怕隔 10 天再回复也照样恢复，无需重扫。建议养成习惯——看到推送随手回一字。查看详细说明 →

⚠️ 将下方 <SENDKEY> 替换为你在 Key&API 页面获取的 SendKey，粘贴到浏览器地址栏就可以测试推送消息：

https://bot-talk.com/<SENDKEY>.send?title=你好&desp=这是消息内容

微信 ClawBot 24 小时互动限制

官方文档说明 + BotTalk 的应对方案

微信官方怎么说的

「当你发消息后，微信 ClawBot 仅接收 OpenClaw 24 小时内的回复。」

以下为微信 ClawBot 功能介绍页面的截图：

翻译成人话

简单说来，你通过 BotTalk 收消息时，底层用的是微信 ClawBot 通道，也许微信开放的这个通道是提供给你与 OpenClaw 对话的，所以如果你要保持它畅通、能稳定作为消息接收渠道，就要让它看起来像是聊天。

我们的测试表明：连续收到 10 条消息（最极端快速连续 6 条）如果都不回复，则再发送消息时会被微信限流。此时只要在微信里回复一下立刻恢复——而且实测哪怕隔了 10 天再回复，通道照样恢复，无需重新扫码。也就是说本质上只有"限流"这一种状态，没有"时间到了就解绑"这回事；除非通道彻底失效（极少数情况，页面会有明确提示），否则永远不用重扫。

所以如果你要好好使用它做你的消息接收通道，安全稳定的做法就是收到消息别超过 7-8 条就随便在微信里面胡乱发一个字，我们平台必然立刻给你回复一条消息——这就表明通道又可以连发 7-8 条。

只要你假装在和它对话，它就永远不会失联。

我们自己通常是收到消息，有事没事就回一条，这样我们从未失联过。

这不是 BotTalk 的 bug，是微信 ClawBot 协议的设计限制。

BotTalk 为你做了什么

回复即恢复 — 被限流后在微信回 Bot 一字立刻恢复，哪怕隔 10 天也行，几乎永远不用重扫
秒回确认 — 你回复后立刻收到确认，证明通道已通
失败消息自动补发 — 通道恢复后自动补发最近漏掉的一条，标注原定推送时间
极端情况才需重扫 — 仅当通道彻底失效（罕见）才需访问 bot-talk.com/app 重扫，SendKey 和历史不变

建议养成的习惯

每次看到推送，顺手回"1"
就像微信群里回"收到"一样，一秒钟的事。
最稳妥的做法是收到 4-5 条就回一字，避免被腾讯限流。

BotTalk vs Server酱

	BotTalk	Server酱
开源	MIT 开源	闭源
价格	完全免费	免费版每天 5 条限制
自部署	✅ Docker 一键部署	❌ 不支持
API 兼容	兼容 Server酱格式	—
推送通道	微信机器人（微信ClawBot 私聊直达）	企业微信 / 测试号等（需额外配置）
绑定方式	扫码即绑定，无需关注公众号	需要关注公众号或加入企业
多语言 SDK	Python / Node.js / Go	官方仅提供 API
管理后台	✅ 内置 Admin 面板	✅ Web 控制台
数据隐私	自部署，数据完全自控	数据存储在第三方

工作原理

BotTalk 使用微信ClawBot 机器人作为消息通道。你的消息经 BotTalk 服务转发给微信ClawBot，再由机器人直接推送到你的微信私聊，流程如下：

快速开始

最简单的方式 —— 浏览器地址栏直接访问：

GET 仅发送标题：

https://bot-talk.com/<SENDKEY>.send?title=服务器挂了

GET 发送标题 + 内容：

https://bot-talk.com/<SENDKEY>.send?title=服务器挂了&desp=CPU 占用 100%，请立即处理

POST 发送 JSON（推荐，内容不限长度）：

      curl
# POST JSON 请求
curl -X POST https://bot-talk.com/<SENDKEY>.send \
  -H "Content-Type: application/json" \
  -d '{"title": "部署完成", "desp": "v2.1.0 已成功上线"}'
    

API 调用说明

BotTalk 提供两种风格的推送接口，兼容 Server酱格式：

风格一：Server酱兼容

      HTTP
GET/POST  https://bot-talk.com/{sendkey}.send

参数（Query 或 JSON Body）：
  title    — 消息标题（与 desp 不能同时为空）
  desp     — 消息内容（可选）
  channel  — 目标通道（可选，多通道时指定）
    

风格二：通用推送

      HTTP
GET/POST  https://bot-talk.com/notify

认证方式（二选一）：
  ?key=SENDKEY                       — Query 参数
  Authorization: Bearer SENDKEY        — Header

参数：
  title   — 消息标题
  msg     — 消息内容（也接受 desp / message）
    

响应格式

      JSON
// 成功
{ "code": 0, "message": "success", "data": { ... } }

// 失败
{ "code": 40001, "message": "Invalid SendKey" }

错误码：
  40001  — SendKey 无效
  40002  — 没有可用的推送通道
  40003  — 消息内容为空
  42901  — 超过频率限制
  50001  — 推送失败（响应自带 data.reason + data.hint，可直接显示给终端用户）

// 50001 自救（最常见 ret:-2 场景）：
{
  "code": 50001,
  "data": {
    "reason": "context_expired",
    "hint": "让收信人在微信里向 ClawBot 回复任意一条消息，1-2 分钟内自动补发"
  }
}
    

多语言 SDK

所有可以发起 HTTP 请求的语言和工具都可以调用。我们还提供官方 SDK，让集成更简单：

🐍 Python

零依赖，支持 Python 3.8+

pip install bottalk

📦 Node.js

TypeScript，零依赖

npm install bottalk

🔷 Go

标准库，Go 1.21+

go get github.com/bot-talk-k/BotTalk-go

调用示例

最简单 — 一行搞定，无需任何 SDK，粘贴到浏览器地址栏即可：

      浏览器 / curl
https://bot-talk.com/YOUR_SENDKEY.send?title=Hello
    

当然，也提供官方 SDK：

      Python
from bottalk import BotTalk

os = BotTalk("YOUR_SENDKEY")
os.send("服务器挂了！", desp="CPU 100%")
    

      Node.js
import { BotTalk } from 'bottalk';

const os = new BotTalk('YOUR_SENDKEY');
await os.send('Deploy done', { desp: 'v2.1.0' });
    

      Go
client := bottalk.New("YOUR_SENDKEY")
client.Send("Hello from Go!")
    

自部署

不想用托管服务？4 行命令部署你自己的 BotTalk 实例：

      Shell
git clone https://github.com/bot-talk-k/BotTalk.git
cd bottalk
cp .env.example .env   # 编辑 BASE_URL 为你的域名
docker compose up -d
    

详细部署文档请参考自部署指南。

基于个人微信的消息推送服务