diff --git a/docs/.i18n/glossary.ja-JP.json b/docs/.i18n/glossary.ja-JP.json
new file mode 100644
index 0000000000..f7c59a187d
--- /dev/null
+++ b/docs/.i18n/glossary.ja-JP.json
@@ -0,0 +1,14 @@
+[
+ { "source": "OpenClaw", "target": "OpenClaw" },
+ { "source": "Gateway", "target": "Gateway" },
+ { "source": "Pi", "target": "Pi" },
+ { "source": "Skills", "target": "Skills" },
+ { "source": "local loopback", "target": "local loopback" },
+ { "source": "Tailscale", "target": "Tailscale" },
+ { "source": "Getting Started", "target": "はじめに" },
+ { "source": "Getting started", "target": "はじめに" },
+ { "source": "Quick start", "target": "クイックスタート" },
+ { "source": "Quick Start", "target": "クイックスタート" },
+ { "source": "Onboarding", "target": "オンボーディング" },
+ { "source": "wizard", "target": "ウィザード" }
+]
diff --git a/docs/.i18n/ja-JP.tm.jsonl b/docs/.i18n/ja-JP.tm.jsonl
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/docs/docs.json b/docs/docs.json
index b32ed2800a..ba75a038fc 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -1273,6 +1273,24 @@
}
]
},
+ {
+ "language": "ja",
+ "tabs": [
+ {
+ "tab": "はじめに",
+ "groups": [
+ {
+ "group": "概要",
+ "pages": ["ja-JP/index"]
+ },
+ {
+ "group": "初回セットアップ",
+ "pages": ["ja-JP/start/getting-started", "ja-JP/start/wizard"]
+ }
+ ]
+ }
+ ]
+ },
{
"language": "zh-Hans",
"tabs": [
diff --git a/docs/ja-JP/AGENTS.md b/docs/ja-JP/AGENTS.md
new file mode 100644
index 0000000000..4bdd53260f
--- /dev/null
+++ b/docs/ja-JP/AGENTS.md
@@ -0,0 +1,37 @@
+# AGENTS.md - ja-JP docs translation workspace
+
+## Read When
+
+- Maintaining `docs/ja-JP/**`
+- Updating the Japanese translation pipeline (glossary/TM/prompt)
+- Handling Japanese translation feedback or regressions
+
+## Pipeline (docs-i18n)
+
+- Source docs: `docs/**/*.md`
+- Target docs: `docs/ja-JP/**/*.md`
+- Glossary: `docs/.i18n/glossary.ja-JP.json`
+- Translation memory: `docs/.i18n/ja-JP.tm.jsonl`
+- Prompt rules: `scripts/docs-i18n/prompt.go`
+
+Common runs:
+
+```bash
+# Bulk (doc mode; parallel OK)
+cd scripts/docs-i18n
+go run . -docs ../../docs -lang ja-JP -mode doc -parallel 6 ../../docs/**/*.md
+
+# Single file
+cd scripts/docs-i18n
+go run . -docs ../../docs -lang ja-JP -mode doc ../../docs/start/getting-started.md
+
+# Small patches (segment mode; uses TM; no parallel)
+cd scripts/docs-i18n
+go run . -docs ../../docs -lang ja-JP -mode segment ../../docs/start/getting-started.md
+```
+
+Notes:
+
+- Prefer `doc` mode for whole-page translation; `segment` mode for small fixes.
+- If a very large file times out, do targeted edits or split the page before rerunning.
+- After translation, spot-check: code spans/blocks unchanged, links/anchors unchanged, placeholders preserved.
diff --git a/docs/ja-JP/index.md b/docs/ja-JP/index.md
new file mode 100644
index 0000000000..ba504314ec
--- /dev/null
+++ b/docs/ja-JP/index.md
@@ -0,0 +1,186 @@
+---
+read_when:
+ - 新規ユーザーにOpenClawを紹介するとき
+summary: OpenClawは、あらゆるOSで動作するAIエージェント向けのマルチチャネルgatewayです。
+title: OpenClaw
+x-i18n:
+ generated_at: "2026-02-08T17:15:47Z"
+ model: claude-opus-4-5
+ provider: pi
+ source_hash: fc8babf7885ef91d526795051376d928599c4cf8aff75400138a0d7d9fa3b75f
+ source_path: index.md
+ workflow: 15
+---
+
+# OpenClaw 🦞
+
+
+
+
+
+
+> _「EXFOLIATE! EXFOLIATE!」_ — たぶん宇宙ロブスター
+
+
+ WhatsApp、Telegram、Discord、iMessageなどに対応した、あらゆるOS向けのAIエージェントgateway。
+ メッセージを送信すれば、ポケットからエージェントの応答を受け取れます。プラグインでMattermostなどを追加できます。
+
+
+
+
+ OpenClawをインストールし、数分でGatewayを起動できます。
+
+
+ `openclaw onboard`とペアリングフローによるガイド付きセットアップ。
+
+
+ チャット、設定、セッション用のブラウザダッシュボードを起動します。
+
+
+
+OpenClawは、単一のGatewayプロセスを通じてチャットアプリをPiのようなコーディングエージェントに接続します。OpenClawアシスタントを駆動し、ローカルまたはリモートのセットアップをサポートします。
+
+## 仕組み
+
+```mermaid
+flowchart LR
+ A["チャットアプリ + プラグイン"] --> B["Gateway"]
+ B --> C["Piエージェント"]
+ B --> D["CLI"]
+ B --> E["Web Control UI"]
+ B --> F["macOSアプリ"]
+ B --> G["iOSおよびAndroidノード"]
+```
+
+Gatewayは、セッション、ルーティング、チャネル接続の信頼できる唯一の情報源です。
+
+## 主な機能
+
+
+
+ 単一のGatewayプロセスでWhatsApp、Telegram、Discord、iMessageに対応。
+
+
+ 拡張パッケージでMattermostなどを追加。
+
+
+ エージェント、ワークスペース、送信者ごとに分離されたセッション。
+
+
+ 画像、音声、ドキュメントの送受信。
+
+
+ チャット、設定、セッション、ノード用のブラウザダッシュボード。
+
+
+ Canvas対応のiOSおよびAndroidノードをペアリング。
+
+
+
+## クイックスタート
+
+
+
+ ```bash
+ npm install -g openclaw@latest
+ ```
+
+
+ ```bash
+ openclaw onboard --install-daemon
+ ```
+
+
+ ```bash
+ openclaw channels login
+ openclaw gateway --port 18789
+ ```
+
+
+
+完全なインストールと開発セットアップが必要ですか?[クイックスタート](/start/quickstart)をご覧ください。
+
+## ダッシュボード
+
+Gatewayの起動後、ブラウザでControl UIを開きます。
+
+- ローカルデフォルト: http://127.0.0.1:18789/
+- リモートアクセス: [Webサーフェス](/web)および[Tailscale](/gateway/tailscale)
+
+
+
+
+
+## 設定(オプション)
+
+設定は`~/.openclaw/openclaw.json`にあります。
+
+- **何もしなければ**、OpenClawはバンドルされたPiバイナリをRPCモードで使用し、送信者ごとのセッションを作成します。
+- 制限を設けたい場合は、`channels.whatsapp.allowFrom`と(グループの場合)メンションルールから始めてください。
+
+例:
+
+```json5
+{
+ channels: {
+ whatsapp: {
+ allowFrom: ["+15555550123"],
+ groups: { "*": { requireMention: true } },
+ },
+ },
+ messages: { groupChat: { mentionPatterns: ["@openclaw"] } },
+}
+```
+
+## ここから始める
+
+
+
+ ユースケース別に整理されたすべてのドキュメントとガイド。
+
+
+ Gatewayのコア設定、トークン、プロバイダー設定。
+
+
+ SSHおよびtailnetアクセスパターン。
+
+
+ WhatsApp、Telegram、Discordなどのチャネル固有のセットアップ。
+
+
+ ペアリングとCanvas対応のiOSおよびAndroidノード。
+
+
+ 一般的な修正とトラブルシューティングのエントリーポイント。
+
+
+
+## 詳細
+
+
+
+ チャネル、ルーティング、メディア機能の完全な一覧。
+
+
+ ワークスペースの分離とエージェントごとのセッション。
+
+
+ トークン、許可リスト、安全制御。
+
+
+ Gatewayの診断と一般的なエラー。
+
+
+ プロジェクトの起源、貢献者、ライセンス。
+
+
diff --git a/docs/ja-JP/start/getting-started.md b/docs/ja-JP/start/getting-started.md
new file mode 100644
index 0000000000..6621d5b896
--- /dev/null
+++ b/docs/ja-JP/start/getting-started.md
@@ -0,0 +1,125 @@
+---
+read_when:
+ - ゼロからの初回セットアップ
+ - 動作するチャットへの最短ルートを知りたい
+summary: OpenClawをインストールし、数分で最初のチャットを実行しましょう。
+title: はじめに
+x-i18n:
+ generated_at: "2026-02-08T17:15:16Z"
+ model: claude-opus-4-5
+ provider: pi
+ source_hash: 27aeeb3d18c495380e94e6b011b0df3def518535c9f1eee504f04871d8a32269
+ source_path: start/getting-started.md
+ workflow: 15
+---
+
+# はじめに
+
+目標:ゼロから最小限のセットアップで最初の動作するチャットを実現する。
+
+
+最速のチャット方法:Control UIを開く(チャンネル設定は不要)。`openclaw dashboard`を実行してブラウザでチャットするか、Gatewayホストで`http://127.0.0.1:18789/`を開きます。
+ドキュメント:[Dashboard](/web/dashboard)と[Control UI](/web/control-ui)。
+
+
+## 前提条件
+
+- Node 22以降
+
+
+不明な場合は`node --version`でNodeのバージョンを確認してください。
+
+
+## クイックセットアップ(CLI)
+
+
+
+
+
+ ```bash
+ curl -fsSL https://openclaw.ai/install.sh | bash
+ ```
+
+
+ ```powershell
+ iwr -useb https://openclaw.ai/install.ps1 | iex
+ ```
+
+
+
+
+ その他のインストール方法と要件:[インストール](/install)。
+
+
+
+
+ ```bash
+ openclaw onboard --install-daemon
+ ```
+
+ ウィザードは認証、Gateway設定、およびオプションのチャンネルを構成します。
+ 詳細は[オンボーディングウィザード](/start/wizard)を参照してください。
+
+
+
+ サービスをインストールした場合、すでに実行されているはずです:
+
+ ```bash
+ openclaw gateway status
+ ```
+
+
+
+ ```bash
+ openclaw dashboard
+ ```
+
+
+
+
+Control UIが読み込まれれば、Gatewayは使用可能な状態です。
+
+
+## オプションの確認と追加機能
+
+
+
+ クイックテストやトラブルシューティングに便利です。
+
+ ```bash
+ openclaw gateway --port 18789
+ ```
+
+
+
+ 構成済みのチャンネルが必要です。
+
+ ```bash
+ openclaw message send --target +15555550123 --message "Hello from OpenClaw"
+ ```
+
+
+
+
+## さらに詳しく
+
+
+
+ 完全なCLIウィザードリファレンスと高度なオプション。
+
+
+ macOSアプリの初回実行フロー。
+
+
+
+## 完了後の状態
+
+- 実行中のGateway
+- 構成済みの認証
+- Control UIアクセスまたは接続済みのチャンネル
+
+## 次のステップ
+
+- DMの安全性と承認:[ペアリング](/start/pairing)
+- さらにチャンネルを接続:[チャンネル](/channels)
+- 高度なワークフローとソースからのビルド:[セットアップ](/start/setup)
diff --git a/docs/ja-JP/start/wizard.md b/docs/ja-JP/start/wizard.md
new file mode 100644
index 0000000000..19f5312585
--- /dev/null
+++ b/docs/ja-JP/start/wizard.md
@@ -0,0 +1,77 @@
+---
+read_when:
+ - オンボーディングウィザードの実行または設定時
+ - 新しいマシンのセットアップ時
+sidebarTitle: Wizard (CLI)
+summary: CLIオンボーディングウィザード:Gateway、ワークスペース、チャンネル、Skillsの対話式セットアップ
+title: オンボーディングウィザード(CLI)
+x-i18n:
+ generated_at: "2026-02-08T17:15:18Z"
+ model: claude-opus-4-5
+ provider: pi
+ source_hash: 9a650d46044a930aa4aaec30b35f1273ca3969bf676ab67bf4e1575b5c46db4c
+ source_path: start/wizard.md
+ workflow: 15
+---
+
+# オンボーディングウィザード(CLI)
+
+CLIオンボーディングウィザードは、macOS、Linux、Windows(WSL2経由)でOpenClawをセットアップする際の推奨パスです。ローカルGatewayまたはリモートGateway接続に加えて、ワークスペースのデフォルト設定、チャンネル、Skillsを構成します。
+
+```bash
+openclaw onboard
+```
+
+
+最速で初回チャットを開始する方法:Control UI を開きます(チャンネル設定は不要)。`openclaw dashboard` を実行してブラウザでチャットできます。ドキュメント:[Dashboard](/web/dashboard)。
+
+
+## クイックスタート vs 詳細設定
+
+ウィザードは**クイックスタート**(デフォルト設定)と**詳細設定**(完全な制御)のどちらかを選択して開始します。
+
+
+
+ - loopback上のローカルGateway
+ - 既存のワークスペースまたはデフォルトワークスペース
+ - Gatewayポート `18789`
+ - Gateway認証トークンは自動生成(loopback上でも生成されます)
+ - Tailscale公開はオフ
+ - TelegramとWhatsAppのDMはデフォルトで許可リスト(電話番号の入力を求められる場合があります)
+
+
+ - モード、ワークスペース、Gateway、チャンネル、デーモン、Skillsの完全なプロンプトフローを表示
+
+
+
+## CLIオンボーディングの詳細
+
+
+
+ ローカルおよびリモートフローの完全な説明、認証とモデルマトリックス、設定出力、ウィザードRPC、signal-cliの動作。
+
+
+ 非対話式オンボーディングのレシピと自動化された `agents add` の例。
+
+
+
+## よく使うフォローアップコマンド
+
+```bash
+openclaw configure
+openclaw agents add
+```
+
+
+`--json` は非対話モードを意味しません。スクリプトでは `--non-interactive` を使用してください。
+
+
+
+推奨:エージェントが `web_search` を使用できるように、Brave Search APIキーを設定してください(`web_fetch` はキーなしで動作します)。最も簡単な方法:`openclaw configure --section web` を実行すると `tools.web.search.apiKey` が保存されます。ドキュメント:[Webツール](/tools/web)。
+
+
+## 関連ドキュメント
+
+- CLIコマンドリファレンス:[`openclaw onboard`](/cli/onboard)
+- macOSアプリのオンボーディング:[オンボーディング](/start/onboarding)
+- エージェント初回起動の手順:[エージェントブートストラップ](/start/bootstrapping)