Personal assistant setup

Personal assistant setup 문서는 OpenClaw 공식 문서(start/openclaw)를 한국어로 정리한 가이드입니다. End-to-end guide for running OpenClaw as a personal assistant with safety cautions 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

End-to-end guide for running OpenClaw as a personal assistant with safety cautions

한국어 가이드 범위: start/openclaw 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

Safety first
사전 요구사항
The two-phone setup (recommended)
5-minute quick start
Give the agent a workspace (AGENTS)
The config that turns it into "an assistant"
Sessions and memory
Heartbeats (proactive mode)
Media in and out
Operations checklist
다음 단계
관련 문서

상세 내용

본문

OpenClaw is a self-hosted gateway that connects Discord, Google Chat, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo, and more to AI agents. This guide covers the "personal assistant" setup: a dedicated WhatsApp number that behaves like your always-on AI assistant.

Safety first

Giving an agent a channel puts it in a position to run commands on your machine (depending on your tool policy), read/write files in your workspace, and send messages back out via any connected channel. Start conservative:

주요 항목:

Always set channels.whatsapp.allowFrom (never run open-to-the-world on your personal Mac).
Use a dedicated WhatsApp number for the assistant.
Heartbeats default to every 30 minutes. Disable until you trust the setup by setting agents.defaults.heartbeat.every: "0m".

사전 요구사항

주요 항목:

OpenClaw installed and onboarded - see Getting Started if you haven't done this yet
A second phone number (SIM/eSIM/prepaid) for the assistant

The two-phone setup (recommended)

If you link your personal WhatsApp to OpenClaw, every message to you becomes "agent input". That's rarely what you want.

flowchart TB
    A["<b>Your Phone (personal)<br></b><br>Your WhatsApp<br>+1-555-YOU"] -- message --> B["<b>Second Phone (assistant)<br></b><br>Assistant WA<br>+1-555-ASSIST"]
    B -- linked via QR --> C["<b>Your Mac (openclaw)<br></b><br>AI agent"]

5-minute quick start

Pair WhatsApp Web (shows QR; scan with the assistant phone):

openclaw channels login

openclaw gateway --port 18789

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

Give the agent a workspace (AGENTS)

OpenClaw reads operating instructions and "memory" from its workspace directory.

openclaw setup --baseline

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

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

The config that turns it into "an assistant"

OpenClaw defaults to a good assistant setup, but you'll usually want to tune:

주요 항목:

persona/instructions in SOUL.md
thinking defaults (if desired)
heartbeats (once you trust it)

{
  logging: { level: "info" },
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-5" },
      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,
    },
  },
}

Sessions and memory

주요 항목:

Session rows, transcript rows, and metadata (token usage, last route, etc): ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite
Legacy/archive transcript artifacts: ~/.openclaw/agents/<agentId>/sessions/
Legacy row migration source: ~/.openclaw/agents/<agentId>/sessions/sessions.json
/new or /reset starts a fresh session for that chat (configurable via session.resetTriggers). If sent alone, OpenClaw acknowledges the reset without invoking the model.
/compact [instructions] compacts the session context and reports the remaining context budget.

Heartbeats (proactive mode)

By default, OpenClaw runs a heartbeat every 30 minutes with the prompt: Follow the heartbeat monitor scratch context when provided. Recurring tasks are cron jobs; create or change their schedules with cron tools or the openclaw cron CLI, not heartbeat scratch. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK. Set agents.defaults.heartbeat.every: "0m" to disable. Heartbeat checklists live in the monitor's cron scratch (see Heartbeat); openclaw doctor --fix migrates a legacy workspace HEARTBEAT.md into it.

주요 항목:

