A specialized skill for AI agents to perform high-quality PDF translations using the pdf2zh-next engine with support for multiple LLM providers.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install pdf2zh-translator
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 pdf2zh-translator 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 PDF Translator (pdf2zh-next)?
The translator-pdf2zh skill provides a robust interface for AI coding agents to handle complex PDF translation tasks. By wrapping the powerful pdf2zh-next engine into a unified execution pipeline, it allows for seamless document localization while preserving original layout and formatting. This addition to the Openclaw Skills library is designed with security in mind, enforcing strict path boundaries and isolated execution environments to protect the host system.
This skill is particularly effective for developers and researchers who need to process large volumes of technical documentation. It offers flexible provider management, allowing users to switch between services like OpenAI, DeepSeek, and SiliconFlow through a centralized configuration file without altering global system settings.
PDF Translator (pdf2zh-next) Use Cases
- Translating complex technical whitepapers and research documents while maintaining layout integrity.
- Batch processing multiple PDF files within a directory using glob pattern matching.
- Automating the translation of documentation folders for international software projects.
- Comparing translation quality across different AI providers such as DeepSeek or OpenAI.
How PDF Translator (pdf2zh-next) Works
- The AI agent receives a request to translate one or more PDF documents based on a file path, directory, or glob pattern.
- The skill script performs a security check to ensure it only accesses authorized configuration files within the skills directory.
- Based on the provided arguments, the script identifies whether to use a specific AI provider or fall back to the default config.toml settings.
- The pdf2zh-next core engine is triggered to parse the PDF, extract text, and send it to the chosen LLM for translation.
- Parallel workers process multiple pages or files simultaneously to increase throughput.
- The translated document is generated in the output directory, and the agent monitors the real-time progress via a status monitor.
PDF Translator (pdf2zh-next) Setup
To utilize this skill within your environment, ensure you have the necessary dependencies installed for pdf2zh-next. Configuration is handled through a local TOML file. Run the pipeline using the following command structure:
python skills/translator-pdf2zh/scripts/run_pdf2zh_pipeline.py \
--input-file "path/to/document.pdf" \
--output-dir "./output" \
--config-path "skills/translator-pdf2zh/config.toml" \
--workers 2
PDF Translator (pdf2zh-next) Data Schema & Taxonomy
The skill manages data through specific input parameters and a structured configuration file:
| Feature | Description |
|---|---|
| Config File | skills/translator-pdf2zh/config.toml contains API keys and provider-specific settings. |
| Input Methods | Supports --input-file, --input-dir, and --include-glob for flexible file targeting. |
| Output | Translated files are saved to the path specified by --output-dir. |
| Provider Logic | Maps provider names (e.g., openai, deepseek) to their respective API endpoints and parameters. |
PDF Translator (pdf2zh-next) Advanced Features
- Multi-worker support to enable parallel translation of documents for faster processing.
- Real-time progress monitoring to track the status of long-running translation tasks.
- Provider validation that ensures the chosen AI service is correctly configured in the local environment.
- Strict security isolation that prevents the skill from modifying global system configurations or accessing unauthorized agent settings.
- Seamless integration with Openclaw Skills allowing agents to autonomously determine the best parameters using built-in help functions.
SKILL.md
Loading
Related Openclaw Skills
Codacy
An automated code analytics integration to monitor quality, identify bugs, and enforce standards across your repositories.
OpenClaw Meta Ads
A production-safe Meta Ads skill for OpenClaw agents to analyze, report, and optimize Facebook and Instagram ad accounts through a read-first workflow.
Wenxuecity News Rankings
A specialized tool for fetching and structuring the top 24-hour trending news rankings from Wenxuecity into Markdown or JSON formats.
Miro CLI
A powerful CLI wrapper for the Miro Platform API, enabling seamless board management, team organization, and automated data exports directly from your terminal.
China Tax Law Knowledge Assistant
A specialized professional assistant for navigating the complexities of Chinese tax regulations, compliance, and strategic planning.
WeChat Publisher
Automate the conversion and uploading of Markdown documents to your WeChat Official Account draft box with seamless image handling.
Featured*
