개인 비서 설정

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가 설치되고 온보딩되어 있어야 합니다. 아직 하지 않았다면 시작하기를 참조하세요.
• 비서용 두 번째 전화번호(SIM/eSIM/선불)

​

두 전화기 설정(권장)

​

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 같은 마크다운 헤더만 있음) 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 앱
• 보안: 보안

​

관련 항목

• 시작하기
• 설정
• 채널 개요