메인 콘텐츠로 건너뛰기

Documentation Index

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

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

진행 초안은 장시간 실행되는 에이전트 턴이 채팅에서 살아 움직이는 것처럼 느껴지게 하면서도 대화를 임시 상태 답장 더미로 만들지 않습니다. 진행 초안을 활성화하면 OpenClaw는 턴이 실제 작업을 하고 있음이 확인된 뒤에만 보이는 작업 진행 중 메시지를 하나 만들고, 에이전트가 읽기, 계획 수립, 도구 호출, 승인 대기 등을 하는 동안 이를 업데이트한 다음, 채널이 안전하게 처리할 수 있을 때 그 초안을 최종 답변으로 전환합니다. 
Shelling...
📖 from docs/concepts/progress-drafts.md
🔎 Web Search: for "discord edit message"
🛠️ Bash: run tests
도구를 많이 쓰는 작업 중에는 깔끔한 상태 메시지 하나를 보여주고, 턴이 끝나면 최종 답변을 보여주고 싶을 때 진행 초안을 사용하세요.

​
빠른 시작

채널별로 streaming.mode: "progress"를 설정해 진행 초안을 활성화합니다. 
{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
      },
    },
  },
}
대개 이 설정만으로 충분합니다. OpenClaw는 자동 한 단어 라벨을 선택하고, 작업이 최소 5초 동안 지속되거나 두 번째 작업 이벤트가 발생할 때까지 기다린 뒤, 유용한 작업이 진행되는 동안 간결한 진행 줄을 추가하고, 해당 턴의 중복 독립 진행 메시지를 억제합니다.

​
사용자가 보는 것

진행 초안은 두 부분으로 구성됩니다.
부분목적
라벨Thinking... 또는 Shelling... 같은 짧은 시작/상태 줄입니다.
진행 줄자세한 출력과 동일한 도구 아이콘 및 세부 형식기를 사용하는 간결한 실행 업데이트입니다.
라벨은 에이전트가 의미 있는 작업을 시작한 뒤 5초 동안 계속 바쁘거나 두 번째 작업 이벤트를 발생시키면 표시됩니다. 라벨은 순환 진행 줄 목록의 일부이므로, 충분한 구체적 작업이 나타나면 시작 상태는 스크롤되어 사라집니다. 일반 텍스트만 있는 답장에는 진행 초안이 표시되지 않습니다. 진행 줄은 에이전트가 유용한 작업 업데이트를 발생시킬 때만 추가됩니다. 예를 들면 🛠️ Bash: run tests, 🔎 Web Search: for "discord edit message", ✍️ Write: to /tmp/file 같은 항목입니다. 기본적으로 /verbose와 동일한 간결한 설명 모드를 사용합니다. 디버깅 중이고 원시 명령/세부 정보도 함께 붙이고 싶다면 agents.defaults.toolProgressDetail: "raw"를 설정하세요. 가능하면 최종 답변이 초안을 대체합니다. 그렇지 않으면 OpenClaw는 최종 답변을 일반 방식으로 보내고, 채널의 전송 방식에 따라 초안을 정리하거나 업데이트를 중단합니다.

​
모드 선택

channels.<channel>.streaming.mode는 보이는 진행 중 동작을 제어합니다.
모드적합한 경우채팅에 표시되는 내용
off조용한 채널최종 답변만 표시됩니다.
partial답변 텍스트가 나타나는 모습을 보는 경우최신 답변 텍스트로 편집되는 초안 하나입니다.
block더 큰 답변 미리보기 청크더 큰 청크로 업데이트되거나 추가되는 미리보기 하나입니다.
progress도구를 많이 쓰거나 오래 실행되는 턴상태 초안 하나, 그다음 최종 답변입니다.
사용자가 답변 텍스트가 토큰 단위로 스트리밍되는 것보다 “무슨 일이 일어나고 있는지”를 더 중요하게 볼 때 progress를 선택하세요. 답변 자체가 진행 신호일 때는 partial을 선택하세요. 더 큰 텍스트 청크로 초안 미리보기 업데이트를 원할 때는 block을 선택하세요. Discord와 Telegram에서 streaming.mode: "block"은 여전히 미리보기 스트리밍이며, 일반 블록 전달이 아닙니다. 일반 블록 답장을 원할 때는 streaming.block.enabled 또는 레거시 blockStreaming을 사용하세요.

