A high-fidelity linguistic layer for Openclaw Skills that enables AI agents to read, write, and process Persian with native-level technical and cultural accuracy.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install persian-language
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 persian-language 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 Persian Language?
The Persian Language skill is a specialized capability layer designed to solve the common pitfalls AI models face when handling Farsi. Rather than acting as a simple translation tool, this Openclaw Skills module enforces strict technical standards, including correct Persian Unicode usage (replacing Arabic characters like kaf and ya), zero-width non-joiners (half-spaces), and proper right-to-left (RTL) text flow.
This skill ensures that your AI agent communicates with native-level fluency by respecting the complex social nuances of Ta'arof and providing accurate Solar Hijri date conversions. It acts as a quality multiplier for developers and businesses building localized experiences, ensuring that every output—from formal reports to social media captions—feels authentic and professional.
Persian Language Use Cases
- Localizing English software documentation and technical manuals into natural Persian.
- Drafting formal business correspondence using appropriate honorifics and registers.
- Generating culturally aware social media content with correct Persian punctuation and digits.
- Converting Gregorian dates to the Solar Hijri calendar for Iranian administrative tasks.
- Managing right-to-left text formatting in mixed-language code comments and technical documentation.
How Persian Language Works
- The agent identifies Persian script or Farsi-specific triggers within a task or provided data.
- The skill applies a Unicode correction layer to ensure native Persian characters are used instead of Arabic look-alikes.
- Zero-width non-joiners (half-spaces) are programmatically inserted into compound words to maintain grammatical and aesthetic integrity.
- The system analyzes the context to select between formal (Rasmi) or colloquial (Mohaverei) registers.
- Cultural processing logic handles formulaic politeness (Ta'arof) and localizes numeric separators and date systems.
- A final formatting check ensures RTL layouts remain stable, even when Latin fragments or code blocks are embedded in the text.
Persian Language Setup
To deploy this skill within your environment, ensure you have the Openclaw CLI installed and then add the Persian Language capability to your active agent profile.
# Add the Persian Language skill to your project
openclaw install persian-language
# Verify the installation and documentation
openclaw info persian-language
Persian Language Data Schema & Taxonomy
The skill relies on a structured hierarchy of reference files to maintain high output standards:
| File | Category | Technical Focus |
|---|---|---|
writing-standards.md |
Formatting | Unicode normalization, RTL, and half-space rules. |
numerals.md |
Data | Solar Hijri dates, Persian digits, and numeric separators. |
tone-register.md |
Linguistics | Honorifics, Ta'arof logic, and formal/informal branching. |
common-mistakes.md |
Quality Control | Correction patterns for common AI-generated Persian errors. |
content-templates.md |
Templates | Pre-structured layouts for emails, reports, and social media. |
Persian Language Advanced Features
- Intelligent register matching that automatically adjusts tone based on the recipient's relationship and the document type.
- Native Solar Hijri (Shamsi) calendar support for accurate local date management and scheduling.
- Contextual digit rendering which prioritizes Persian digits for prose while retaining Western digits for technical IDs and code.
- Advanced RTL management that prevents punctuation and LTR fragments from breaking the visual flow of Persian sentences.
- Built-in Ta'arof detection to help agents interpret cultural nuances that should not be translated literally.
SKILL.md
Loading
Related Openclaw Skills
Mini Trip
A sophisticated travel orchestration agent that generates complete 3-day, 2-night itineraries with real-time booking capabilities via the flyai CLI.
Private Car & Driver Booking
A specialized AI agent skill for booking private car services and customized day tours with real-time pricing and driver details.
Surfing and Diving Explorer
A specialized travel assistant for discovering surfing, diving, and snorkeling locations with real-time booking and wave data.
Road Trip Planner
A high-performance CLI-based skill for planning comprehensive self-driving road trips with real-time booking data and multi-modal travel support.
Content Decoder Pro
A sophisticated content analysis tool that deconstructs the underlying logic and psychological triggers of viral social media posts.
Baidu Image Classification
A powerful image recognition skill that enables AI agents to identify general objects, retail products, and environmental scenes with high precision.
Featured*
