BotTalk 是什么
「BotTalk」是一款基于微信ClawBot 机器人通道的消息推送服务。它让你的服务器、脚本、IoT 设备可以直接把消息推送到你的个人微信。
简单说来，就是从服务器、路由器等设备上推消息到手机的工具。不需要企业微信，不需要关注公众号，扫一次码就永久绑定。
和 Server酱 不同的是，BotTalk 走的是微信机器人通道——消息直接由 微信ClawBot 发送到你的微信私聊，体验就像一个朋友给你发消息。而且 BotTalk 完全开源（MIT 协议），你可以自己部署，也可以直接用我们提供的免费托管服务。
开通并使用上它，只需要一分钟：
1
微信扫码登入
扫码即注册，无需填写任何信息
2
获取 SendKey
登录后自动生成，复制即可使用
3
发消息
一个 HTTP 请求即可推送到微信
发消息有两种方式：
- 在支持 Server酱 的软件界面或配置文件中，将 API 地址替换为 BotTalk 的地址即可使用
- 你也可以直接访问推送 URL 发送请求，就可以收到消息啦
💡
由于微信 ClawBot 当前策略是同一微信号只保持一个活跃通道，绑定新应用会自动失效之前的连接。如果发现消息未收到，只需重新扫码即可恢复，秒级完成。
⏱️
微信通道保活机制：iLink Bot 协议要求用户每 24 小时内至少给 Bot 回复一条任意消息（如"在"），通道即可持续保活；完全不回复会导致通道失联。这是微信 ClawBot 平台当前的限制。平台会尽可能在通道失效之前主动通过微信提醒你，收到提醒时回复一个字即可续命。若已失联，访问 /app 重新扫码即可恢复（SendKey 和 SDK 代码都不变）。后续如微信放开此限制，我们会第一时间跟进。
⚠️
将下方
<SENDKEY> 替换为你在 Key&API 页面 获取的 SendKey，粘贴到浏览器地址栏就可以测试推送消息：
https://bot-talk.com/<SENDKEY>.send?title=你好&desp=这是消息内容
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
详细部署文档请参考 自部署指南。