12306 Remaining Ticket Query + Queue Booking: I Used OpenClaw to Automate Train Ticket Grabbing

Using OpenClaw's 12306-train-assistant skill to implement fully automated remaining ticket queries, queue booking, and ticketing notifications — secure, private, and more flexible than third-party ticket-grabbing apps.

What This Skill Does

The 12306-train-assistant skill connects to China's official 12306 railway booking system to:

Query remaining tickets: Check availability for specific trains and dates
Monitor ticket availability: Set alerts for when tickets become available
Join queue booking: Automatically submit to the official queue system when tickets appear
Receive notifications: Get Telegram/Discord alerts on booking status changes

Installation

clawhub install 12306-train-assistant

Configure your 12306 account credentials in OpenClaw settings. The skill uses official 12306 APIs — no unauthorized scraping.

Why Use This vs. Third-Party Apps?

Third-party ticket-grabbing apps require you to input your 12306 credentials into their servers — a significant security risk. This skill runs locally in OpenClaw and your credentials never leave your machine.

Additionally, you can set custom rules: specific seat types, carriage preferences, acceptable alternative trains, notification timing. More granular control than app-based solutions.

Real Usage

# Query availability
Check remaining tickets for G123 Beijing → Shanghai on 2026-05-01

# Set up automatic monitoring
Monitor G123 and G125 Beijing → Shanghai on 2026-05-01 for second class seats.
Alert me when available, and automatically submit queue booking.

# Status check
What's the status of my current queue booking for the May 1st trip?

Pitfalls

12306 account security: Enable 2FA on your 12306 account. The skill will handle the regular auth flow, but 2FA requires a one-time manual setup.

Queue system rules: 12306's official queue system has rules about how many trains you can queue for simultaneously. The skill respects these limits.

Popular routes at peak times: For Spring Festival or Golden Week travel, expect high competition. The skill helps, but can't guarantee tickets for extremely popular routes.

API rate limits: Don't query too frequently — it can trigger 12306's anti-bot measures. The skill has sensible defaults, but avoid running manual rapid queries.

Summary

For anyone who regularly books Chinese train tickets, this skill is a significant quality-of-life improvement. It's more secure than third-party apps (credentials stay local), more flexible (custom rules), and integrates with your OpenClaw notification setup.

SFD Lab | 12306-train-assistant practical notes