前言¶

在 OpenClaw、Cursor 等宿主里，用户一句「给我五注双色球」或「明天早上再出号」，很容易触发通用对话：模型自己编号码、猜开奖时间，或把「定时」当成「立刻出号」。彩票玩法有固定规则，开奖数据也有公共源；若选号、兑奖、期号绑定都交给大模型即兴发挥，既不可靠，也难做本地记账和定时任务。

下面介绍 SkillHub 社区 Skill lotto-agent（坐标 @user_50aae3d0/lotto-agent，当前版本 1.2.0）。它把意图理解留给 Agent，把选号、抓取开奖、兑奖判断和 SQLite 存储交给 Python 脚本，并约定自然语言与时间表达的调度规则。

这是什么¶

lotto-agent 是发布者 user_50aae3d0 在 SkillHub 上架的 ai-agent 类 Skill（来源：community）。SkillHub 页面标注 requires_api_key=false，无需额外 API Key。

定位上，README 写明其为「私人自用的彩票 Agent Skill」，可在 OpenClaw、自定义宿主或命令行下运行。Skill 不承诺中奖、不做预测，随机选号使用 secrets.SystemRandom()，兑奖与报表由规则代码完成。

核心功能¶

根据 SKILL.md 与 README.md，已核实能力如下。

彩种与规则¶

支持 8 个彩种：双色球、大乐透、七星彩、七乐彩、福彩3D、排列三、排列五、快乐8。生成与兑奖规则在 config/rules.json 中维护。

CLI 入口与 13 个 action¶

统一入口：

python scripts/cli.py <action> [options]

自然语言与时间铁律¶

Skill 要求：消息中出现彩票相关词（如双色球、大乐透、选号、开奖、兑奖、报表等）时应调用本 Skill。

两条硬规则写在文档最前：

1. 未来时间词：出现「明天」「周三」「晚上」「X 点」等未来时间表达时，必须走 create_task，不得用 generate 立即出号；仅当用户明确说「现在 / 立刻 / 马上」等才可 generate。
2. 反问优先：日期或时段不完整时，先执行 parse --text "<原文>"；若返回 needs_clarification=true，把 message_text 反问用户，禁止默认填 09:00 或「今天」等值。

推荐流程是先 parse，再按返回的 action 分派到具体命令。

数据、开奖源与推送¶

• 数据库默认路径：~/.openclaw/workspace/lotto-agent-data/lottery.db，可用环境变量 LOTTO_AGENT_DATA_DIR 覆盖。
• 公共开奖数据默认基址：https://raw.githubusercontent.com/wenjinliuu/lottery-data-repo/main/public_data，可用 LOTTERY_PUBLIC_DATA_BASE_URL 覆盖。
• 推送仅支持 OpenClaw CLI（openclaw message send），通过 setup_notify 写入 config/config.json 的 notify 段。

requirements.txt 注明 v2 仅使用 Python 标准库，无第三方运行时依赖。

安装与启用¶

通过 SkillHub 安装 Skill 包¶

SkillHub 页面给出的安装提示为：按 SkillHub 安装文档 安装坐标 @user_50aae3d0/lotto-agent。

在已安装 skillhub CLI 的前提下，安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被识别。文档中的示例：

command -v skillhub && skillhub --version
skillhub install @user_50aae3d0/lotto-agent --dir <skills 目录>

常见路径（摘自安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

未安装 CLI 时，安装文档提供：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

Python 环境与依赖¶

进入 Skill 目录后部署脚本环境：

pip install -r requirements.txt
python scripts/cli.py status

典型用法¶

解析自然语言再执行¶

python scripts/cli.py parse --text "明天早上给我5注双色球"

文档示例：完整时段会映射为 create_task；若只说「明天给我5注大乐透」而无时段，则 needs_clarification=true，需先向用户补问。

立即出号（含立即字样）示例：

python scripts/cli.py generate --lottery ssq --count 5 --text "现在给我5注双色球"

选号、抓取、兑奖与报表¶

python scripts/cli.py generate --lottery dlt --count 5 --multiple 2 --text "给我5注大乐透2倍"
python scripts/cli.py fetch_draw --lottery all --message-text
python scripts/cli.py check_prize --message-text
python scripts/cli.py report --since 7 --message-text
python scripts/cli.py record --lottery dlt --text "01 05 12 18 30 + 02 09" --multiple 2 --additional

定时任务与 cron¶

创建一次性任务示例（文档中的参数形态）：

python scripts/cli.py create_task --task-action generate --schedule-kind once --schedule-spec 2026-05-15 --time-start 07:00 --time-end 12:00 --random-window --params '{"lottery":"ssq","count":5}'

服务器侧建议每 30 分钟唤醒一次（路径需按实际 Skill 安装位置修改）：

*/30 * * * * cd /root/.openclaw/workspace/skills/lotto-agent && python3 scripts/cli.py cron_run --push

消息输出格式¶

generate / record 应分两条消息：第一条仅号码块；第二条再发 followup_messages 中的提示。号码块格式在 SKILL.md 中有固定模板（彩种、注数、倍数、开奖日、投入与号码行）。

适用场景与注意¶

适合谁：需要在 Agent 对话里管理个人彩票记录——随机选号、拉公共开奖、规则兑奖、周报/月报盈亏、定时出号或开奖后自动兑奖——且愿意用本地 SQLite 存票的用户。宿主侧需能执行 python scripts/cli.py 并遵守 Skill 中的触发与时间规则。

限制与注意：

• 选号不跨注重、不做冷热号或「提高中奖率」类优化；文档明确拒绝必中、稳赚等表述。
• 公共开奖仓库可能在开奖前出现占位数据，next_buy_end_time 比 next_issue 更可信；兑奖日判断需按文档使用 draws 表与日历逻辑，避免误用 next_fallback。
• 推送依赖 OpenClaw CLI，且只允许 PATH 中的 openclaw，不可自定义可执行路径。
• SkillHub 统计（以抓取资料为准）：评分 100000，下载 909，分类 ai-agent；安装后仍需自行配置 cron、数据目录与通知渠道。

结尾¶

lotto-agent 把彩票相关对话收敛到一套可复现的 CLI 与 SQLite 数据流：Agent 负责听懂人话和展示结果，Python 负责规则与数据。若你在 SkillHub 检索 ai-agent 类工具，可按官方坐标安装并在 Cursor 等环境的 skills 目录启用。

• SkillHub 页面：https://www.skillhub.cn/skills/user_50aae3d0/lotto-agent
• API 坐标页：https://api.skillhub.cn/user_50aae3d0/lotto-agent
• 安装说明：https://skillhub.cn/install/skillhub.md