---
x-i18n:
    generated_at: "2026-04-12T23:27:47Z"
    model: gpt-5.4
    provider: openai
    source_hash: 6805814012caac6ff64f17f44f393975510c5af3421fae9651ed9033e5861784
    source_path: AGENTS.md
    workflow: 15
---

# ドキュメントガイド

このディレクトリは、ドキュメント作成、Mintlify のリンク規則、およびドキュメント i18n ポリシーを管理します。

## Mintlify ルール

- ドキュメントは Mintlify (`https://docs.openclaw.ai`) でホストされています。
- `docs/**/*.md` 内の内部ドキュメントリンクは、`.md` または `.mdx` サフィックスなしのルート相対を維持する必要があります（例: `[Config](/configuration)`）。
- セクション間の相互参照では、ルート相対パスのアンカーを使用する必要があります（例: `[Hooks](/configuration#hooks)`）。
- Mintlify のアンカー生成はそれらに対して脆弱なため、ドキュメント見出しではエムダッシュやアポストロフィを避けてください。
- README やその他の GitHub でレンダリングされるドキュメントでは、GitHub の外でもリンクが機能するよう、絶対ドキュメント URL を維持してください。
- ドキュメント内容は汎用的なものに保つ必要があります。個人のデバイス名、ホスト名、ローカルパスは使用せず、`user@gateway-host` のようなプレースホルダーを使ってください。

## ドキュメント内容ルール

- ドキュメント、UI コピー、ピッカー一覧では、そのセクションが明示的に実行時順序や自動検出順序を説明している場合を除き、サービス/プロバイダーをアルファベット順に並べてください。
- バンドルされた Plugin の命名は、ルート `AGENTS.md` にあるリポジトリ全体の Plugin 用語ルールと一貫させてください。

## ドキュメント i18n

- このリポジトリでは外国語ドキュメントは保守されません。生成された公開出力は、別の `openclaw/docs` リポジトリにあります（ローカルでは `../openclaw-docs` としてクローンされていることがよくあります）。
- ここで `docs/<locale>/**` 配下のローカライズ済みドキュメントを追加または編集しないでください。
- このリポジトリ内の英語ドキュメントと用語集ファイルを正本として扱ってください。
- パイプライン: ここで英語ドキュメントを更新し、必要に応じて `docs/.i18n/glossary.<locale>.json` を更新し、その後 `openclaw/docs` で publish リポジトリの同期と `scripts/docs-i18n` の実行に任せてください。
- `scripts/docs-i18n` を再実行する前に、英語のまま維持する必要がある、または固定訳を使う必要がある新しい技術用語、ページタイトル、短いナビゲーションラベルについて用語集エントリを追加してください。
- `pnpm docs:check-i18n-glossary` は、変更された英語ドキュメントタイトルと短い内部ドキュメントラベルに対するガードです。
- 翻訳メモリは、publish リポジトリ内で生成される `docs/.i18n/*.tm.jsonl` ファイルにあります。
- `docs/.i18n/README.md` を参照してください。