If the monitor scratch exists but is effectively empty (only blank lines, Markdown/HTML comments, Markdown headings like # Heading, fence markers, or empty checklist stubs), OpenClaw skips the heartbeat run to save API calls.
If no scratch exists, the heartbeat still runs and the model decides what to do.
If the agent replies with HEARTBEAT_OK (optionally with short padding; see agents.defaults.heartbeat.ackMaxChars), OpenClaw suppresses outbound delivery for that heartbeat.
By default, heartbeat delivery to DM-style user:<id> targets is allowed. Set agents.defaults.heartbeat.directPolicy: "block" to suppress direct-target delivery while keeping heartbeat runs active.
Heartbeats run full agent turns - shorter intervals burn more tokens.

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

Media in and out

Inbound attachments (images/audio/docs) can be surfaced to your command via templates:

주요 항목:

{{AttachmentPath}} (local temp file path)
{{AttachmentUrl}} (original URL or provider reference)
{{AttachmentContentType}} (MIME content type)
{{AttachmentDir}} (directory containing the local path)
{{AttachmentIndex}} (zero-based source fact index)
{{Transcript}} (if audio transcription is enabled)
If tools.fs.workspaceOnly is true, outbound local media paths stay restricted to the OpenClaw temp root, the media cache, agent workspace paths, and sandbox-generated files.
If tools.fs.workspaceOnly is false, outbound local media can use host-local files the agent is already allowed to read.
Local paths can be absolute, workspace-relative, or home-relative with ~/.
Host-local sends still only allow media and safe document types (images, audio, video, PDF, Office documents, and validated text documents such as Markdown/MD, TXT, JSON, YAML, and YML). This is an extension of the existing host-read trust boundary, not a secret scanner: if the agent can read a host-local secret.txt or config.json, it can attach that file when the extension and content validation match.

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

Operations checklist

Logs live under /tmp/openclaw/: openclaw-YYYY-MM-DD.log for the default profile and openclaw--YYYY-MM-DD.log for named profiles.

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 ops: Gateway runbook
Cron + wakeups: Cron jobs
macOS menu bar companion: OpenClaw macOS app
iOS node app: iOS app
Android node app: Android app
Windows Hub: Windows
Linux status: Linux app
Security: Security

실습 체크리스트

공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/start/openclaw
관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

flowchart TB
    A["<b>Your Phone (personal)<br></b><br>Your WhatsApp<br>+1-555-YOU"] -- message --> B["<b>Second Phone (assistant)<br></b><br>Assistant WA<br>+1-555-ASSIST"]
    B -- linked via QR --> C["<b>Your Mac (openclaw)<br></b><br>AI agent"]

openclaw channels login

openclaw gateway --port 18789

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

openclaw setup --baseline

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

Personal assistant setup

핵심 요약

End-to-end guide for running OpenClaw as a personal assistant with safety cautions

한국어 가이드 범위: start/openclaw 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

Safety first
사전 요구사항
The two-phone setup (recommended)
5-minute quick start
Give the agent a workspace (AGENTS)
The config that turns it into "an assistant"
Sessions and memory
Heartbeats (proactive mode)
Media in and out
Operations checklist
다음 단계
관련 문서

상세 내용

본문

Safety first

주요 항목:

Always set channels.whatsapp.allowFrom (never run open-to-the-world on your personal Mac).
Use a dedicated WhatsApp number for the assistant.
Heartbeats default to every 30 minutes. Disable until you trust the setup by setting agents.defaults.heartbeat.every: "0m".

사전 요구사항

주요 항목:

OpenClaw installed and onboarded - see Getting Started if you haven't done this yet
A second phone number (SIM/eSIM/prepaid) for the assistant

The two-phone setup (recommended)

If you link your personal WhatsApp to OpenClaw, every message to you becomes "agent input". That's rarely what you want.

flowchart TB
    A["<b>Your Phone (personal)<br></b><br>Your WhatsApp<br>+1-555-YOU"] -- message --> B["<b>Second Phone (assistant)<br></b><br>Assistant WA<br>+1-555-ASSIST"]
    B -- linked via QR --> C["<b>Your Mac (openclaw)<br></b><br>AI agent"]

5-minute quick start

Pair WhatsApp Web (shows QR; scan with the assistant phone):

openclaw channels login

openclaw gateway --port 18789

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

Give the agent a workspace (AGENTS)

OpenClaw reads operating instructions and "memory" from its workspace directory.

openclaw setup --baseline

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

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

The config that turns it into "an assistant"

OpenClaw defaults to a good assistant setup, but you'll usually want to tune:

주요 항목:

persona/instructions in SOUL.md
thinking defaults (if desired)
heartbeats (once you trust it)

{
  logging: { level: "info" },
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-5" },
      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,
    },
  },
}

