Wikiノート
カスタマイズ
WebChat日本語化パッチ

WebChat日本語化パッチ

OpenClaw WebChatダッシュボードUIを日本語化するパッチの導入手順を解説します。

概要

openclaw-webchat-jaは、OpenClaw WebChatダッシュボードのUIを日本語化するためのパッチです。約70個の主要なUI要素が日本語に翻訳されます。

翻訳の特徴

  • ✅ 自然な日英混在UI - 日本語 + IT用語は英語のまま
  • ✅ 自動検出 - OpenClawインストール先を自動で発見
  • ✅ 安全なパッチ適用 - 適用前に自動バックアップ
  • ✅ 簡単な復元 - ワンコマンドで英語版に戻せる
  • ✅ 冪等性 - 何度実行しても安全

翻訳例

英語日本語備考
Overview概要
Sessionsセッション
Settings設定
Save保存
Apply適用
Connected接続済
Expand sidebarサイドバー展開
ChatChatIT用語として英語のまま
AgentsAgentsIT用語として英語のまま

前提条件

  • OpenClaw がインストール済み
  • Bashシェルが使用可能

インストール手順

方法1: 直接インストール（推奨）

パッチスクリプトをダウンロードして実行します。


wget https://raw.githubusercontent.com/yozora4416/openclaw-webchat-ja/main/scripts/apply.sh


chmod +x apply.sh


./apply.sh

方法2: リポジトリをクローン 


git clone https://github.com/yozora4416/openclaw-webchat-ja.git
cd openclaw-webchat-ja


./scripts/apply.sh

方法3: OpenClaw Skillとして

OpenClawのskillsディレクトリに配置する方法です。


git clone https://github.com/yozora4416/openclaw-webchat-ja.git \
  /root/clawd/skills/webchat-ja

cd /root/clawd/skills/webchat-ja


./scripts/apply.sh

適用後の確認

パッチ適用後、OpenClawを再起動します。

openclaw gateway restart

ブラウザでWebChatダッシュボードを開き、UIが日本語化されていることを確認してください。

http://localhost:8080

使い方

日本語化を適用 

./scripts/apply.sh

実行すると、以下の処理が自動的に行われます：

  1. OpenClaw control-ui JavaScriptファイルを検出
  2. オリジナルファイルのバックアップを作成
  3. 日本語翻訳を適用
  4. 完了メッセージを表示

変更をプレビュー（ドライラン）

実際には適用せず、どのような変更が行われるかを確認できます。

./scripts/apply.sh --dry-run

英語版に戻す

元の英語UIに戻したい場合は、復元スクリプトを実行します。

./scripts/restore.sh

その後、OpenClawを再起動してください。

openclaw gateway restart

翻訳方針

日本の開発者にとって馴染みのある英語IT用語はそのまま残し、自然言語のUI要素を日本語に翻訳することで、快適なバイリンガルUIを実現しています。

英語のまま残す用語

  • Chat, Agents, Skills, Models, Tools
  • Browser, Canvas, Nodes, Plugins
  • Gateway, Online, Offline, Tokens
  • API, Webhook, Filter, Search

これらは日本の技術者にとって英語で使うことが一般的なため、翻訳せずそのまま使用しています。

日本語に翻訳する要素

  • ナビゲーションラベル（概要、セッション、設定）
  • アクションボタン（保存、適用、削除）
  • ステータスメッセージ（接続済、有効、保留中）
  • ユーザー向け説明文

OpenClawアップデート後の対応

OpenClawを更新すると、パッチが上書きされるため、再適用が必要です。


npm update -g openclaw


cd /path/to/openclaw-webchat-ja
./scripts/apply.sh


openclaw gateway restart

トラブルシューティング

“No OpenClaw control-ui JavaScript file found”

OpenClawがインストールされていない可能性があります。以下で確認してください：

which openclaw
npm list -g openclaw

手動でcontrol-uiファイルを探す場合：

find /root/.nvm -name "index-*.js" -path "*/control-ui/assets/*"

一部の文字列が翻訳されていない

UIが更新されて新しい文字列が追加された可能性があります。GitHubリポジトリにIssueを報告してください。

パッチ適用後にUIが壊れた

復元スクリプトで元に戻してください：

./scripts/restore.sh
openclaw gateway restart

その後、GitHubでIssueを報告していただけると助かります。

貢献方法

より良い翻訳の提案を歓迎します！

  1. 翻訳マップで既存の翻訳を確認
  2. 実際のUIで翻訳をテスト
  3. GitHubでIssueを作成、またはPull Requestを送信

詳しくはリポジトリのCONTRIBUTING.mdをご覧ください。

関連リンク

最終更新: 2026-02-14