From a0e11e63fe76a8af2d85da83325675567e1b7ed4 Mon Sep 17 00:00:00 2001 From: Dalomeve <115125037+Dalomeve@users.noreply.github.com> Date: Tue, 3 Mar 2026 01:08:26 +0800 Subject: [PATCH] docs(faq): add Windows exec encoding troubleshooting (#30736) Co-authored-by: dalomeve --- docs/help/faq.md | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/docs/help/faq.md b/docs/help/faq.md index a82efca6fce..2bf134b0e68 100644 --- a/docs/help/faq.md +++ b/docs/help/faq.md @@ -30,6 +30,7 @@ Quick answers plus deeper troubleshooting for real-world setups (local dev, VPS, - [How long does install and onboarding usually take?](#how-long-does-install-and-onboarding-usually-take) - [Installer stuck? How do I get more feedback?](#installer-stuck-how-do-i-get-more-feedback) - [Windows install says git not found or openclaw not recognized](#windows-install-says-git-not-found-or-openclaw-not-recognized) + - [Windows exec output shows garbled Chinese text what should I do](#windows-exec-output-shows-garbled-chinese-text-what-should-i-do) - [The docs didn't answer my question - how do I get a better answer?](#the-docs-didnt-answer-my-question-how-do-i-get-a-better-answer) - [How do I install OpenClaw on Linux?](#how-do-i-install-openclaw-on-linux) - [How do I install OpenClaw on a VPS?](#how-do-i-install-openclaw-on-a-vps) @@ -584,6 +585,32 @@ Two common Windows issues: If you want the smoothest Windows setup, use **WSL2** instead of native Windows. Docs: [Windows](/platforms/windows). +### Windows exec output shows garbled Chinese text what should I do + +This is usually a console code page mismatch on native Windows shells. + +Symptoms: +- `system.run`/`exec` output renders Chinese as mojibake +- The same command looks fine in another terminal profile + +Quick workaround in PowerShell: + +```powershell +chcp 65001 +[Console]::InputEncoding = [System.Text.UTF8Encoding]::new($false) +[Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false) +$OutputEncoding = [System.Text.UTF8Encoding]::new($false) +``` + +Then restart the Gateway and retry your command: + +```powershell +openclaw gateway restart +``` + +If you still reproduce this on latest OpenClaw, track/report it in: +- [Issue #30640](https://github.com/openclaw/openclaw/issues/30640) + ### The docs didn't answer my question how do I get a better answer Use the **hackable (git) install** so you have the full source and docs locally, then ask