言語と翻訳

ZeroClawのインターフェース文字列（CLIメッセージ、コマンドヘルプ、zerocode TUI）は、英語以外の言語でも表示できます。英語は常に組み込まれており、その他の言語は必要に応じてダウンロードされます。

言語を設定する

ZeroClaw は設定ファイルのトップレベルにある locale キーを読み取ります。ja、fr、zh-CN などのロケールコードを設定してください。locale が未設定の場合、ZeroClaw はオペレーティングシステムの言語を使用し、利用可能な翻訳がない場合は英語にフォールバックします。

言語ファイルを取得する

英語はバイナリ内に同梱されています。それ以外の言語については、翻訳ファイルを一度だけ取得します。

zeroclaw locales fetch ja

これにより、ZeroClawプロジェクトから日本語の翻訳ファイルをダウンロードし、~/.zeroclaw/data/ftl/ja/にインストールします。この場所はZeroClawが起動時に参照するディレクトリです。インストール後、ZeroClaw（およびzerocode）を再起動して反映してください。

任意のロケールを同じ方法で取得します。

zeroclaw locales fetch fr        # フランス語
zeroclaw locales fetch zh-CN     # 簡体字中国語

言語の一部のみを取得する

デフォルトでは、fetch はそのロケールのすべてのカタログをダウンロードします。一部のカタログのみをダウンロードするには、--catalog にカンマ区切りのリストを指定します。

zeroclaw locales fetch ja --catalog cli            # just CLI 文字列
zeroclaw locales fetch ja --catalog cli,zerocode   # CLI + TUI

カタログがまだあなたの言語に翻訳されていない場合、fetch はそれをスキップして次のように通知します。存在するカタログは引き続きインストールされます。

ファイルの保存場所

ZeroClaw をカスタム設定ディレクトリ（--config-dir または ZEROCLAW_CONFIG_DIR）で実行した場合、ファイルは代わりにそのディレクトリの data/ftl/ 配下にインストールされます。

トラブルシューティング

• 取得後も英語が表示される場合。 設定の locale が取得したロケールと一致していることを確認し、プロセスを再起動してください。ZeroClaw は起動時に言語ファイルを読み込みます。
• fetch がカタログのスキップを報告する。 そのカタログはまだお使いのロケール向けに翻訳されていません。利用可能なカタログは引き続きインストールされており、未翻訳の文字列は英語にフォールバックします。
• 一部の特定の文字列は、他が翻訳されているにもかかわらず英語のままです。 その個別の文字列にはまだ翻訳がなく、仕様上、英語にフォールバックします。