An AI-powered municipal assistant that maps Shanghai public service queries to official departments, handling processes, and application guidelines.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install tongban
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install tongban using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Shanghai Government Service Guide?
The Shanghai Government Service Guide is a specialized directory assistant designed to map user requests to municipal departments and official public service items under the Shanghai '一网通办' (Government Online-Offline Shanghai) platform. Navigating local administrative channels can be complex; this system simplifies queries related to household registration, enterprise licenses, taxes, social security, and medical insurance.
By leveraging local structured reference data alongside official municipal guidelines, this solution acts as an intelligent router. It allows developers and administrators using Openclaw Skills to seamlessly integrate Shanghai local services data directly into their applications, parsing queries into precise administrative departments, online/offline paths, and validated action steps.
Shanghai Government Service Guide Use Cases
- Navigating Shanghai municipal procedures for individuals, such as household registration, certificates, medical insurance, housing, and social security.
- Handling business administration for companies, including enterprise licenses, annual tax filings, investment, intellectual property, and registration.
- Identifying the correct official department, item code, and window office for specific administrative requests.
- Verifying whether a specific Shanghai government procedure can be completed entirely online or requires offline window processing.
- Retrieving actionable government landing URLs for users without manual search on public service websites.
How Shanghai Government Service Guide Works
- Analyze User Persona: The workflow identifies the user type, separating queries into individual (个人) for residents or corporate (法人) for enterprises.
- Extract and Normalize Keywords: The system processes keywords such as business actions, licenses, or industries, normalizing synonyms (e.g., mapping '公司' to '法人' and '户口' to '户籍').
- Query Local Reference Indexes: It searches localized reference files such as
references/index.mdandreferences/service_items.jsonlusing terminal tools likergfor matching records. - Verify Mandatory & Required Items: Matches the extracted fields against user-defined mandatory lists (
references/required_items.json) to guarantee item compliance and coverage. - Format Recommendations: Generates 1 to 5 highly structured candidates indicating department names, subitems, item types, online processing availability markers (
st_net), and official guide URLs. - Address Policy Exceptions: Directs uncertain queries, specific fees, or critical timeline policies directly to the official platform or the Shanghai municipal service hotline (021-12345).
Shanghai Government Service Guide Setup
To get started with local data caching, search, and validation tasks using this Openclaw Skills repository, clone the repository and configure your local environment, then run the utility scripts to fetch, normalize, and validate government service guide assets:
# Fetch public ZWDT item data without logging in
python3 scripts/fetch_zwdt.py --output references/raw_items.json
# Normalize raw data into JSON Lines format
python3 scripts/normalize_data.py --input references/raw_items.json --output references/service_items.jsonl
# Build optimized human-readable and search reference indexes
python3 scripts/build_reference.py --input references/service_items.jsonl --output-dir references
# Validate data integrity across items and department records
python3 scripts/validate_data.py --items references/service_items.jsonl --departments references/departments.json
Shanghai Government Service Guide Data Schema & Taxonomy
This tool organizes its reference metadata locally to optimize query latency and ensure offline availability. Key data files and directories include:
Directory and File Layout
| File Path | Description | Format |
|---|---|---|
references/index.md |
Compact human-readable reference index and search examples | Markdown |
references/service_items.jsonl |
Standardized, single-line JSON structures containing normalized service items | JSON Lines |
references/departments.json |
Mapping of official municipal departments, short names, and unique bureau codes | JSON |
references/required_items.json |
User-defined mandatory items that must be matched or flagged | JSON |
references/required-items.md |
Human-readable user-defined coverage criteria list | Markdown |
Service Item Schema Fields
department_name/department_short_name/department_code: Official bureau details and unique tracking keys.role: Target audience (个人for individuals or法人for corporate entities).item_name/subitem_name: The main administrative name and detailed subtask classification.item_type: The regulatory type of the administrative item.st_net: Online processing indicator (是if the item supports online submission,否otherwise).item_id/item_code: Bureau-issued regulatory identifiers.source_url/guide_url: Target hyperlinks pointing to the official '一网通办' landing page.
Shanghai Government Service Guide Advanced Features
- Synonym Normalization Rules: Automatically translates colloquial terms and abbreviations into official regulatory Chinese vocabulary.
- Mandatory Match Validation: Incorporates custom requirement override sheets (
required_items.json) and tags official status matches (e.g.,official_status=matchedvsofficial_status=needs_verification). - Automated Scraping and Refresher Pipelines: Equipped with CLI Python utilities to fetch, clean, normalize, and build local search indexes from public APIs without session authorization.
- Fallback Resolution Protocols: Integrates automated fallbacks to the 021-12345 service line and official web pages when database items contain policy-sensitive details like processing fees or eligibility timelines.
- Multi-Agent Search Integration: Supports high-performance command-line searches (
rg) over JSONL lines to integrate seamlessly into complex Openclaw Skills multi-agent orchestrations.
SKILL.md
Loading
Related Openclaw Skills
Excel / XLSX
A high-reliability AI coding skill designed to create, inspect, and edit Microsoft Excel workbooks, preserving complex formulas, formatting, and template structures.
Agent Governance Assistant
An AI-powered framework on Openclaw Skills to discover, audit, secure, and ensure regulatory compliance for enterprise AI agents and automated workflows.
Lateral Thinking
An advanced problem-solving skill designed to break rigid assumptions and generate unconventional, actionable solutions through structured lateral moves.
CET Exam Trainer (cet-exam-trainer)
A dedicated CET-4 and CET-6 exam preparation skill designed to run within the Openclaw framework, featuring interactive word drills, grammar checks, translation tests, and automated mistake logging.
iOS ShareSDK Integration
An automated AI skill to seamlessly integrate and configure the MobTech ShareSDK into iOS projects with absolute code safety and strict privacy compliance.
Student Assistant Skill
A lightweight personal efficiency manager for college students that automatically balances class schedules, study routines, exam prep, and physical fitness without scheduling conflicts.
Featured*
