構成

{
  channels: {
    telegram: {
      enabled: true,
      botToken: "123:abc",
      dmPolicy: "pairing",   // pairing | allowlist | open | disabled
      allowFrom: ["tg:123"], // only for allowlist/open
    },
  },
}

{
  agents: {
    defaults: {
      model: {
        primary: "anthropic/claude-sonnet-4-5",
        fallbacks: ["openai/gpt-5.2"],
      },
      models: {
        "anthropic/claude-sonnet-4-5": { alias: "Sonnet" },
        "openai/gpt-5.2": { alias: "GPT" },
      },
    },
  },
}
```- `agents.defaults.models` はモデル カタログを定義し、`/model` の許可リストとして機能します。
- モデル参照は `provider/model` 形式 (例: `anthropic/claude-opus-4-6`) を使用します。
- `agents.defaults.imageMaxDimensionPx` は、トランスクリプト/ツール イメージのダウンスケーリングを制御します (デフォルト `1200`)。通常、値を低くすると、スクリーンショットを大量に使用する実行時のビジョン トークンの使用量が減少します。
- チャットでのモデルの切り替えについては [モデル CLI](/concepts/models) を、認証ローテーションとフォールバックの動作については [モデル フェールオーバー](/concepts/model-failover) を参照してください。
- カスタム/セルフホストプロバイダーについては、リファレンスの [カスタムプロバイダー](/gateway/configuration-reference#custom-providers-and-base-urls) を参照してください。

</Accordion>

<Accordion title="ボットにメッセージを送信できる人を制御する">
DM アクセスは、`dmPolicy` を介してチャネルごとに制御されます。

- `"pairing"` (デフォルト): 不明な送信者は承認用の 1 回限りのペアリング コードを取得します。
- `"allowlist"`: `allowFrom` (またはペアの許可ストア) の送信者のみ
- `"open"`: すべての受信 DM を許可します (`allowFrom: ["*"]` が必要)
- `"disabled"`: すべての DM を無視します

グループの場合は、`groupPolicy` + `groupAllowFrom` またはチャネル固有の許可リストを使用します。

チャネルごとの詳細については、[完全なリファレンス](/gateway/configuration-reference#dm-and-group-access) を参照してください。

</Accordion>

<Accordion title="グループチャットのメンションゲートを設定する">
グループ メッセージはデフォルトで **メンションが必要** になっています。エージェントごとにパターンを構成します。

```json5
{
  agents: {
    list: [
      {
        id: "main",
        groupChat: {
          mentionPatterns: ["@openclaw", "openclaw"],
        },
      },
    ],
  },
  channels: {
    whatsapp: {
      groups: { "*": { requireMention: true } },
    },
  },
}
```- **メタデータのメンション**: ネイティブの @-メンション (WhatsApp のタップツーメンション、Telegram @bot など)
- **テキスト パターン**: `mentionPatterns` の正規表現パターン
- チャネルごとのオーバーライドとセルフチャット モードについては、[完全なリファレンス](/gateway/configuration-reference#group-chat-mention-gating) を参照してください。

</Accordion>

<Accordion title="セッションとリセットを構成する">
セッションは会話の継続性と分離を制御します。

```json5
{
  session: {
    dmScope: "per-channel-peer",  // recommended for multi-user
    threadBindings: {
      enabled: true,
      idleHours: 24,
      maxAgeHours: 0,
    },
    reset: {
      mode: "daily",
      atHour: 4,
      idleMinutes: 120,
    },
  },
}

{
  agents: {
    defaults: {
      sandbox: {
        mode: "non-main",  // off | non-main | all
        scope: "agent",    // session | agent | shared
      },
    },
  },
}

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m",
        target: "last",
      },
    },
  },
}
```- `every`: 期間文字列 (`30m`、`2h`)。 `0m` を無効に設定します。
- `target`: `last` | `whatsapp` | `telegram` | `discord` | `none`
- `directPolicy`: `allow` (デフォルト) または `block` (DM スタイルのハートビート ターゲットの場合)
- 完全なガイドについては、[ハートビート](/gateway/heartbeat) を参照してください。

</Accordion>

<Accordion title="cron ジョブを構成する">
```json5
{
  cron: {
    enabled: true,
    maxConcurrentRuns: 2,
    sessionRetention: "24h",
    runLog: {
      maxBytes: "2mb",
      keepLines: 2000,
    },
  },
}

{
  hooks: {
    enabled: true,
    token: "shared-secret",
    path: "/hooks",
    defaultSessionKey: "hook:ingress",
    allowRequestSessionKey: false,
    allowedSessionKeyPrefixes: ["hook:"],
    mappings: [
      {
        match: { path: "gmail" },
        action: "agent",
        agentId: "main",
        deliver: true,
      },
    ],
  },
}

{
  agents: {
    list: [
      { id: "home", default: true, workspace: "~/.openclaw/workspace-home" },
      { id: "work", workspace: "~/.openclaw/workspace-work" },
    ],
  },
  bindings: [
    { agentId: "home", match: { channel: "whatsapp", accountId: "personal" } },
    { agentId: "work", match: { channel: "whatsapp", accountId: "biz" } },
  ],
}

// ~/.openclaw/openclaw.json
{
  gateway: { port: 18789 },
  agents: { $include: "./agents.json5" },
  broadcast: {
    $include: ["./clients/a.json5", "./clients/b.json5"],
  },
}

openclaw gateway call config.get --params '{}'  # capture payload.hash
openclaw gateway call config.apply --params '{
  "raw": "{ agents: { defaults: { workspace: \"~/.openclaw/workspace\" } } }",
  "baseHash": "<hash>",
  "sessionKey": "agent:main:whatsapp:dm:+15555550123"
}'

openclaw gateway call config.patch --params '{
  "raw": "{ channels: { telegram: { groups: { \"*\": { requireMention: false } } } } }",
  "baseHash": "<hash>"
}'