個人アシスタントのセットアップ

​

まず安全性

• 必ず channels.whatsapp.allowFrom を設定します（個人用 Mac で世界中に開放した状態で実行しないでください）。
• アシスタント用に専用の WhatsApp 番号を使います。
• Heartbeat のデフォルトは 30 分ごとです。セットアップを信頼できるまで、agents.defaults.heartbeat.every: "0m" を設定して無効化してください。

​

前提条件

• OpenClaw がインストール済みでオンボーディング済みであること - まだの場合は はじめに を参照してください
• アシスタント用の 2 つ目の電話番号（SIM/eSIM/プリペイド）

​

2 台の電話セットアップ（推奨）

​

5 分のクイックスタート

1. WhatsApp Web をペアリングします（QR が表示されます。アシスタント用の電話でスキャンします）。

openclaw channels login

2. Gateway を起動します（実行したままにします）。

openclaw gateway --port 18789

3. 最小構成を ~/.openclaw/openclaw.json に入れます。

{
  gateway: { mode: "local" },
  channels: { whatsapp: { allowFrom: ["+15555550123"] } },
}

​

エージェントにワークスペースを与える（AGENTS）

openclaw setup --baseline

{
  agents: {
    defaults: {
      workspace: "~/.openclaw/workspace",
    },
  },
}

{
  agents: {
    defaults: {
      skipBootstrap: true,
    },
  },
}

​

「アシスタント」にする設定

• SOUL.md 内のペルソナ/指示
• thinking のデフォルト（必要な場合）
• Heartbeat（信頼できるようになった後）

{
  logging: { level: "info" },
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-8" },
      workspace: "~/.openclaw/workspace",
      thinkingDefault: "high",
      timeoutSeconds: 1800,
      // Start with 0; enable later.
      heartbeat: { every: "0m" },
    },
    list: [
      {
        id: "main",
        default: true,
        groupChat: {
          mentionPatterns: ["@openclaw", "openclaw"],
        },
      },
    ],
  },
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: {
        "*": { requireMention: true },
      },
    },
  },
  session: {
    scope: "per-sender",
    resetTriggers: ["/new", "/reset"],
    reset: {
      mode: "daily",
      atHour: 4,
      idleMinutes: 10080,
    },
  },
}

​

セッションとメモリ

• セッションファイル: ~/.openclaw/agents/<agentId>/sessions/{{SessionId}}.jsonl
• セッションメタデータ（トークン使用量、最後のルートなど）: ~/.openclaw/agents/<agentId>/sessions/sessions.json
• /new または /reset は、そのチャットの新しいセッションを開始します（session.resetTriggers で設定可能）。単独で送信された場合、OpenClaw はモデルを呼び出さずにリセットを確認します。
• /compact [instructions] はセッションコンテキストを compact し、残りのコンテキスト予算を報告します。

​

Heartbeat（プロアクティブモード）

• HEARTBEAT.md が存在するものの実質的に空（空行のみ、Markdown/HTML コメント、# Heading のような Markdown 見出し、フェンスマーカー、または空のチェックリストスタブのみ）の場合、OpenClaw は API 呼び出しを節約するため Heartbeat 実行をスキップします。
• ファイルが存在しない場合でも Heartbeat は実行され、モデルが何をするかを判断します。
• エージェントが HEARTBEAT_OK を返した場合（短い埋め文字を任意で含められます。agents.defaults.heartbeat.ackMaxChars を参照）、OpenClaw はその Heartbeat の送信を抑制します。
• デフォルトでは、DM 形式の user:<id> ターゲットへの Heartbeat 配信は許可されています。Heartbeat 実行を有効にしたまま直接ターゲットへの配信を抑制するには、agents.defaults.heartbeat.directPolicy: "block" を設定します。
• Heartbeat は完全なエージェントターンを実行します - 間隔を短くすると、より多くのトークンを消費します。

{
  agents: {
    defaults: {
      heartbeat: { every: "30m" },
    },
  },
}

​

メディアの入出力

• {{MediaPath}}（ローカル一時ファイルパス）
• {{MediaUrl}}（疑似 URL）
• {{Transcript}}（音声文字起こしが有効な場合）

{
  "message": "Here's the screenshot.",
  "mediaUrl": "https://example.com/screenshot.png"
}

• tools.fs.workspaceOnly が true の場合、送信ローカルメディアパスは OpenClaw 一時ルート、メディアキャッシュ、エージェントワークスペースパス、サンドボックス生成ファイルに制限されます。
• tools.fs.workspaceOnly が false の場合、送信ローカルメディアは、エージェントがすでに読み取りを許可されているホストローカルファイルを使用できます。
• ローカルパスは、絶対パス、ワークスペース相対、または ~/ を使ったホーム相対にできます。
• ホストローカル送信でも、メディアと安全なドキュメント種別（画像、音声、動画、PDF、Office ドキュメント、Markdown/MD、TXT、JSON、YAML、YML など検証済みのテキストドキュメント）のみが許可されます。これは既存のホスト読み取り信頼境界の拡張であり、シークレットスキャナーではありません。エージェントがホストローカルの secret.txt や config.json を読み取れる場合、拡張子と内容検証が一致すれば、そのファイルを添付できます。

​

運用チェックリスト

openclaw status          # local status (creds, sessions, queued events)
openclaw status --all    # full diagnosis (read-only, pasteable)
openclaw status --deep   # probe channels (WhatsApp Web + Telegram + Discord + Slack + Signal)
openclaw health --json   # gateway health snapshot over the WS connection

​

次のステップ

• WebChat: WebChat
• Gateway 運用: Gateway ランブック
• Cron + ウェイクアップ: Cron ジョブ
• macOS メニューバーコンパニオン: OpenClaw macOS アプリ
• iOS ノードアプリ: iOS アプリ
• Android ノードアプリ: Android アプリ
• Windows Hub: Windows
• Linux ステータス: Linux アプリ
• セキュリティ: セキュリティ

​

関連

• はじめに
• セットアップ
• チャンネル概要