作者:西楚极客。想让 AI 像员工一样在群里接活、汇报进度、做完自己质检?这篇给你一套能直接跑的开源模板:在自己的 Windows 电脑上跑一个小调度器,你在 Telegram 私人群里 @ 机器人说需求,项目经理(Claude Code)派活和质检,员工(Codex)动手。用的是 Claude 和 ChatGPT 的订阅,不需要额外买 API,也不需要公网服务器。
本期资料
- 开源模板(MIT):https://github.com/xichugeek/xichu-agent-team
- 本期固定版本 98548e5:https://github.com/xichugeek/xichu-agent-team/tree/98548e5
- 给 Claude Code 的需求说明(改成你自己的岗位):docs/给ClaudeCode的需求说明.md
打不开 GitHub 的话,在仓库页面 Code → Download ZIP 下载即可;本文下方也附了需求说明全文。
它是什么,不是什么
- 是:一个跑在你电脑上的 Python 小程序(只用标准库),收 Telegram 群消息,按你点名的机器人,把活交给本机的 Claude Code 或 Codex,结果回复在你那条消息下面。
- 不是:云端 SaaS,也不是按量付费的 API 方案,不会替你发布、上传、付款或删除东西。
- 视频里我自己的“视频制作”和“官网运维”是频道专用岗位,不在模板里;模板给的是两个通用岗位:写手、程序员。
三个机器人与三条底线
| 岗位 | 执行器 | 职责 |
|---|---|---|
| 项目经理 | Claude Code | 理解需求、派给谁(拿不准只问你一个问题);员工交付后独立质检,不合格退回返工一轮 |
| 写手 | Codex | 写文档、文章、周报、方案等文字草稿 |
| 程序员 | Codex | 在你指定的项目目录里写代码、改 bug、跑测试(不提交、不推送) |
- 只听你一个人,只在这个群里:私聊、别的群、别人、编辑过的消息一律不执行。
- 只用订阅登录:启动前去掉
OPENAI_API_KEY、ANTHROPIC_API_KEY等环境变量,并检查是不是订阅登录,不是就拒绝执行。 - 默认只在本地出草稿:产物写在
runtime\work\;发布要你自己点头。
准备
- Windows 电脑,安装 Python 3.10 或更新版本(安装时勾选 “Add python.exe to PATH”)。
- Claude 付费订阅,安装 Claude Code,终端运行
claude,用/login登录订阅账号。 - ChatGPT 付费订阅,安装 Codex CLI,运行
codex login用 ChatGPT 账号登录。 - 终端里
claude --version、codex --version都能输出版本号。 - 一个 Telegram 账号。
搭建步骤
第一步:下载模板
从 GitHub 下载 ZIP(Code → Download ZIP),解压到一个不含中文和空格的目录,例如 D:\AI\xichu-agent-team。
第二步:建机器人和群
- Telegram 搜索 @BotFather,发
/newbot,起名,拿到 token。token 相当于机器人的密码,不要发给别人、不要截图外传。 - 一共建三个:项目经理、写手、程序员。
- 双击
first_setup.bat,在打开的记事本里把三个 token 分别粘到pm、writer、coder后面,保存。 - 新建一个只有你自己的群,把三个机器人拉进来。
- 项目经理必须关闭隐私模式:BotFather 发
/setprivacy→ 选项目经理 →Disable,然后把项目经理移出群再拉回来才生效。不关的话你在群里 @ 它,它收不到。 - 三个机器人都关掉“可被拉进其他群”:BotFather 发
/setjoingroups→ 选机器人 →Disable。
第三步:填用户 ID 和群 ID
- 在群里随便发一句话。
- 双击
discover.bat,它列出chat_id(群,负数)和from_id(你)。 - 打开
config.json,owner_user_id填from_id,group_chat_id填群的chat_id。
第四步:自检和启动
- 双击
doctor.bat:检查三个机器人在不在群里、项目经理隐私模式、Claude Code 和 Codex 是不是订阅登录。全部 OK 再继续。 - 双击
start_agent.bat:启动调度器,窗口别关。 stop_agent.bat正常停止;run_tests.bat跑自动化测试(不联网、不调用模型)。
群里怎么用
@项目经理 需求 由项目经理判断派给谁(不清楚会先问你) @写手 需求 / @程序员 需求 直接派给该员工,做完由项目经理质检 /writer 需求 /coder 需求 /pm 需求 同上,命令写法 /review 内容 只让项目经理做一次质检 /status [T-0001] /retry T-0001 /cancel T-0001 /help
员工每完成一步写一行进度,调度器每 2 分钟把新进度转发到群里;失败时群里直接告诉你原因和工作目录,修好后 /retry。
我的团队实测(视频第 6 段)
我在群里让项目经理用合成素材做一条 5 秒测试视频:项目经理十几秒拆好需求交给视频制作;视频制作边做边在群里汇报进度,不到两分钟出片;项目经理抽开头、中间、结尾三帧真看画面后给结论,质检通过;我回复发布链接,它先检查视频是否真的公开,再由官网运维准备好文章草稿——只出草稿,正式上线还是我自己确认。
换成你自己的岗位
想要客服、写周报、盯服务器之类的岗位:改 config.json 的 roles,在 prompts\ 里写对应提示词;或者在模板目录里运行 Claude Code,把下面这段发给它(把【】换成你自己的):
我想在自己的 Windows 电脑上搭一个“AI 员工团队”,在 Telegram 私人群里派活。请在当前目录的模板基础上帮我改成我自己的岗位(没有模板就从头写): 1. 群里有 3 个机器人:项目经理(Claude Code)、【岗位 1】(Codex)、【岗位 2】(Codex)。 - 【岗位 1】负责:【写清楚它做什么、交付什么、放在哪个目录】 - 【岗位 2】负责:【同上】 2. 我在群里 @项目经理 说需求,它判断派给谁,不清楚就只问我一个问题;@某个员工就直接交给它。 3. 员工做完后,项目经理做一次独立质检,不合格退回返工一轮,结果回复在我原来那条消息下面。 4. 只认我本人(Telegram 用户 ID)在这个群里的消息;私聊、别的群、别人一律不执行。 5. 只用 Claude Code 和 Codex 的订阅登录,启动子进程前去掉 OPENAI_API_KEY、ANTHROPIC_API_KEY,不是订阅登录就拒绝执行。 6. 默认只写本地工作目录;发布、上传、付款、删除、改服务器之类的操作一律不做,交给我自己确认。 7. 工单存本地 SQLite,重启后能接着做;同一条消息不重复执行;额度受限时排队并告诉我大约几点恢复。 8. 提供 doctor 自检、启动/停止脚本和自动化测试,测试全部通过后告诉我怎么配置 Telegram 机器人。
常见坑
| 现象 | 原因和处理 |
|---|---|
| @项目经理 没反应 | 没关隐私模式,或关了没移出群再拉回。doctor.bat 会提示。 |
| 任务停在第一步、提示额度用完 | 订阅额度(比如 Claude 5 小时额度)用完。模板会让该执行器冷却、工单排队,并在群里告诉你大约几点恢复。 |
| doctor 提示不是订阅登录 | 电脑里设过 API Key 环境变量,或 Claude Code / Codex 用 API Key 登录了。改成订阅账号登录。 |
| Codex 报只读、拒绝执行命令 | Windows 沙盒要设成 elevated(config.json 已默认设好)。 |
| 群升级成超级群后没反应 | 群 ID 变了,重新运行 discover.bat 填回 config.json。 |
限制:需要电脑开着、调度器窗口开着,电脑睡眠时不会接单;订阅有额度,重活多时会排队等恢复;模板只做本地草稿,涉及发布和花钱的事永远留给你自己。
视频章节
- 00:00 我的 AI 团队长什么样
- 00:35 原理:调度器、三个机器人、三条底线
- 01:34 需要准备什么
- 01:52 下载开源模板,改成自己的岗位
- 02:16 建机器人、建群、关隐私模式、填 ID
- 03:11 doctor 自检和启动
- 03:29 实录:派一单,从制作、质检到官网草稿
- 04:25 三个坑:隐私模式、订阅额度、API Key 环境变量
- 05:07 资料在哪
视频文稿
以下为本期公开口播原文。
展开完整视频文稿
00:00 我的 AI 团队长什么样
这是我的 AI 团队。我在 Telegram 群里发一句话,项目经理接单,视频制作自己开工、汇报进度,做完项目经理质检,视频发出去以后,官网运维接着把官网文章草稿准备好。
这一整套是 Claude 帮我写的,跑在我自己的电脑上,用的是 Claude 和 ChatGPT 的订阅,不用额外买 API。这期带你搭一个你自己的,模板已经开源,链接在视频说明里。
00:35 原理:调度器、三个机器人、三条底线
原理不复杂。你在群里发消息,电脑上跑着一个小程序,叫调度器。它收到消息,看你点名的是谁,把活交给本机的 Claude Code 或者 Codex 去做,做完把结果回复到你那条消息下面。
群里有三个机器人。项目经理是 Claude,负责理解需求、派给谁,最后质检;另外两个员工是 Codex,负责真正动手。
三条底线:只听你一个人、只在这个群里;只用订阅登录,不会偷偷按量扣费;默认只在本地出草稿,发布要你自己点头。
说明一下:我的视频制作和官网运维是频道专用的,不放出来。模板里给的是两个通用岗位:写手和程序员,你换成自己的活就行。
01:34 需要准备什么
你需要准备这些:一台 Windows 电脑,装好 Python;Claude 和 ChatGPT 各有一个付费订阅,并且装好 Claude Code 和 Codex,都用订阅账号登录;再有一个 Telegram 账号。
01:52 下载开源模板,改成自己的岗位
最快的办法是直接用我的开源模板,从 GitHub 下载,或者用说明里的网盘备份,解压就行。
如果你想要不一样的岗位,比如客服、写周报、盯服务器,就把文章里那段需求说明发给 Claude Code,让它在模板基础上帮你改。
02:16 建机器人、建群、关隐私模式、填 ID
第一步,找 BotFather 建机器人。发 newbot,起个名字,它会给你一串 token。这串 token 相当于机器人的密码,千万别发给别人。
一共建三个。双击 first_setup,把三个 token 粘进去保存。
然后新建一个只有你自己的群,把三个机器人拉进来。
这一步是我踩过的坑:项目经理一定要关掉隐私模式。不关的话,你在群里点名它,它根本收不到。关完要把它移出群再拉回来,才会生效。
在群里随便发一句话,再双击 discover,就能看到你的用户 ID 和群 ID,填进 config 文件。这样它只听你一个人的。
03:11 doctor 自检和启动
双击 doctor 自检,三个机器人在不在群里、隐私模式对不对、Claude 和 Codex 是不是订阅登录,全是 OK 再双击 start 启动,窗口别关。
03:29 实录:派一单,从制作、质检到官网草稿
来看我的团队真实跑一单。我让项目经理用合成素材做一条五秒的测试视频。
十几秒,项目经理就拆好了需求,交给视频制作。视频制作一边做,一边在群里汇报进度。
不到两分钟,片子做好了,就是这条。
做完以后,项目经理抽出开头、中间、结尾三帧画面,真的看一遍再给结论。这次质检通过。
我把发布链接回复给它,它先检查视频是不是真的公开了,然后官网运维把文章草稿准备好。
这就是它生成的官网文章草稿。注意,它只出草稿,不会自己上线,正式发布还是我自己看过、点头才行。
04:25 三个坑:隐私模式、订阅额度、API Key 环境变量
最后说几个坑。第一个刚才讲了,项目经理的隐私模式。
第二个,订阅额度。你看这里,Claude 五小时的额度用完了,任务就停在第一步。模板遇到额度用完,会排队等,并在群里告诉你大约几点恢复,额度回来再接着做。
第三个,如果你电脑里设过 API Key 的环境变量,Claude Code 或者 Codex 可能就不走订阅,改成按量扣费了。模板启动它们之前会把这些变量去掉,并检查是不是订阅登录。
05:07 资料在哪
模板、需求说明和全部步骤,都在说明栏和官网文章里。这里是西楚极客,我们继续用 AI,把真正能运行的项目做出来。下期见。
你最想让 AI 员工替你干什么活?欢迎到视频评论区告诉我。
上期回顾 · 让Muse帮你申请免费云电脑和GPU|两条指令,四平台实测 · 全部教程 →