{"id":"9c0df9a3-cae8-498f-894c-bb4a491c55e5","entityType":"agent","slug":"clawhub-baidu-translate-baidu-file-translate","name":"Baidu File Translate","canonicalUrl":"https://www.xpersona.co/agent/clawhub-baidu-translate-baidu-file-translate","canonicalPath":"/agent/clawhub-baidu-translate-baidu-file-translate","generatedAt":"2026-10-11T14:16:07.655Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T10:34:48.896Z","emptyReason":null},"description":"Baidu trans-cli file/document translation for 文件翻译、文档翻译、PDF/Word/Excel/PPT/TXT/HTML 翻译 while preserving original formatting and layout. Powered by trans-cli... Skill: Baidu File Translate Owner: baidu-translate Summary: Baidu trans-cli file/document translation for 文件翻译、文档翻译、PDF/Word/Excel/PPT/TXT/HTML 翻译 while preserving original formatting and layout. Powered by trans-cli... Tags: latest:1.0.1 Version history: v1.0.1 | 2026-05-28T04:06:32.242Z | user - Improved the skill description for clarity and focus on supported document types and translation use-cases. - Clarified w","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s173pby7qgzc6mnef856135vr983z06v:baidu-file-translate","sourceUrl":"https://clawhub.ai/baidu-translate/baidu-file-translate","homepage":"https://clawhub.ai/baidu-translate/skills/baidu-file-translate","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/baidu-translate/baidu-file-translate","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/baidu-translate/skills/baidu-file-translate","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":61,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Baidu trans-cli file/document translation for 文件翻译、文档翻译、PDF/Word/Excel/PPT/TXT/HTML 翻译 while preserving original formatting and layout. Powered by trans-cli... "},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T10:34:48.896Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T10:34:48.896Z","emptyReason":null},"stars":null,"forks":null,"downloads":1086,"packageName":null,"latestVersion":"1.0.1","tractionLabel":"1.1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T10:34:48.883Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T10:34:48.896Z","lastCrawledAt":"2026-10-11T10:34:48.883Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T10:34:48.883Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.1","createdAt":"2026-05-28T04:06:32.242Z","changelog":"- Improved the skill description for clarity and focus on supported document types and translation use-cases. - Clarified workflow: always confirm with user before downloading the translated file; explicitly report WAIT_TIMEOUT and save request_id for resuming translation. - Added instructions to stop and report immediately for exit 2 (auth/config) errors and WAIT_TIMEOUT. - Updated descriptions to emphasize trigger scenarios (file upload or user request to translate/convert documents). - No changes to code or JSON contracts; documentation and usage guidance improved.","fileCount":3,"zipByteSize":3672},{"version":"1.0.0","createdAt":"2026-05-15T04:33:27.175Z","changelog":"baidu-file-translate 1.0.0 - Initial release for async Baidu file translation via trans-cli. - Implements submit → poll → download workflow for document translation. - Supports error handling for common scenarios (e.g., DOC_FAILED, AUTH_FAILED, WAIT_TIMEOUT). - Lists all accepted file formats: docx, pdf, xlsx, pptx, html, txt, xml, md. - Provides Agent-safe polling and guidance for managing requestId and job state. - Documentation covers command usage, options, JSON output, and troubleshooting.","fileCount":2,"zipByteSize":2292}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s173pby7qgzc6mnef856135vr983z06v:baidu-file-translate","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-baidu-translate-baidu-file-translate/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-baidu-translate-baidu-file-translate/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-baidu-translate-baidu-file-translate/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-baidu-translate-baidu-file-translate/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-baidu-translate-baidu-file-translate/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-baidu-translate-baidu-file-translate/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-11T14:16:07.654Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-baidu-translate-baidu-file-translate/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-baidu-translate-baidu-file-translate/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-baidu-translate-baidu-file-translate/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-baidu-translate-baidu-file-translate/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-11T10:34:48.896Z","emptyReason":null},"readme":"Skill: Baidu File Translate\n\nOwner: baidu-translate\n\nSummary: Baidu trans-cli file/document translation for 文件翻译、文档翻译、PDF/Word/Excel/PPT/TXT/HTML 翻译 while preserving original formatting and layout. Powered by trans-cli...\n\nTags: latest:1.0.1\n\nVersion history:\n\nv1.0.1 | 2026-05-28T04:06:32.242Z | user\n\n- Improved the skill description for clarity and focus on supported document types and translation use-cases.\n- Clarified workflow: always confirm with user before downloading the translated file; explicitly report WAIT_TIMEOUT and save request_id for resuming translation.\n- Added instructions to stop and report immediately for exit 2 (auth/config) errors and WAIT_TIMEOUT.\n- Updated descriptions to emphasize trigger scenarios (file upload or user request to translate/convert documents).\n- No changes to code or JSON contracts; documentation and usage guidance improved.\n\nv1.0.0 | 2026-05-15T04:33:27.175Z | user\n\nbaidu-file-translate 1.0.0\n\n- Initial release for async Baidu file translation via trans-cli.\n- Implements submit → poll → download workflow for document translation.\n- Supports error handling for common scenarios (e.g., DOC_FAILED, AUTH_FAILED, WAIT_TIMEOUT).\n- Lists all accepted file formats: docx, pdf, xlsx, pptx, html, txt, xml, md.\n- Provides Agent-safe polling and guidance for managing requestId and job state.\n- Documentation covers command usage, options, JSON output, and troubleshooting.\n\nArchive index:\n\nArchive v1.0.1: 3 files, 3672 bytes\n\nFiles: skill-card.md (2495b), SKILL.md (4375b), _meta.json (139b)\n\nFile v1.0.1:SKILL.md\n\n---\nname: baidu-file-translate\ndescription: Baidu trans-cli file/document translation for 文件翻译、文档翻译、PDF/Word/Excel/PPT/TXT/HTML 翻译 while preserving original formatting and layout. Powered by trans-cli (Baidu LLM File Translation API). Trigger when the user uploads or references a file and asks to translate it, or asks to convert a document's language.\nhomepage: https://fanyi.baidu.com\nmetadata: '{\"clawdbot\":{\"emoji\":\"📄\",\"requires\":{\"bins\":[\"trans\"],\"env\":[\"TRANS_API_KEY\"]},\"install\":[{\"id\":\"npm\",\"kind\":\"npm\",\"package\":\"@bdtrans/trans-cli\",\"bins\":[\"trans\"],\"label\":\"Install trans-cli (npm)\"}]}}'\n---\n\n# baidu-file-translate — Agent Reference\n\nFile translation is **async**. Always use the submit → poll loop below.\nNever rely on `--wait` without a timeout — it may block indefinitely in an\nAgent framework.\n\n```\nStep 1: trans file submit <file> --from auto --to <lang> --json\n        → exit ≠ 0 → ⚠ STOP if exit 2 (auth/config); handle others (see Error Handling)\n        → exit 0   → record request_id from stdout\n\nStep 2: every 5 s: trans file query <request_id> --json\n        → exit ≠ 0              → handle error; DOC_FAILED = don't retry\n        → exit 0, status=processing → keep polling (set Agent timeout ≤ 10 min)\n        → exit 0, status=done       → ⚠ confirm with user before downloading\n                                       then: trans file query <request_id> --download --output ./\n        → WAIT_TIMEOUT              → ⚠ STOP — save request_id, report to user\n```\n\nSet an Agent-level timeout (e.g. 10 min). On WAIT_TIMEOUT, save the\nrequest_id and report to user — the job is still running and can be resumed later.\n\n---\n\n## trans file submit \\<file\\>\n\n```bash\ntrans file submit report.pdf --from zh --to en --json\ntrans file submit report.pdf --to en --reference \"Use academic tone\"\n```\n\n| Flag | Default | Description |\n|------|---------|-------------|\n| `--from` | auto | Source language (auto-detect) |\n| `--to` | zh | Target language — **`auto` is not accepted** |\n| `--reference` | — | Custom translation instruction, ≤ 1000 Unicode code points |\n| `--trans-image` | false | Also translate text inside images |\n| `--wait` | false | Block until done (always pair with `--wait-timeout`) |\n| `--wait-timeout` | 0 (no limit) | Max wait time for `--wait` mode |\n\n## trans file query \\<requestId\\>\n\n```bash\ntrans file query REQ123 --json\ntrans file query REQ123 --download --output ./output/\n```\n\n| Flag | Default | Description |\n|------|---------|-------------|\n| `--download` | false | Download the translated file when done |\n| `--output` | ./ | Download directory (used with `--download`) |\n| `--wait` | false | Block until done |\n| `--wait-timeout` | 0 (no limit) | Max wait time for `--wait` mode |\n\n---\n\n## JSON Contract\n\n**submit success (stdout):**\n```json\n{\"request_id\": \"REQ123\", \"status\": \"submitted\"}\n```\n\n**query — in progress (stdout):**\n```json\n{\"request_id\": \"REQ123\", \"status\": \"processing\", \"name\": \"report.pdf\", \"from\": \"zh\", \"to\": \"en\"}\n```\n\n**query — done (stdout):**\n```json\n{\"request_id\": \"REQ123\", \"status\": \"done\", \"file_url\": \"https://...\", \"char_count\": 1000, \"amount\": 70}\n```\n\nWith `--download`, the done response gains:\n```json\n{\"local_path\": \"/absolute/path/to/report_en.pdf\"}\n```\n\n**error (stderr, exit ≠ 0):**\n```json\n{\"code\": \"AUTH_FAILED\", \"message\": \"...\", \"help_url\": \"https://fanyi-api.baidu.com/manage/apiKey\"}\n```\n\n`help_url` is omitted when not applicable.\n\n---\n\n## Error Handling\n\n```\nexit ≠ 0\n├── CONFIG_MISSING (exit 2) → guide user to set TRANS_API_KEY\n├── AUTH_FAILED    (exit 2) → key invalid/expired; check fanyi-api.baidu.com/manage/apiKey\n├── QUOTA_EXCEEDED (exit 3) → balance exhausted; recharge, then retry\n├── RATE_LIMITED   (exit 3) → back off 30 s, then retry\n├── NETWORK_ERROR  (exit 4) → check connectivity, retry\n├── DOC_FAILED     (exit 3) → server-side failure; do NOT retry\n├── INVALID_INPUT  (exit 1) → fix file path / format / --to value\n└── WAIT_TIMEOUT   (exit 1) → job still running; save request_id and resume later\n```\n\nstderr carries errors only — there are no progress events on stderr.\n\n---\n\n## Supported Formats\n\ndocx / doc / pdf / xlsx / xls / pptx / ppt / html / htm / txt / xml / md\n\n`file_url` expires after **30 days**.\n\nFile v1.0.1:_meta.json\n\n{\n  \"ownerId\": \"kn7fhw0h9fm3z24r13j111w56583yfp7\",\n  \"slug\": \"baidu-file-translate\",\n  \"version\": \"1.0.1\",\n  \"publishedAt\": 1779941192242\n}\n\nFile v1.0.1:skill-card.md\n\n## Description:\n\nBaidu File Translate helps agents translate uploaded or referenced documents with Baidu trans-cli while preserving the original document formatting and layout.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[baidu-translate](https://clawhub.ai/user/baidu-translate)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and agents use this skill when a user asks to translate a file or convert a document into another language. It covers common office and text formats, submits asynchronous translation jobs, polls for completion, and guides download only after user confirmation.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Documents submitted for translation are processed by Baidu's translation service.\n\nMitigation: Use only documents that policy allows to be processed by Baidu, and avoid confidential, regulated, or highly sensitive files unless explicitly approved.\n\nRisk: The translation CLI requires TRANS_API_KEY, which may be exposed to local tooling or logs if mishandled.\n\nMitigation: Store the key in the agent environment or secret manager, avoid echoing it in commands, and rotate it if exposure is suspected.\n\nRisk: The skill depends on an npm-installed trans CLI package.\n\nMitigation: Pin or otherwise control the npm dependency in managed environments before deployment.\n\nRisk: Document translation is asynchronous and can exceed an agent's active session.\n\nMitigation: Use the submit and poll workflow, set a bounded agent timeout, preserve request_id on WAIT_TIMEOUT, and resume later instead of retrying blindly.\n\n## Reference(s):\n\n- [Baidu Translate](https://fanyi.baidu.com)\n- [Baidu API Key Management](https://fanyi-api.baidu.com/manage/apiKey)\n- [ClawHub Skill Page](https://clawhub.ai/baidu-translate/skills/baidu-file-translate)\n\n## Skill Output:\n\n**Output Type(s):** [shell commands, configuration, guidance]\n\n**Output Format:** [Markdown with inline shell commands and JSON response examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Uses asynchronous submit and poll workflow; requires trans CLI and TRANS_API_KEY.]\n\n## Skill Version(s):\n\n1.0.1 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v1.0.0: 2 files, 2292 bytes\n\nFiles: SKILL.md (4356b), _meta.json (139b)\n\nFile v1.0.0:SKILL.md\n\n---\nname: baidu-file-translate\ndescription: >\n  Use this skill for file translation with trans-cli (Baidu LLM File\n  Translation API). Covers the submit → poll → download async workflow,\n  requestId lifecycle, Agent-safe polling strategy (submit+query loop, never\n  rely on --wait alone), error handling for DOC_FAILED / WAIT_TIMEOUT / AUTH_FAILED,\n  supported formats (docx/pdf/xlsx/pptx/html/txt/xml/md), and --download flag.\n  Trigger on: trans file commands, file translation, document translation,\n  requestId status polling, DOC_FAILED / WAIT_TIMEOUT errors, or any question\n  about translating a file with trans-cli.\nhomepage: https://fanyi.baidu.com\nmetadata: {\"clawdbot\":{\"emoji\":\"📄\",\"requires\":{\"bins\":[\"trans\"],\"env\":[\"TRANS_API_KEY\"]},\"install\":[{\"id\":\"npm\",\"kind\":\"npm\",\"package\":\"@bdtrans/trans-cli\",\"bins\":[\"trans\"],\"label\":\"Install trans-cli (npm)\"}]}}\n---\n\n# baidu-file-translate — Agent Reference\n\nFile translation is **async**. Always use the submit → poll loop below.\nNever rely on `--wait` without a timeout — it may block indefinitely in an\nAgent framework.\n\n```\nStep 1: trans file submit <file> --from auto --to en --json\n        → exit ≠ 0 → handle by error code (see Error Handling)\n        → exit 0   → record request_id from stdout\n\nStep 2: every 5 s: trans file query <request_id> --json\n        → exit ≠ 0              → handle error; DOC_FAILED = don't retry\n        → exit 0, status=processing → keep polling\n        → exit 0, status=done       → use file_url, or re-run with --download\n```\n\nSet an Agent-level timeout (e.g. 10 min). On WAIT_TIMEOUT, save the\nrequest_id — the job is still running and can be resumed later.\n\n---\n\n## trans file submit \\<file\\>\n\n```bash\ntrans file submit report.pdf --from zh --to en --json\ntrans file submit report.pdf --to en --reference \"Use academic tone\"\n```\n\n| Flag | Default | Description |\n|------|---------|-------------|\n| `--from` | auto | Source language (auto-detect) |\n| `--to` | zh | Target language — **`auto` is not accepted** |\n| `--reference` | — | Custom translation instruction, ≤ 1000 Unicode code points |\n| `--trans-image` | false | Also translate text inside images |\n| `--wait` | false | Block until done (always pair with `--wait-timeout`) |\n| `--wait-timeout` | 0 (no limit) | Max wait time for `--wait` mode |\n\n## trans file query \\<requestId\\>\n\n```bash\ntrans file query REQ123 --json\ntrans file query REQ123 --download --output ./output/\n```\n\n| Flag | Default | Description |\n|------|---------|-------------|\n| `--download` | false | Download the translated file when done |\n| `--output` | ./ | Download directory (used with `--download`) |\n| `--wait` | false | Block until done |\n| `--wait-timeout` | 0 (no limit) | Max wait time for `--wait` mode |\n\n---\n\n## JSON Contract\n\n**submit success (stdout):**\n```json\n{\"request_id\": \"REQ123\", \"status\": \"submitted\"}\n```\n\n**query — in progress (stdout):**\n```json\n{\"request_id\": \"REQ123\", \"status\": \"processing\", \"name\": \"report.pdf\", \"from\": \"zh\", \"to\": \"en\"}\n```\n\n**query — done (stdout):**\n```json\n{\"request_id\": \"REQ123\", \"status\": \"done\", \"file_url\": \"https://...\", \"char_count\": 1000, \"amount\": 70}\n```\n\nWith `--download`, the done response gains:\n```json\n{\"local_path\": \"/absolute/path/to/report_en.pdf\"}\n```\n\n**error (stderr, exit ≠ 0):**\n```json\n{\"code\": \"AUTH_FAILED\", \"message\": \"...\", \"help_url\": \"https://fanyi-api.baidu.com/manage/apiKey\"}\n```\n\n`help_url` is omitted when not applicable.\n\n---\n\n## Error Handling\n\n```\nexit ≠ 0\n├── CONFIG_MISSING (exit 2) → guide user to set TRANS_API_KEY\n├── AUTH_FAILED    (exit 2) → key invalid/expired; check fanyi-api.baidu.com/manage/apiKey\n├── QUOTA_EXCEEDED (exit 3) → balance exhausted; recharge, then retry\n├── RATE_LIMITED   (exit 3) → back off 30 s, then retry\n├── NETWORK_ERROR  (exit 4) → check connectivity, retry\n├── DOC_FAILED     (exit 3) → server-side failure; do NOT retry\n├── INVALID_INPUT  (exit 1) → fix file path / format / --to value\n└── WAIT_TIMEOUT   (exit 1) → job still running; save request_id and resume later\n```\n\nstderr carries errors only — there are no progress events on stderr.\n\n---\n\n## Supported Formats\n\ndocx / doc / pdf / xlsx / xls / pptx / ppt / html / htm / txt / xml / md\n\n`file_url` expires after **30 days**.\n\nFile v1.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn7fhw0h9fm3z24r13j111w56583yfp7\",\n  \"slug\": \"baidu-file-translate\",\n  \"version\": \"1.0.0\",\n  \"publishedAt\": 1778819607175\n}","readmeExcerpt":"Skill: Baidu File Translate Owner: baidu-translate Summary: Baidu trans-cli file/document translation for 文件翻译、文档翻译、PDF/Word/Excel/PPT/TXT/HTML 翻译 while preserving original formatting and layout. Powered by trans-cli... Tags: latest:1.0.1 Version history: v1.0.1 | 2026-05-28T04:06:32.242Z | user - Improved the skill description for clarity and focus on supported document types and translation use-cases. - Clarified w","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"Step 1: trans file submit <file> --from auto --to <lang> --json\n        → exit ≠ 0 → ⚠ STOP if exit 2 (auth/config); handle others (see Error Handling)\n        → exit 0   → record request_id from stdout\n\nStep 2: every 5 s: trans file query <request_id> --json\n        → exit ≠ 0              → handle error; DOC_FAILED = don't retry\n        → exit 0, status=processing → keep polling (set Agent timeout ≤ 10 min)\n        → exit 0, status=done       → ⚠ confirm with user before downloading\n                                       then: trans file query <request_id> --download --output ./\n        → WAIT_TIMEOUT              → ⚠ STOP — save request_id, report to user"},{"language":"bash","snippet":"trans file submit report.pdf --from zh --to en --json\ntrans file submit report.pdf --to en --reference \"Use academic tone\""},{"language":"bash","snippet":"trans file query REQ123 --json\ntrans file query REQ123 --download --output ./output/"},{"language":"json","snippet":"{\"request_id\": \"REQ123\", \"status\": \"submitted\"}"},{"language":"json","snippet":"{\"request_id\": \"REQ123\", \"status\": \"processing\", \"name\": \"report.pdf\", \"from\": \"zh\", \"to\": \"en\"}"},{"language":"json","snippet":"{\"request_id\": \"REQ123\", \"status\": \"done\", \"file_url\": \"https://...\", \"char_count\": 1000, \"amount\": 70}"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: baidu-file-translate\ndescription: Baidu trans-cli file/document translation for 文件翻译、文档翻译、PDF/Word/Excel/PPT/TXT/HTML 翻译 while preserving original formatting and layout. Powered by trans-cli (Baidu LLM File Translation API). Trigger when the user uploads or references a file and asks to translate it, or asks to convert a document's language.\nhomepage: https://fanyi.baidu.com\nmetadata: '{\"clawdbot\":{\"emoji\":\"📄\",\"requires\":{\"bins\":[\"trans\"],\"env\":[\"TRANS_API_KEY\"]},\"install\":[{\"id\":\"npm\",\"kind\":\"npm\",\"package\":\"@bdtrans/trans-cli\",\"bins\":[\"trans\"],\"label\":\"Install trans-cli (npm)\"}]}}'\n---\n\n# baidu-file-translate — Agent Reference\n\nFile translation is **async**. Always use the submit → poll loop below.\nNever rely on `--wait` without a timeout — it may block indefinitely in an\nAgent framework.\n\n```\nStep 1: trans file submit <file> --from auto --to <lang> --json\n        → exit ≠ 0 → ⚠ STOP if exit 2 (auth/config); handle others (see Error Handling)\n        → exit 0   → record request_id from stdout\n\nStep 2: every 5 s: trans file query <request_id> --json\n        → exit ≠ 0              → handle error; DOC_FAILED = don't retry\n        → exit 0, status=processing → keep polling (set Agent timeout ≤ 10 min)\n        → exit 0, status=done       → ⚠ confirm with user before downloading\n                                       then: trans file query <request_id> --download --output ./\n        → WAIT_TIMEOUT              → ⚠ STOP — save request_id, report to user\n```\n\nSet an Agent-level timeout (e.g. 10 min). On WAIT_TIMEOUT, save the\nrequest_id and report to user — the job is still running and can be resumed later.\n\n---\n\n## trans file submit \\<file\\>\n\n```bash\ntrans file submit report.pdf --from zh --to en --json\ntrans file submit report.pdf --to en --reference \"Use academic tone\"\n```\n\n| Flag | Default | Description |\n|------|---------|-------------|\n| `--from` | auto | Source language (auto-detect) |\n| `--to` | zh | Target language — **`auto` is not accepted** |\n| `--reference` | — | Custom translation instruction, ≤ 1000 Unicode code points |\n| `--trans-image` | false | Also translate text inside images |\n| `--wait` | false | Block until done (always pair with `--wait-timeout`) |\n| `--wait-timeout` | 0 (no limit) | Max wait time for `--wait` mode |\n\n## trans file query \\<requestId\\>\n\n```bash\ntrans file query REQ123 --json\ntrans file query REQ123 --download --output ./output/\n```\n\n| Flag | Default | Description |\n|------|---------|-------------|\n| `--download` | false | Download the translated file when done |\n| `--output` | ./ | Download directory (used with `--download`) |\n| `--wait` | false | Block until done |\n| `--wait-timeout` | 0 (no limit) | Max wait time for `--wait` mode |\n\n---\n\n## JSON Contract\n\n**submit success (stdout):**\n```json\n{\"request_id\": \"REQ123\", \"status\": \"submitted\"}\n```\n\n**query — in progress (stdout):**\n```json\n{\"request_id\": \"REQ123\", \"status\": \"processing\", \"name\": \"report.pdf\", \"from\": \"zh\", \"to\": \"en\"}\n```\n\n**query — do"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn7fhw0h9fm3z24r13j111w56583yfp7\",\n  \"slug\": \"baidu-file-translate\",\n  \"version\": \"1.0.1\",\n  \"publishedAt\": 1779941192242\n}"},{"path":"skill-card.md","content":"## Description:\n\nBaidu File Translate helps agents translate uploaded or referenced documents with Baidu trans-cli while preserving the original document formatting and layout.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[baidu-translate](https://clawhub.ai/user/baidu-translate)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and agents use this skill when a user asks to translate a file or convert a document into another language. It covers common office and text formats, submits asynchronous translation jobs, polls for completion, and guides download only after user confirmation.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Documents submitted for translation are processed by Baidu's translation service.\n\nMitigation: Use only documents that policy allows to be processed by Baidu, and avoid confidential, regulated, or highly sensitive files unless explicitly approved.\n\nRisk: The translation CLI requires TRANS_API_KEY, which may be exposed to local tooling or logs if mishandled.\n\nMitigation: Store the key in the agent environment or secret manager, avoid echoing it in commands, and rotate it if exposure is suspected.\n\nRisk: The skill depends on an npm-installed trans CLI package.\n\nMitigation: Pin or otherwise control the npm dependency in managed environments before deployment.\n\nRisk: Document translation is asynchronous and can exceed an agent's active session.\n\nMitigation: Use the submit and poll workflow, set a bounded agent timeout, preserve request_id on WAIT_TIMEOUT, and resume later instead of retrying blindly.\n\n## Reference(s):\n\n- [Baidu Translate](https://fanyi.baidu.com)\n- [Baidu API Key Management](https://fanyi-api.baidu.com/manage/apiKey)\n- [ClawHub Skill Page](https://clawhub.ai/baidu-translate/skills/baidu-file-translate)\n\n## Skill Output:\n\n**Output Type(s):** [shell commands, configuration, guidance]\n\n**Output Format:** [Markdown with inline shell commands and JSON response examples]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Uses asynchronous submit and poll workflow; requires trans CLI and TRANS_API_KEY.]\n\n## Skill Version(s):\n\n1.0.1 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"Baidu trans-cli file/document translation for 文件翻译、文档翻译、PDF/Word/Excel/PPT/TXT/HTML 翻译 while preserving original formatting and layout. Powered by trans-cli... Skill: Baidu File Translate Owner: baidu-translate Summary: Baidu trans-cli file/document translation for 文件翻译、文档翻译、PDF/Word/Excel/PPT/TXT/HTML 翻译 while preserving original formatting and layout. Powered by trans-cli... Tags: latest:1.0.1 Version history: v1.0.1 | 2026-05-28T04:06:32.242Z | user - Improved the skill description for clarity and focus on supported document types and translation use-cases. - Clarified w","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1115,"uniquenessScore":50,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T10:34:48.896Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T10:34:48.896Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-11T14:16:07.655Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}