Docs: seed ja-JP translations

2026-02-09 05:19:32 +08:00 · 2026-02-08 09:25:17 -08:00
parent d2ec78607d
commit c4213b89eb
7 changed files with 457 additions and 0 deletions
--- a/docs/.i18n/glossary.ja-JP.json
+++ 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": "ウィザード" }
+]
--- a/docs/.i18n/ja-JP.tm.jsonl
+++ b/docs/.i18n/ja-JP.tm.jsonl
--- 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": [
--- a/docs/ja-JP/AGENTS.md
+++ 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.
--- a/docs/ja-JP/index.md
+++ 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 🦞
+
+<p align="center">
+    <img
+        src="/assets/openclaw-logo-text-dark.png"
+        alt="OpenClaw"
+        width="500"
+        class="dark:hidden"
+    />
+    <img
+        src="/assets/openclaw-logo-text.png"
+        alt="OpenClaw"
+        width="500"
+        class="hidden dark:block"
+    />
+</p>
+
+> _「EXFOLIATE! EXFOLIATE!」_ — たぶん宇宙ロブスター
+
+<p align="center">
+  <strong>WhatsApp、Telegram、Discord、iMessageなどに対応した、あらゆるOS向けのAIエージェントgateway。</strong><br />
+  メッセージを送信すれば、ポケットからエージェントの応答を受け取れます。プラグインでMattermostなどを追加できます。
+</p>
+
+<Columns>
+  <Card title="はじめに" href="/start/getting-started" icon="rocket">
+    OpenClawをインストールし、数分でGatewayを起動できます。
+  </Card>
+  <Card title="ウィザードを実行" href="/start/wizard" icon="sparkles">
+    `openclaw onboard`とペアリングフローによるガイド付きセットアップ。
+  </Card>
+  <Card title="Control UIを開く" href="/web/control-ui" icon="layout-dashboard">
+    チャット、設定、セッション用のブラウザダッシュボードを起動します。
+  </Card>
+</Columns>
+
+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は、セッション、ルーティング、チャネル接続の信頼できる唯一の情報源です。
+
+## 主な機能
+
+<Columns>
+  <Card title="マルチチャネルgateway" icon="network">
+    単一のGatewayプロセスでWhatsApp、Telegram、Discord、iMessageに対応。
+  </Card>
+  <Card title="プラグインチャネル" icon="plug">
+    拡張パッケージでMattermostなどを追加。
+  </Card>
+  <Card title="マルチエージェントルーティング" icon="route">
+    エージェント、ワークスペース、送信者ごとに分離されたセッション。
+  </Card>
+  <Card title="メディアサポート" icon="image">
+    画像、音声、ドキュメントの送受信。
+  </Card>
+  <Card title="Web Control UI" icon="monitor">
+    チャット、設定、セッション、ノード用のブラウザダッシュボード。
+  </Card>
+  <Card title="モバイルノード" icon="smartphone">
+    Canvas対応のiOSおよびAndroidノードをペアリング。
+  </Card>
+</Columns>
+
+## クイックスタート
+
+<Steps>
+  <Step title="OpenClawをインストール">
+    ```bash
+    npm install -g openclaw@latest
+    ```
+  </Step>
+  <Step title="オンボーディングとサービスのインストール">
+    ```bash
+    openclaw onboard --install-daemon
+    ```
+  </Step>
+  <Step title="WhatsAppをペアリングしてGatewayを起動">
+    ```bash
+    openclaw channels login
+    openclaw gateway --port 18789
+    ```
+  </Step>
+</Steps>
+
+完全なインストールと開発セットアップが必要ですか？[クイックスタート](/start/quickstart)をご覧ください。
+
+## ダッシュボード
+
+Gatewayの起動後、ブラウザでControl UIを開きます。
+
+- ローカルデフォルト: http://127.0.0.1:18789/
+- リモートアクセス: [Webサーフェス](/web)および[Tailscale](/gateway/tailscale)
+
+<p align="center">
+  <img src="whatsapp-openclaw.jpg" alt="OpenClaw" width="420" />
+</p>
+
+## 設定（オプション）
+
+設定は`~/.openclaw/openclaw.json`にあります。
+
+- **何もしなければ**、OpenClawはバンドルされたPiバイナリをRPCモードで使用し、送信者ごとのセッションを作成します。
+- 制限を設けたい場合は、`channels.whatsapp.allowFrom`と（グループの場合）メンションルールから始めてください。
+
+例：
+
+```json5
+{
+  channels: {
+    whatsapp: {
+      allowFrom: ["+15555550123"],
+      groups: { "*": { requireMention: true } },
+    },
+  },
+  messages: { groupChat: { mentionPatterns: ["@openclaw"] } },
+}
+```
+
+## ここから始める
+
+<Columns>
+  <Card title="ドキュメントハブ" href="/start/hubs" icon="book-open">
+    ユースケース別に整理されたすべてのドキュメントとガイド。
+  </Card>
+  <Card title="設定" href="/gateway/configuration" icon="settings">
+    Gatewayのコア設定、トークン、プロバイダー設定。
+  </Card>
+  <Card title="リモートアクセス" href="/gateway/remote" icon="globe">
+    SSHおよびtailnetアクセスパターン。
+  </Card>
+  <Card title="チャネル" href="/channels/telegram" icon="message-square">
+    WhatsApp、Telegram、Discordなどのチャネル固有のセットアップ。
+  </Card>
+  <Card title="ノード" href="/nodes" icon="smartphone">
+    ペアリングとCanvas対応のiOSおよびAndroidノード。
+  </Card>
+  <Card title="ヘルプ" href="/help" icon="life-buoy">
+    一般的な修正とトラブルシューティングのエントリーポイント。
+  </Card>
+</Columns>
+
+## 詳細
+
+<Columns>
+  <Card title="全機能リスト" href="/concepts/features" icon="list">
+    チャネル、ルーティング、メディア機能の完全な一覧。
+  </Card>
+  <Card title="マルチエージェントルーティング" href="/concepts/multi-agent" icon="route">
+    ワークスペースの分離とエージェントごとのセッション。
+  </Card>
+  <Card title="セキュリティ" href="/gateway/security" icon="shield">
+    トークン、許可リスト、安全制御。
+  </Card>
+  <Card title="トラブルシューティング" href="/gateway/troubleshooting" icon="wrench">
+    Gatewayの診断と一般的なエラー。
+  </Card>
+  <Card title="概要とクレジット" href="/reference/credits" icon="info">
+    プロジェクトの起源、貢献者、ライセンス。
+  </Card>
+</Columns>
--- a/docs/ja-JP/start/getting-started.md
+++ 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
+---
+
+# はじめに
+
+目標：ゼロから最小限のセットアップで最初の動作するチャットを実現する。
+
+<Info>
+最速のチャット方法：Control UIを開く（チャンネル設定は不要）。`openclaw dashboard`を実行してブラウザでチャットするか、<Tooltip headline="Gatewayホスト" tip="OpenClaw Gatewayサービスを実行しているマシン。">Gatewayホスト</Tooltip>で`http://127.0.0.1:18789/`を開きます。
+ドキュメント：[Dashboard](/web/dashboard)と[Control UI](/web/control-ui)。
+</Info>
+
+## 前提条件
+
+- Node 22以降
+
+<Tip>
+不明な場合は`node --version`でNodeのバージョンを確認してください。
+</Tip>
+
+## クイックセットアップ（CLI）
+
+<Steps>
+  <Step title="OpenClawをインストール（推奨）">
+    <Tabs>
+      <Tab title="macOS/Linux">
+        ```bash
+        curl -fsSL https://openclaw.ai/install.sh | bash
+        ```
+      </Tab>
+      <Tab title="Windows (PowerShell)">
+        ```powershell
+        iwr -useb https://openclaw.ai/install.ps1 | iex
+        ```
+      </Tab>
+    </Tabs>
+
+    <Note>
+    その他のインストール方法と要件：[インストール](/install)。
+    </Note>
+
+  </Step>
+  <Step title="オンボーディングウィザードを実行">
+    ```bash
+    openclaw onboard --install-daemon
+    ```
+
+    ウィザードは認証、Gateway設定、およびオプションのチャンネルを構成します。
+    詳細は[オンボーディングウィザード](/start/wizard)を参照してください。
+
+  </Step>
+  <Step title="Gatewayを確認">
+    サービスをインストールした場合、すでに実行されているはずです：
+
+    ```bash
+    openclaw gateway status
+    ```
+
+  </Step>
+  <Step title="Control UIを開く">
+    ```bash
+    openclaw dashboard
+    ```
+  </Step>
+</Steps>
+
+<Check>
+Control UIが読み込まれれば、Gatewayは使用可能な状態です。
+</Check>
+
+## オプションの確認と追加機能
+
+<AccordionGroup>
+  <Accordion title="Gatewayをフォアグラウンドで実行">
+    クイックテストやトラブルシューティングに便利です。
+
+    ```bash
+    openclaw gateway --port 18789
+    ```
+
+  </Accordion>
+  <Accordion title="テストメッセージを送信">
+    構成済みのチャンネルが必要です。
+
+    ```bash
+    openclaw message send --target +15555550123 --message "Hello from OpenClaw"
+    ```
+
+  </Accordion>
+</AccordionGroup>
+
+## さらに詳しく
+
+<Columns>
+  <Card title="オンボーディングウィザード（詳細）" href="/start/wizard">
+    完全なCLIウィザードリファレンスと高度なオプション。
+  </Card>
+  <Card title="macOSアプリのオンボーディング" href="/start/onboarding">
+    macOSアプリの初回実行フロー。
+  </Card>
+</Columns>
+
+## 完了後の状態
+
+- 実行中のGateway
+- 構成済みの認証
+- Control UIアクセスまたは接続済みのチャンネル
+
+## 次のステップ
+
+- DMの安全性と承認：[ペアリング](/start/pairing)
+- さらにチャンネルを接続：[チャンネル](/channels)
+- 高度なワークフローとソースからのビルド：[セットアップ](/start/setup)
--- a/docs/ja-JP/start/wizard.md
+++ 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
+```
+
+<Info>
+最速で初回チャットを開始する方法：Control UI を開きます（チャンネル設定は不要）。`openclaw dashboard` を実行してブラウザでチャットできます。ドキュメント：[Dashboard](/web/dashboard)。
+</Info>
+
+## クイックスタート vs 詳細設定
+
+ウィザードは**クイックスタート**（デフォルト設定）と**詳細設定**（完全な制御）のどちらかを選択して開始します。
+
+<Tabs>
+  <Tab title="クイックスタート（デフォルト設定）">
+    - loopback上のローカルGateway
+    - 既存のワークスペースまたはデフォルトワークスペース
+    - Gatewayポート `18789`
+    - Gateway認証トークンは自動生成（loopback上でも生成されます）
+    - Tailscale公開はオフ
+    - TelegramとWhatsAppのDMはデフォルトで許可リスト（電話番号の入力を求められる場合があります）
+  </Tab>
+  <Tab title="詳細設定（完全な制御）">
+    - モード、ワークスペース、Gateway、チャンネル、デーモン、Skillsの完全なプロンプトフローを表示
+  </Tab>
+</Tabs>
+
+## CLIオンボーディングの詳細
+
+<Columns>
+  <Card title="CLIリファレンス" href="/start/wizard-cli-reference">
+    ローカルおよびリモートフローの完全な説明、認証とモデルマトリックス、設定出力、ウィザードRPC、signal-cliの動作。
+  </Card>
+  <Card title="自動化とスクリプト" href="/start/wizard-cli-automation">
+    非対話式オンボーディングのレシピと自動化された `agents add` の例。
+  </Card>
+</Columns>
+
+## よく使うフォローアップコマンド
+
+```bash
+openclaw configure
+openclaw agents add <name>
+```
+
+<Note>
+`--json` は非対話モードを意味しません。スクリプトでは `--non-interactive` を使用してください。
+</Note>
+
+<Tip>
+推奨：エージェントが `web_search` を使用できるように、Brave Search APIキーを設定してください（`web_fetch` はキーなしで動作します）。最も簡単な方法：`openclaw configure --section web` を実行すると `tools.web.search.apiKey` が保存されます。ドキュメント：[Webツール](/tools/web)。
+</Tip>
+
+## 関連ドキュメント
+
+- CLIコマンドリファレンス：[`openclaw onboard`](/cli/onboard)
+- macOSアプリのオンボーディング：[オンボーディング](/start/onboarding)
+- エージェント初回起動の手順：[エージェントブートストラップ](/start/bootstrapping)