Contents
OpenClawのインストールと初期準備
OpenClawを日本語環境で利用するには、公式リポジトリからのインストールが必須です。macOSやLinuxでの手順は大きく異なり、各OSに合わせた注意点を確認することでスムーズな導入が可能です。以下に具体的なインストール方法とポイントを解説します。
macOSでのインストール手順
macOSではHomebrewで簡単に導入できますが、事前に前提条件を満たしているか確認してください。また、sudoの使用は設計思想と矛盾するため、避けるべきです。
-
Homebrewをインストール（未インストールの場合は以下のコマンドを実行）
bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" -
OpenClawのリポジトリを追加
bash
brew tap openclaw/openclaw -
インストールコマンド実行
bash
brew install openclaw
注意点:
- Homebrewでインストールする場合、
~/Library/OpenClaw/に設定ファイルが自動生成されます。 sudoの使用は推奨されません（Homebrewの設計思想に基づく）。権限不足時は、Homebrewのインストール方法や環境を再確認してください。
Linuxでのインストール手順
UbuntuやDebian系LinuxではAPTパッケージマネージャーを使用します。
-
リポジトリ情報を追加（例: Ubuntu 22.04）
bash
curl -fsSL https://openclaw.repo.key | sudo apt-key add -
echo "deb [arch=amd64] https://repo.openclaw.org/ openclaw main" | sudo tee /etc/apt/sources.list.d/openclaw.list -
パッケージ更新
bash
sudo apt update -
OpenClawのインストール
bash
sudo apt install openclaw
注意点:
- Linuxでは
/etc/openclaw/に設定ファイルが配置されます。 - 既存の
ffmpegやgolangが最新版でないと動作しない可能性があります。
日本語化設定の実施方法
OpenClaw本体は日本語対応していないため、手動での設定が必要です。openclaw.jsonファイルを編集することで、アプリケーション内での言語表示やローカライズファイルの配置場所をカスタマイズできます。
openclaw.jsonの編集手順
1. 設定ファイルの確認とバックアップ
- デフォルトの設定ファイルは
~/.openclaw/openclaw.jsonに存在します。 - 変更前に必ずバックアップを取ってください（例:
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.bak）。
2. JSONファイルの編集と保存
-
テキストエディタで
openclaw.jsonを開き、以下のように言語設定を追加します：
json
{
"language": "ja",
"locale_dir": "~/.openclaw/locales"
} -
編集後は
Ctrl+Sで保存し、アプリケーションを再起動してください。
注意点:
- JSONファイルの構文ミス（例: コンマ抜け）により設定が反映されない場合があります。
locale_dirに指定するディレクトリは事前に作成しておく必要があります。権限不足時に失敗する場合は、sudo mkdir ~/.openclaw/localesで作成してください。
ローカライズファイルの配置場所
日本語対応にはカスタム翻訳ファイルを準備し、locale_dirに配置します。
| 手順 | 内容 |
|---|---|
| 1. 翻訳ファイルの取得 | GitHubリポジトリからja.jsonをダウンロード（公式翻訳は提供されていません） |
| 2. ファイルの配置 | mkdir ~/.openclaw/locales + cp ja.json ~/.openclaw/locales/ |
| 3. 設定ファイルの再確認 | locale_dirが正しく指定されているか再度確認してください |
Control UIの言語対応現状と代替案
Control UIは公式では日本語非対応です。現時点でサポートされている言語は英語、中国語（簡体・繁体）、ポルトガル語、ドイツ語、スペイン語のみです。
公式UIの日本語非対応事実
- Control UIの日本語化状況: 日本語に対応していません。翻訳ファイルも公式には提供されていないため、完全な日本語利用は難しいです。
- 影響範囲: UI上のラベルやメッセージがすべて英語で表示され、日本語ユーザーにとって操作性が低下します。
手動での文字列置換方法
UIを日本語化するにはJavaScriptファイルの直接編集が必要です。
-
Control UIソースコードの取得
bash
git clone https://github.com/openclaw/control-ui.git -
翻訳ファイルの準備
-
ja.jsonを作成し、以下の例のように英語を日本語に置き換えます：
json
{
"welcome": "ようこそ",
"settings": "設定"
} -
JavaScriptファイルへの反映
-
src/i18n.jsで以下のように言語設定を変更します：
javascript
const i18n = require('./locales/ja.json'); -
再コンパイルとデプロイ
bash
npm run build
注意: 本方法は開発者向けの手動操作であり、公式サポート外です。環境変更に伴うリスクを十分にご理解ください。
初期設定時の代表的エラーと解決策
OpenClawの初期設定ではJSONファイルの形式エラーやポート衝突といった問題が発生します。以下に代表的なケースと対処法を解説します。
設定ファイル形式エラー
| 原因 | 解決策 |
|---|---|
openclaw.jsonの構文ミス（例: カンマ抜け） |
JSON Validatorツールでチェック（例: jsonlint.com） |
例:
|
1 2 3 4 5 |
{ "language": "ja", // ← コンマが抜けている場合のエラーメッセージ: "Expecting ',' delimiter" "locale_dir": "~/.openclaw/locales" } |
ポート衝突時の対処法
| 手順 | 内容 |
|---|---|
| 1. 使用中のポート確認 | lsof -i :8080で確認 |
| 2. 競合プロセスの停止またはポート変更 | kill -9 <PID> or openclaw.jsonで別のポートを指定 |
例:
|
1 2 3 4 5 |
{ "port": 8081, // ← デフォルトの8080から変更 "language": "ja" } |
チャネル接続時の認証失敗の原因と対策
APIキーの再発行手順
- 原因: 有効期限切れや誤ったAPIキーの入力。
- 解決策: OpenClaw管理画面から「設定」→「APIキー」セクションにアクセスし、新しいAPIキーを取得し、
openclaw.jsonに反映してください。
タイムスタンプ同期の重要性
| OS | 同期コマンド |
|---|---|
| Linux | sudo ntpdate pool.ntp.org |
| macOS | chronydサービスを有効化 |
注意: 時刻が1分以上ずれていると、認証に失敗する可能性があります。
まとめ
本記事では、OpenClawの日本語環境での設定手順とトラブルシューティングを解説しました。具体的なポイントは以下の通りです：
- macOS/Linuxそれぞれでのインストール手順と注意点
openclaw.jsonファイルによる言語設定とローカライズファイル配置方法- Control UIの日本語非対応に対し、JavaScript編集による代替案の提案
- 初期設定時のJSON形式エラーおよびポート衝突の解決策
- チャネル接続時に発生するAPIキー無効・タイムスタンプ不一致の対処法
これらの手順を実施することで、日本語環境でのOpenClaw運用がスムーズになります。設定中にエラーが発生した場合は、コメント欄にご記入ください。