パーソナルアシスタントのセットアップ

​

⚠️ 安全第一

• マシン上でコマンドを実行する（Pi ツールのセットアップに依存）
• ワークスペース内のファイルの読み取り/書き込み
• WhatsApp/Telegram/Discord/Mattermost (プラグイン) を介したメッセージの送信

• 常に channels.whatsapp.allowFrom を設定してください（個人の Mac で世界中からアクセス可能な状態で実行しないでください）。
• アシスタント用に専用の WhatsApp 番号を使用してください。
• 現在、ハートビートはデフォルトで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 に記述します：

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

​

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

openclaw setup

{
  agent: {
    workspace: "~/.openclaw/workspace",
  },
}

{
  agent: {
    skipBootstrap: true,
  },
}

​

それを「アシスタント」に変える設定

• SOUL.md におけるペルソナ / 指示
• 思考のデフォルト（必要に応じて）
• ハートビート（信頼できるようになってから）

{
  logging: { level: "info" },
  agent: {
    model: "anthropic/claude-opus-4-6",
    workspace: "~/.openclaw/workspace",
    thinkingDefault: "high",
    timeoutSeconds: 1800,
    // 0から始め、後で有効にします。
    heartbeat: { every: "0m" },
  },
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: {
        "*": { requireMention: true },
      },
    },
  },
  routing: {
    groupChat: {
      mentionPatterns: ["@openclaw", "openclaw"],
    },
  },
  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（旧：~/.openclaw/sessions/sessions.json）
• /new または /reset は、そのチャットの新しいセッションを開始します（resetTriggers 経由で設定可能）。単独で送信された場合、エージェントはリセットを確認するために短い挨拶で返信します。
• /compact [instructions] はセッションコンテキストを圧縮し、残りのコンテキスト予算を報告します。

​

ハートビート（プロアクティブモード）

• HEARTBEAT.md は存在するが、実質的に空である（空白行と # Heading のようなマークダウンヘッダーのみ）場合、OpenClaw は API 呼び出しを節約するためにハートビートの実行をスキップします。
• ファイルが欠落している場合でも、ハートビートは実行され、モデルが何をすべきかを決定します。
• エージェントが HEARTBEAT_OK と返信した場合（オプションで短いパディングを使用できます。agents.defaults.heartbeat.ackMaxChars を参照）、OpenClaw はそのハートビートの外部への配信を抑制します。
• デフォルトでは、DM スタイルの user:<id> ターゲットへのハートビートの配信は許可されています。ハートビートの実行はアクティブにしたまま、ダイレクトターゲットへの配信を抑制するには、agents.defaults.heartbeat.directPolicy: "block" を設定します。
• ハートビートはエージェントのフルターンを実行します — 間隔を短くするとより多くのトークンを消費します。

{
  agent: {
    heartbeat: { every: "30m" },
  },
}

​

メディアの入出力

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

ここにスクリーンショットがあります。
MEDIA:https://example.com/screenshot.png

​

運用チェックリスト

openclaw status          # ローカルステータス（資格情報、セッション、キューに入っているイベント）
openclaw status --all    # 完全な診断（読み取り専用、貼り付け可能）
openclaw status --deep   # ゲートウェイのヘルスプローブを追加（Telegram + Discord）
openclaw health --json   # ゲートウェイヘルスのスナップショット（WS）

​

次のステップ

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