Skip to content

aristorechina/wxWebHook

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

wxWebHook

wxWebHook

本项目是一个轻量级的消息通知服务。通过封装微信官方接口,帮助开发者将关键信息快速推送至微信端。用户只需通过简单的 HTTP 请求或命令行调用即可将内容实时推送到自己的微信上,实现随时随地接收提醒。

Warning

出于安全考虑,请不要将服务暴露到公网!

前端:GitHub

后端:GitHub

安装

使用 Docker (推荐)

docker pull ghcr.io/aristorechina/wxwebhook:latest

运行二进制

Releases 下载编译好的产物

从源码构建

GitHub wxWebHook-coreGitHub wxWebHook-panel 的 README 分别有详细的说明

快速开始

  1. 首次启动查看程序输出
2026/03/27 13:50:55 wxwebhook-core data dir C:\Users\Administrator\AppData\Local\wxwebhook
2026/03/27 13:50:55 wxwebhook-core database C:\Users\Administrator\AppData\Local\wxwebhook\wxwebhook.db
2026/03/27 13:50:55 initial admin token generated: p9YFnbts2YSVSYJZNGLFoB7IfyjuDvsY
2026/03/27 13:50:55 IMPORTANT: change this token immediately after first login.
2026/03/27 13:50:55 wxwebhook-core listening on :18731

这段日志代表了:数据存储在 C:\Users\Administrator\AppData\Local\wxwebhook 目录下,数据库文件是 wxwebhook.db,初始化默认密码为 p9YFnbts2YSVSYJZNGLFoB7IfyjuDvsY(程序自动生成,只会显示一次,进入面板后请及时更换密码),程序运行在端口 18731

  1. 使用默认密码登录面板

  1. 登录面板后在面板的「设置」修改默认密码

  1. 在面板的「微信接入」点击「生成二维码」

  1. 将手机微信升级到 8.0.69 以上

  2. 在手机微信右上角「⊕」点击「扫一扫」

  1. 点击「连接」( GitHub 使用的 API 来自微信官方项目 npm

  1. 连接后你需要在微信给「微信ClawBot」发送任意消息

  1. 然后可以在面板的「测试发送」发送任意消息检查服务是否可用

  1. 在面板的「Webhook」创建 Webhook,名称随意

在这里你可以创建、启用、停用、删除接口

使用示例:

curl -X POST "http://localhost:18731/hook/oBUagskGfrPP/send" -H "Content-Type: application/json" -H "X-Webhook-Secret: OPnj1GsKk0CENl_D13opp7OLweZrx4ZH" -d "{\"text\":\"这是一条测试消息\"}"

输出产物

Docker 镜像

镜像地址:

  • ghcr.io/aristorechina/wxwebhook:latest

Release

  • wxwebhook-core-<os>-<arch>.(tar.gz|zip) 后端二进制文件
  • wxwebhook-panel-dist.tar.gz 面板静态文件
  • docker-image-wxwebhook-linux-amd64.tar.gz 离线 Docker 镜像(amd64)
  • docker-image-wxwebhook-linux-arm64.tar.gz 离线 Docker 镜像(arm64)
  • SHA256SUMS.txt

Q&A

Q: 使用这个项目有可能导致封号吗?

A: 大概率是不会的,因为项目使用的 API 均来自微信官方的这个开源项目 npm ,不是使用不合规的手段得到的。

Q: 为什么不直接用微信的 openclaw 插件,这个项目的意义在哪?

A: 因为我觉得 openclaw 是个伪需求,没必要跟风安装,而且 openclaw 存在很多漏洞,安装风险比较大。这个项目的意义是可以通过微信官方的接口将消息推送到微信。

Q: 这个项目的使用场景?

A: 比如推送服务器的报警信息,或定时脚本运行结束后的输出结果。总之适用于需要监控进度或较为紧急的信息,通过推送到微信可以更及时地进行了解。

Q: 第一次启动但没有输出面板的默认密码怎么办?

A: 先根据输出内容定位到数据存储的文件夹,停止服务,把存储数据的文件夹删除,然后启动项目,在命令行查看新的默认密码。

About

本项目是一个轻量级的消息通知服务。通过封装微信官方接口,帮助开发者将关键信息快速推送至微信端。用户只需通过简单的 HTTP 请求或命令行调用即可将内容实时推送到自己的微信上,实现随时随地接收提醒。

Resources

License

Stars

Watchers

Forks

Packages