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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

⚠️ まず安全性

• マシン上でコマンドを実行する（ツールポリシーによる）
• ワークスペース内のファイルを読み書きする
• WhatsApp/Telegram/Discord/Mattermost やその他の同梱チャンネル経由でメッセージを送信する

• 必ず 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

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

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

​

「アシスタント」にするための構成

• SOUL.md のペルソナ/指示
• 思考のデフォルト（必要な場合）
• Heartbeat（信頼できるようになってから）

{
  logging: { level: "info" },
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" },
      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（レガシー: ~/.openclaw/sessions/sessions.json）
• /new または /reset は、そのチャットの新しいセッションを開始します（resetTriggers で構成可能）。単独で送信された場合、OpenClaw はモデルを呼び出さずにリセットを確認応答します。
• /compact [instructions] はセッションコンテキストを圧縮し、残りのコンテキスト予算を報告します。

​

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

• HEARTBEAT.md が存在していても実質的に空（空行と # 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}}（音声文字起こしが有効な場合）

Here's the screenshot.
MEDIA:https://example.com/screenshot.png

• tools.fs.workspaceOnly が true の場合、送信 MEDIA: のローカルパスは OpenClaw の一時ルート、メディアキャッシュ、エージェントワークスペースパス、サンドボックスで生成されたファイルに制限されたままです。
• tools.fs.workspaceOnly が false の場合、送信 MEDIA: は、エージェントがすでに読み取りを許可されているホストローカルファイルを使用できます。
• ローカルパスは、絶対パス、ワークスペース相対パス、または ~/ を使ったホーム相対パスにできます。
• ホストローカル送信では、引き続きメディアと安全なドキュメントタイプ（画像、音声、動画、PDF、Office ドキュメント）のみが許可されます。プレーンテキストやシークレットに見えるファイルは、送信可能なメディアとして扱われません。

​

運用チェックリスト

openclaw status          # local status (creds, sessions, queued events)
openclaw status --all    # full diagnosis (read-only, pasteable)
openclaw status --deep   # asks the gateway for a live health probe with channel probes when supported
openclaw health --json   # gateway health snapshot (WS; default can return a fresh cached snapshot)

​

次のステップ

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

​

関連

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