​
라벨 구성

진행 라벨은 channels.<channel>.streaming.progress 아래에 있습니다. 기본 라벨은 auto이며, OpenClaw에 내장된 줄임표가 붙은 단일 단어 라벨 풀에서 선택합니다. 
Thinking...
Shelling...
Scuttling...
Clawing...
Pinching...
Molting...
Bubbling...
Tiding...
Reefing...
Cracking...
Sifting...
Brining...
Nautiling...
Krilling...
Barnacling...
Lobstering...
Tidepooling...
Pearling...
Snapping...
Surfacing...
고정 라벨을 사용합니다. 
{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          label: "Investigating",
        },
      },
    },
  },
}
자체 자동 라벨 풀을 사용합니다. 
{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          label: "auto",
          labels: ["Checking", "Reading", "Testing", "Finishing"],
        },
      },
    },
  },
}
라벨을 숨기고 진행 줄만 표시합니다. 
{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          label: false,
        },
      },
    },
  },
}

​
진행 줄 제어

진행 줄은 진행 모드에서 기본적으로 활성화됩니다. 진행 줄은 실제 실행 이벤트, 즉 도구 시작, 항목 업데이트, 작업 계획, 승인, 명령 출력, 패치 요약, 그 밖의 유사한 에이전트 활동에서 나옵니다. OpenClaw는 진행 초안과 /verbose에 동일한 형식기를 사용합니다. 
{
  agents: {
    defaults: {
      toolProgressDetail: "explain", // explain | raw
    },
  },
}
"explain"이 기본값이며 🛠️ check JS syntax for /tmp/app.js처럼 간결한 라벨로 초안을 안정적으로 유지합니다. "raw"는 사용할 수 있을 때 기반 명령/세부 정보를 덧붙이므로 디버깅 중에는 유용하지만 채팅에서는 더 시끄러울 수 있습니다. 예를 들어 같은 명령도 세부 모드에 따라 다르게 표시됩니다.
모드진행 줄
explain🛠️ check JS syntax for /tmp/app.js
raw🛠️ check JS syntax for /tmp/app.js, node --check /tmp/app.js
보이는 줄 수를 제한합니다. 
{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          maxLines: 4,
        },
      },
    },
  },
}
초안이 편집되는 동안 채팅 말풍선 재배치를 줄이기 위해 진행 줄은 자동으로 압축됩니다. OpenClaw는 반복되는 초안 편집이 업데이트마다 다르게 줄바꿈되지 않도록 긴 진행 줄을 기본적으로 잘라냅니다. 접두사는 읽기 쉽게 유지되고, 경로나 원시 명령 같은 긴 세부 정보는 줄임표로 축약됩니다. Slack은 진행 줄을 단일 텍스트 본문 대신 구조화된 Block Kit 필드로 렌더링할 수 있습니다. 
{
  channels: {
    slack: {
      streaming: {
        mode: "progress",
        progress: {
          render: "rich",
        },
      },
    },
  },
}
리치 렌더링은 동일한 일반 텍스트 대체 표시를 유지하므로, 더 풍부한 형태를 지원하지 않는 채널과 클라이언트도 간결한 진행 텍스트를 계속 표시할 수 있습니다. 단일 진행 초안은 유지하되 도구 및 작업 줄은 숨깁니다. 
{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          toolProgress: false,
        },
      },
    },
  },
}
toolProgress: false를 사용하면 OpenClaw는 해당 턴의 이전 독립 도구 진행 메시지도 계속 억제합니다. 라벨이 구성된 경우를 제외하면, 채널은 최종 답변이 나올 때까지 시각적으로 조용하게 유지됩니다.

​
채널 동작

