An Openclaw Skills wrapper for TianAPI that translates OBD fault codes into bilingual, technician-friendly diagnostics from the command line.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install tianapi-obdcode
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 tianapi-obdcode 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 TianAPI OBD Fault Code Lookup?
This Openclaw Skills integration wraps TianAPI's OBD fault-code endpoint so you can turn codes like P0101 or P267B into practical diagnostics in seconds. It returns the code, Chinese and English meanings, applicable vehicle scope, fault category, and a detailed description in a consistent, script-friendly format.
Built for developers, mechanics, and support workflows, Openclaw Skills makes OBD lookup fast, repeatable, and easy to embed in terminal tools, service assistants, and maintenance automations. Instead of maintaining a local fault-code database, you query a maintained API and get standardized results on demand.
TianAPI OBD Fault Code Lookup Use Cases
- Diagnose a dashboard check-engine code from a customer or vehicle scan tool.
- Translate OBD codes into Chinese and English for multilingual support teams.
- Add fault-code lookup to a CLI utility, chat assistant, or internal service tool.
- Enrich fleet maintenance workflows with code category and vehicle-scope context.
- Quickly confirm whether a code is generic or associated with a specific fault area.
- Provide repair-oriented explanations during technician triage.
How TianAPI OBD Fault Code Lookup Works
- The user provides an OBD trouble code such as P0101 or P267B.
- The skill resolves the TianAPI API key from an environment variable, a local .env file, or a one-off command-line argument.
scripts/fetch_obdcode.pysends a request tohttps://apis.tianapi.com/obdcode/indexwithkeyandcodeparameters, or you can call the REST endpoint directly.- The API returns structured diagnostic data, including the fault code, bilingual meanings, vehicle applicability, category, and detailed description.
- The workflow renders the result for the terminal and handles documented error states such as missing parameters, invalid keys, quota limits, empty results, and timeouts.
TianAPI OBD Fault Code Lookup Setup
- Register for a TianAPI account and apply for the OBD code lookup API.
- Copy your API key from the TianAPI dashboard.
- Make sure Python 3 is installed, since this Openclaw Skills package requires
python3. - Choose one of the supported key-loading methods.
# Option 1: export an environment variable
export TIANAPI_OBDCODE_KEY=your_api_key
# Option 2: create a local .env file for scripts
mkdir -p scripts
echo 'TIANAPI_OBDCODE_KEY=your_api_key' > scripts/.env
# Option 3: pass the key at runtime
python3 scripts/fetch_obdcode.py your_api_key --code P267B
- Test the lookup with a known code.
python3 scripts/fetch_obdcode.py your_api_key --code P267B
- If you do not want to use the helper script, call the API endpoint directly.
curl 'https://apis.tianapi.com/obdcode/index?key=YOUR_API_KEY&code=P267B'
TianAPI OBD Fault Code Lookup Data Schema & Taxonomy
The skill is intentionally lightweight: it does not require a local database and does not generate persistent artifacts by default. The core inputs and outputs are organized as follows.
| Layer | Field / File | Purpose |
|---|---|---|
| Config | TIANAPI_OBDCODE_KEY |
Primary environment variable for the TianAPI key |
| Config | scripts/.env |
Optional local file for storing the API key during script execution |
| Input | code |
Required OBD fault code to query, such as P267B |
| Input | key |
Required TianAPI credential passed via env, file, or CLI |
| Endpoint | https://apis.tianapi.com/obdcode/index |
REST lookup endpoint used by the script or direct calls |
| Script | scripts/fetch_obdcode.py |
CLI wrapper that packages the fault-code lookup flow |
| Output | stdout | Human-readable diagnostic result for terminal use or piping |
Response taxonomy
| Field | Meaning |
|---|---|
code |
Fault code identifier |
descr |
Detailed fault description |
ennote |
English meaning of the code |
zhnote |
Chinese meaning of the code |
carmodel |
Applicable vehicle scope |
category |
Fault category or system area |
Error taxonomy
| Status | Meaning |
|---|---|
150 |
API quota exhausted |
160 |
API not yet applied for |
230 |
Invalid API key |
240 |
Missing key parameter |
250 |
Empty response data |
280 |
Missing code parameter |
| Timeout | Network issue; retry the request |
Openclaw metadata contract
| Metadata key | Value | Purpose |
|---|---|---|
metadata.openclaw.emoji |
🚙 |
Visual identifier for the skill |
metadata.openclaw.requires.bins |
python3 |
Runtime requirement |
metadata.openclaw.requires.env |
TIANAPI_OBDCODE_KEY |
Required environment variable |
metadata.openclaw.primaryEnv |
TIANAPI_OBDCODE_KEY |
Primary credential source |
For Openclaw Skills consumers, the most important contract is stable field names and deterministic CLI behavior, which makes the output easy to parse in automation.
TianAPI OBD Fault Code Lookup Advanced Features
- Three credential injection options: environment variable, local
.envfile, or per-command key argument. - Direct REST endpoint support plus reusable
scripts/fetch_obdcode.pyexecution. - Structured bilingual diagnostics that make Openclaw Skills useful for both English- and Chinese-language workflows.
- Documented error handling for quota, auth, missing-parameter, empty-data, and timeout scenarios.
- Lightweight Python 3 footprint with no local fault-code database to maintain.
- Easy to embed in fleet tools, service desks, chatbot assistants, and CI-style validation scripts.
SKILL.md
Loading
Related Openclaw Skills
TianAPI Barcode Lookup
Openclaw Skills for TianAPI barcode lookup converts a product barcode into structured product metadata in seconds.
Huawei Cloud OBS Upload
Openclaw Skills for Huawei Cloud OBS lets you safely list buckets, upload files or directories, and automate periodic syncs from the CLI.
Huawei Cloud Resource Query
A read-only Huawei Cloud resource query skill in Openclaw Skills for inspecting EVS, OBS, SFS Turbo, and CBR data via local Python scripts.
Mobile Responsive Layout Fixer
A frontend troubleshooting skill in Openclaw Skills for diagnosing and fixing mobile responsiveness, navigation, and cross-device layout issues.
TianAPI Vehicle Limit Lookup
An Openclaw Skills integration that fetches city vehicle restriction rules, tail-number limits, zones, and penalty details from TianAPI.
TianAPI Ancient Books Lookup
Openclaw Skills for querying ancient Chinese classic chapters by ID through TianAPI, with script and direct HTTP access.
Featured*
