3行代码发出第一条企业微信机器人消息we-work-bot 上手指南【免费下载链接】we-work-botA lite framework for wechat work bot. 轻量级企业微信群聊机器人框架。项目地址: https://gitcode.com/gh_mirrors/we/we-work-botwe-work-bot 是一个轻量级企业微信机器人 Python 框架专门服务企业微信群聊里的消息推送场景告警、日报、构建结果这类消息交给它自动发到群里。它把企业微信的 Webhook 接口封装成一条链式调用你不用自己拼 HTTP 请求体创建机器人、设置内容、发送几行代码完成。全部依赖只有一个 requests 库Python 3.5 以上就能跑从零到发出第一条消息整个过程十分钟以内。从零到第一条消息pip 一行安装环境要求只有 Python 3.5 以上第三方依赖只有requests安装时会自动解析pip3 install weworkbot3行代码发出第一条消息先在企业微信群里通过群聊设置添加机器人复制生成的 Webhook 地址形如https://qyapi.weixin.qq.com/cgi-bin/webhook/send?keyXXXX然后from weworkbot import Bot as wBot url https://qyapi.weixin.qq.com/cgi-bin/webhook/send?keyXXXX wBot(url).set_text(hello world).send()send()内部用 requests 向 Webhook 发 POST 请求响应状态码不是 200 时会写一条 error 日志。运行后群里立刻能看到这条文本消息。文本之外还能发什么set_text有个type参数传markdown就按 Markdown 消息发送支持font colorinfo重点内容/font这类样式set_image_path(path)发本地图片base64 编码和 md5 计算都由框架代劳你只管给文件路径wBot(url).set_text(font colorinfo今日构建失败/font, typemarkdown).send() wBot(url).set_image_path(report.png).send()让机器人自己跑起来定时任务交给 every() 和 run()想让机器人每小时把构建结果播报到群里不需要自己写循环Bot本身继承自线程.every(second, minute, hour, day)设置发送间隔.run()启动后按间隔循环发送。还可以用.check(fn)挂一个回调fn返回 True 才真正发送——比如监控指标超阈值时才报警wBot(url).set_text(定时播报).every(hour1).run()用发送计数器控制停止条件run()默认是死循环用set_check_counter(n)限制检查轮数、set_send_counter(n)限制实际发送次数任一条件满足线程自行退出。每隔 30 秒提醒一次、提醒 3 次后停止这类需求就是靠这两个参数实现的。群成员用 mentioned_list文本消息支持定向提醒set_mentioned_list([wangqing, all])按用户 ID 圈人set_mentioned_mobile_list([13800001111])按手机号圈人可以链在set_text后面一起调用。多机器人用 BotMgr 统一跑要给多个群同时发、或同一个群发多类消息用weworkbot/bot_mgr.py里的BotMgrbots.add_bot(url)注册机器人也可以append(bot)追加现成的 Bot调用一次bots.run()就把所有机器人线程启动并等待。更完整的组合方式——带条件检查、计数器限制、多个 BotMgr 分组——都写在example.py里照抄即可。容易踩的坑消息发不出去先核对 Webhook 地址。构造Bot时会用正则断言 URL 必须以https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key开头key 复制少了半个字符就直接断言失败重新从机器人设置页完整复制一遍。脚本跑通了群里没反应确认运行脚本的机器能访问企业微信 API 域名 qyapi.weixin.qq.com办公网出口受限的服务器经常要配代理。另外接口返回非 200 时框架只写日志、不抛异常排查时记得看日志输出。了人却没生效Markdown 类型消息不支持 这是企业微信平台的限制框架会在日志里打 warning。需要 就把type换回默认的 text。字段和接口的完整规范以企业微信开发者文档为准。想读源码或参与贡献仓库地址是 https://gitcode.com/gh_mirrors/we/we-work-bot git clone 下来直接看遇到 bug 或想提功能提交 issue 或 pull request 都行CLI 支持这类规划中的功能也可以认领。【免费下载链接】we-work-botA lite framework for wechat work bot. 轻量级企业微信群聊机器人框架。项目地址: https://gitcode.com/gh_mirrors/we/we-work-bot创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考