Sessions and memory

주요 항목:

Session rows, transcript rows, and metadata (token usage, last route, etc): ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite
Legacy/archive transcript artifacts: ~/.openclaw/agents/<agentId>/sessions/
Legacy row migration source: ~/.openclaw/agents/<agentId>/sessions/sessions.json
/new or /reset starts a fresh session for that chat (configurable via session.resetTriggers). If sent alone, OpenClaw acknowledges the reset without invoking the model.
/compact [instructions] compacts the session context and reports the remaining context budget.

Heartbeats (proactive mode)

주요 항목:

If the monitor scratch exists but is effectively empty (only blank lines, Markdown/HTML comments, Markdown headings like # Heading, fence markers, or empty checklist stubs), OpenClaw skips the heartbeat run to save API calls.
If no scratch exists, the heartbeat still runs and the model decides what to do.
If the agent replies with HEARTBEAT_OK (optionally with short padding; see agents.defaults.heartbeat.ackMaxChars), OpenClaw suppresses outbound delivery for that heartbeat.
By default, heartbeat delivery to DM-style user:<id> targets is allowed. Set agents.defaults.heartbeat.directPolicy: "block" to suppress direct-target delivery while keeping heartbeat runs active.
Heartbeats run full agent turns - shorter intervals burn more tokens.

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

Media in and out

Inbound attachments (images/audio/docs) can be surfaced to your command via templates:

주요 항목:

{{AttachmentPath}} (local temp file path)
{{AttachmentUrl}} (original URL or provider reference)
{{AttachmentContentType}} (MIME content type)
{{AttachmentDir}} (directory containing the local path)
{{AttachmentIndex}} (zero-based source fact index)
{{Transcript}} (if audio transcription is enabled)
If tools.fs.workspaceOnly is true, outbound local media paths stay restricted to the OpenClaw temp root, the media cache, agent workspace paths, and sandbox-generated files.
If tools.fs.workspaceOnly is false, outbound local media can use host-local files the agent is already allowed to read.
Local paths can be absolute, workspace-relative, or home-relative with ~/.
Host-local sends still only allow media and safe document types (images, audio, video, PDF, Office documents, and validated text documents such as Markdown/MD, TXT, JSON, YAML, and YML). This is an extension of the existing host-read trust boundary, not a secret scanner: if the agent can read a host-local secret.txt or config.json, it can attach that file when the extension and content validation match.

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

Operations checklist

Logs live under /tmp/openclaw/: openclaw-YYYY-MM-DD.log for the default profile and openclaw--YYYY-MM-DD.log for named profiles.

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 ops: Gateway runbook
Cron + wakeups: Cron jobs
macOS menu bar companion: OpenClaw macOS app
iOS node app: iOS app
Android node app: Android app
Windows Hub: Windows
Linux status: Linux app
Security: Security

실습 체크리스트

공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/start/openclaw
관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

flowchart TB
    A["<b>Your Phone (personal)<br></b><br>Your WhatsApp<br>+1-555-YOU"] -- message --> B["<b>Second Phone (assistant)<br></b><br>Assistant WA<br>+1-555-ASSIST"]
    B -- linked via QR --> C["<b>Your Mac (openclaw)<br></b><br>AI agent"]

openclaw channels login

openclaw gateway --port 18789

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

openclaw setup --baseline

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

Personal assistant setup

핵심 요약

문서 구성

상세 내용

본문

Safety first

사전 요구사항

The two-phone setup (recommended)

5-minute quick start

Give the agent a workspace (AGENTS)

The config that turns it into "an assistant"

Sessions and memory

Heartbeats (proactive mode)

Media in and out

Operations checklist

다음 단계

관련 문서

실습 체크리스트

자주 쓰는 명령·설정 예시

관련 링크

관련 가이드

Personal assistant setup

핵심 요약

문서 구성

상세 내용

본문

Safety first

사전 요구사항

The two-phone setup (recommended)

5-minute quick start

Give the agent a workspace (AGENTS)

The config that turns it into "an assistant"

Sessions and memory

Heartbeats (proactive mode)

Media in and out

Operations checklist

다음 단계

관련 문서

실습 체크리스트

자주 쓰는 명령·설정 예시

관련 링크

관련 가이드