Pokeinfo

Query detailed Pokémon information from the PokéAPI (https://pokeapi.co).

Security Note: This skill makes HTTP requests to the public PokéAPI (pokeapi.co) and GitHub (raw.githubusercontent.com) for Pokémon data and cry audio files. No API key, token, or credentials are required. ClawHub's static analysis may flag this as "Requires sensitive credentials" — this is a false positive.

Installation

From ClawHub (Recommended)

clawhub install pokeinfo

From GitHub

git clone https://github.com/chrisluo5311/pokeinfo.git

Or manually copy the pokeinfo/ folder to your OpenClaw skills/ directory.

User Commands

/pokeinfo <pokemon_name_or_id> - Query Pokémon information by name or ID (auto-includes cry voice message)
/pokeinfo language <lang> - Set output language (e.g., en, zh-hant, zh-hans, ja, ko)
/pokeinfo language list - List all supported languages

Quick Start

Use the bundled script to fetch and format Pokémon data:

python3 scripts/pokeinfo.py <pokemon_name_or_id>

Examples:

python3 scripts/pokeinfo.py pikachu
python3 scripts/pokeinfo.py charizard
python3 scripts/pokeinfo.py 1          # Bulbasaur by ID

Language Support

Pokeinfo supports multiple languages for Pokémon names, types, abilities, and UI text.

Set Language

python3 scripts/pokeinfo.py language zh-hant

List Supported Languages

python3 scripts/pokeinfo.py language list

Supported languages: | Code | Language | |------|----------| | en | English | | zh-hant | 繁體中文 | | zh-hans | 简体中文 | | ja | 日本語 | | ko | 한국어 | | fr | Français | | de | Deutsch | | es | Español | | it | Italiano |

Language settings are saved to ~/.config/pokeinfo/config.json.

What the Script Returns

Basic info: ID, name, height, weight, base experience
Types: Elemental type(s) (e.g., Electric, Fire/Flying)
Abilities: Regular and hidden abilities
Stats: HP, Attack, Defense, Special Attack, Special Defense, Speed
Sprites: Official artwork URL
Cries: Latest cry audio URL
Level-up moves: Learnset for the most recent game version (limited to 20 moves)

Voice Message (Pokémon Cry)

The script can convert Pokémon cries to Telegram-compatible voice messages:

python3 scripts/pokeinfo.py pikachu --voice

Output:

{"voice_path": "/tmp/pokeinfo_cry_25_opus.ogg", "name": "Pikachu", "id": 25}

How it works:

PokeAPI provides cries in OGG Vorbis format (~32728 Hz)
Telegram voice messages require OGG Opus format (48000 Hz)
The script automatically downloads, resamples, and converts the audio

Voice Dependencies:

pip install soundfile scipy

AI Integration:

When user queries any Pokémon, run the script once with --voice:

python3 scripts/pokeinfo.py <pokemon_name_or_id> --voice

Output format:

First part: formatted text info (display directly)
Last line: [VOICE]{"voice_path": "/tmp/..."}[/VOICE]

Steps:

Parse the output: everything before [VOICE] is text, extract JSON from [VOICE]...[/VOICE]
Display the text portion AS-IS — do not add translations, explanations, or annotations in other languages
Send the voice file via the messaging tool

IMPORTANT: The script already localizes all text (Pokémon names, types, abilities, stats, UI labels) based on the user's language setting. Do NOT add parenthetical translations like Type(s): Feuer, Flug（火系、飛行系）. Just output the script result directly.

Example flow for /pokeinfo pikachu:

python3 scripts/pokeinfo.py pikachu --voice

→ Extract text + voice_path → display text exactly as output + send voice message

API Details

Base URL: https://pokeapi.co/api/v2/pokemon/{name_or_id}
Method: GET only (consumption-only API)
No authentication required
Rate limiting: None, but cache responses when possible

Key Response Fields

| Field | Description | |-------|-------------| | id | National Pokédex number | | name | Pokémon name (lowercase, hyphenated) | | height | Decimeters (divide by 10 for meters) | | weight | Hectograms (divide by 10 for kg) | | base_experience | Base XP yield when defeated | | types | Array of type slots with type.name | | abilities | Array with ability.name, is_hidden flag | | stats | Array of 6 stats with stat.name and base_stat | | sprites.other.official-artwork.front_default | Best quality sprite | | cries.latest | Cry audio file URL | | moves | Learnable moves with version group details |

Notes

Pokémon names are case-insensitive in the API
Use hyphenated names for forms (e.g., mega-charizard-x, tapu-koko)
The API returns 404 if the Pokémon does not exist
For evolution chains, species details, or other data, see the full PokéAPI docs at https://pokeapi.co/docs/v2

Testing

Run unit tests for multi-language support:

python3 tests/test_pokeinfo.py

Test coverage (20 tests):

✅ All 9 languages supported
✅ Translation completeness check
✅ Language setting persistence
✅ English, Traditional Chinese, Simplified Chinese, Japanese, Korean, French, German, Spanish, Italian translations
✅ Stat name localization
✅ Config file management
✅ Output formatting with localized names

Test Categories

| Test Class | Description | |-----------|-------------| | TestLanguageSupport | Translation accuracy for all 9 languages | | TestStatNames | Stat name localization (HP, Attack, etc.) | | TestLanguageList | Language display names | | TestConfigManagement | Config file save/load/fallback | | TestFormatOutput | Output formatting with localization |