각 채널은 지원하는 가장 깔끔한 전송 방식을 사용합니다.
채널진행 전송 방식참고
Discord메시지 하나를 보낸 뒤 편집합니다.최종 텍스트가 안전한 미리보기 메시지 하나에 들어가면 제자리에서 편집됩니다.
Matrix이벤트 하나를 보낸 뒤 편집합니다.계정 수준 스트리밍 구성이 계정 수준 초안을 제어합니다.
Microsoft Teams개인 채팅에서 네이티브 Teams 스트림입니다.streaming.mode: "block"은 Teams 블록 전달에 매핑됩니다.
Slack네이티브 스트림 또는 편집 가능한 초안 게시물입니다.스레드 사용 가능 여부가 네이티브 스트리밍 사용 가능 여부에 영향을 줍니다.
Telegram메시지 하나를 보낸 뒤 편집합니다.최종 타임스탬프를 유용하게 유지하기 위해 오래된 보이는 초안이 대체될 수 있습니다.
Mattermost편집 가능한 초안 게시물입니다.도구 활동은 동일한 초안 스타일 게시물로 접힙니다.
안전한 편집 지원이 없는 채널은 일반적으로 입력 중 표시기 또는 최종 전용 전달로 대체됩니다.

​
마무리

최종 답변이 준비되면 OpenClaw는 채팅을 깔끔하게 유지하려고 합니다.
  • 초안이 안전하게 최종 답변이 될 수 있으면 OpenClaw가 제자리에서 편집합니다.
  • 채널이 네이티브 진행 스트리밍을 사용하는 경우, 네이티브 전송 방식이 최종 텍스트를 수락하면 OpenClaw가 해당 스트림을 마무리합니다.
  • 최종 답변에 미디어, 승인 프롬프트, 명시적 답장 대상, 너무 많은 청크가 있거나 편집/전송이 실패한 경우, OpenClaw는 일반 채널 전달 경로를 통해 최종 답변을 보냅니다.
대체 경로는 의도된 동작입니다. 텍스트를 잃거나, 답장이 잘못된 스레드에 달리거나, 채널이 안전하게 표현할 수 없는 페이로드로 초안을 덮어쓰는 것보다 새 최종 답변을 보내는 편이 낫습니다.

​
문제 해결

최종 답변만 보입니다. 메시지를 처리한 계정 또는 채널에 대해 channels.<channel>.streaming.mode가 progress로 설정되어 있는지 확인하세요. 일부 그룹 또는 인용 답장 경로에서는 채널이 올바른 메시지를 안전하게 편집할 수 없을 때 해당 턴의 초안 미리보기가 비활성화될 수 있습니다. 라벨은 보이지만 도구 줄은 보이지 않습니다. streaming.progress.toolProgress를 확인하세요. 이 값이 false이면 OpenClaw는 단일 초안 동작을 유지하지만 도구 및 작업 진행 줄을 숨깁니다. 편집된 초안 대신 새 최종 메시지가 보입니다. 이는 안전 대체 동작입니다. 미디어 답장, 긴 답변, 명시적 답장 대상, 오래된 Telegram 초안, 누락된 Slack 스레드 대상, 삭제된 미리보기 메시지, 또는 네이티브 스트림 마무리 실패 때문에 발생할 수 있습니다. 독립 진행 메시지가 여전히 보입니다. 진행 모드는 초안이 활성화되어 있을 때 기본 독립 도구 진행 메시지를 억제합니다. 독립 메시지가 계속 표시된다면, 해당 턴이 실제로 진행 모드를 사용하고 있는지, 그리고 streaming.mode: "off" 또는 해당 메시지에 대한 초안을 만들 수 없는 채널 경로가 아닌지 확인하세요. Teams가 Discord 또는 Telegram과 다르게 동작합니다. Microsoft Teams는 일반적인 보내기-편집 미리보기 전송 방식 대신 개인 채팅에서 네이티브 스트림을 사용합니다. 또한 Teams는 streaming.mode: "block"을 Teams 블록 전달로 처리합니다. Discord와 Telegram에서 사용하는 동일한 초안 미리보기 블록 모드가 없기 때문입니다.

​
관련 문서