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

BotTalk 是什么

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

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

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

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

1

微信扫码登入

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

2

获取 SendKey

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

3

发消息

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

发消息有两种方式：

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

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

📋 微信官方限制（非 BotTalk bug）：微信 ClawBot 文档明确写道「仅接收 24 小时内的回复」。每天给 Bot 回复一字（如"1"）即可保活。我们已设置自动提醒：在你最后一次回复后的第 22 小时主动提醒你。查看官方说明 →

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

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

微信 ClawBot 24 小时互动限制

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

微信官方怎么说的

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

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

翻译成人话

你通过 BotTalk 收消息时，底层用的是微信 ClawBot 通道。微信平台要求：

每隔 24 小时，你至少给 Bot 回一条消息，否则通道会被微信静默断开。

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

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

BotTalk 为你做了什么

第 22 小时自动提醒 — 在你最后一次回复后的第 22 小时，系统主动发一条提醒
秒回确认 — 你回复后立刻收到确认。没收到确认 = 通道已断
断了也能恢复 — 访问 bot-talk.com/app 重新扫码，SendKey 和历史不变
失败消息自动补发 — 通道恢复后，失联期间的消息自动补发，标注原定推送时间

建议养成的习惯

每次看到推送，顺手回"1"
就像微信群里回"收到"一样，一秒钟的事。
回一次 = 通道续命 24 小时。

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  — 推送失败
    

多语言 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
    

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

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