Install
openclaw plugins install clawhub:openclaw-zhfixopenclaw-zhfix
Created by Riya Verma (@iriyaverma)
Translate Chinese LLM error messages to English and get actionable solutions. Supports DeepSeek, Qwen, Kimi, GLM, Baichuan, Yi, and generic Chinese API errors.
Why This Exists
Chinese LLM providers (DeepSeek, Qwen, Kimi, etc.) often return error messages in Chinese. If you don't read Chinese, you're stuck copying errors into Google Translate and guessing what went wrong. This plugin solves that instantly — paste the error, get the English translation and step-by-step fixes.
Install
openclaw plugins install clawhub:openclaw-zhfix
No API keys or config needed. Works out of the box.
Agent Tools
| Tool | Description |
|---|---|
zh_translate | Translate a Chinese error message and get solutions |
zh_explain | Parse a full error log/stack trace, extract and translate all Chinese parts |
zh_errors | Browse all known error patterns by provider or category |
zh_providers | List supported providers and error coverage |
Examples
Talk to the agent naturally:
- "What does this error mean: 认证失败，请检查API密钥"
- "Translate this DeepSeek error: 请求过于频繁，请稍后再试"
- "I got this from Qwen: 触发流量控制 — what should I do?"
- "Parse this error log: [paste full stack trace with Chinese]"
- "Show me all known DeepSeek errors"
- "What auth errors can happen with Chinese LLMs?"
Supported Providers
| Provider | Known Errors | Common Issues |
|---|---|---|
| DeepSeek | 7 | auth, rate-limit, billing, content, server, input, model |
| Qwen (Alibaba) | 5 | auth, rate-limit, input, content, server |
| Kimi (Moonshot) | 2 | auth, input |
| GLM (Zhipu AI) | 2 | auth, config |
| Baichuan | 1 | billing |
| Yi (01.AI) | 1 | auth |
| Generic | 7 | network, server, config, rate-limit — matches any provider |
Total: 25 error patterns with translations and solutions.
Error Categories
| Category | What It Means |
|---|---|
| auth | API key / authentication issues |
| rate-limit | Too many requests |
| billing | Account balance / quota |
| content | Safety filter / content policy |
| server | Provider-side errors, overload, maintenance |
| input | Token limits, context overflow |
| model | Model not found / deprecated |
| network | Connection timeout, DNS |
| config | Bad parameters, region restrictions |
Auto-Detection
The plugin also registers an after_tool_call hook that automatically detects Chinese text in error responses from any tool. When it finds a known error pattern, it appends the English translation and top solution inline.
CLI
openclaw zhfix providers # list supported providers
openclaw zhfix errors # list all known errors
openclaw zhfix errors -p deepseek # filter by provider
openclaw zhfix categories # list error categories
Contributing Errors
Found a Chinese LLM error that's not in the database? Open an issue or PR at github.com/iriyaverma/openclaw-zhfix with:
- The original Chinese error message
- Which provider it came from
- What it means / what fixed it
License
MIT