wxWebHook-core
March 27, 2026 · View on GitHub
本仓库是 
wxWebHook-core 是一个基于 Go 的微信 Webhook 后端，项目默认监听 http://localhost:18731。
前端见
Warning
出于安全考虑，请不要将服务暴露到公网！
Important
本项目参考自 @tencent-weixin/openclaw-weixin，使用的是微信官方在开源项目中使用的接口，并没有进行任何逆向工程的操作。
运行方式
环境要求
- Go
1.25+ - 可访问微信相关接口与 CDN
安装与启动
go mod download
go run ./cmd/server
或构建后运行：
go build -o wxwebhook-core ./cmd/server
./wxwebhook-core
首次启动 Token 说明
当数据库中还没有管理 Token 且未设置 WXWEBHOOK_ADMIN_TOKEN 时，服务会自动生成一个随机 Token，并在终端输出：
initial admin token generated: <随机Token>
IMPORTANT: change this token immediately after first login.
注意：
- 这条日志只会在首次初始化管理 Token 时输出
- 如果数据库已初始化，后续重启不会重复生成新 Token
环境变量
| 变量名 | 默认值 | 说明 |
|---|---|---|
WXWEBHOOK_SERVER_ADDR | :18731 | 服务监听地址 |
WXWEBHOOK_PANEL_ORIGIN | http://localhost:5173 | 允许跨域的前端来源（必须与前端实际 Origin 完全一致） |
WXWEBHOOK_DATA_DIR | 自动推导 | 数据目录 |
WXWEBHOOK_DB_PATH | 自动推导 | SQLite 文件完整路径 |
WXWEBHOOK_COOKIE_NAME | wxwebhook_session | 会话 Cookie 名称 |
WXWEBHOOK_SESSION_TTL_HOURS | 720 | 会话有效期（小时） |
WXWEBHOOK_ADMIN_TOKEN | 空 | 首次初始化使用的管理 Token（仅在数据库未初始化时生效） |
WXWEBHOOK_BASE_URL | https://ilinkai.weixin.qq.com | 微信基础 API 地址 |
WXWEBHOOK_CDN_URL | https://novac2c.cdn.weixin.qq.com/c2c | 微信 CDN 地址 |
数据与目录
默认会在数据目录写入：
wxwebhook.db（SQLite）media/messages/<account_id>/...（媒体缓存）