Agent coordination
목표
목표
목표는 현재 OpenClaw 세션에 연결된 지속적인 목적 하나입니다. 이는 장기 작업을 위해 에이전트와 운영자에게 공유 대상을 제공하지만, 그 대상을 백그라운드 작업, 알림, Cron 작업 또는 상시 지시로 바꾸지는 않습니다.
목표는 세션 상태입니다. 세션 키와 함께 이동하고, 프로세스 재시작 후에도
유지되며, /goal에 표시되고, 목표 도구를 통해 모델에서 사용할 수 있으며,
활성 세션에 목표가 있을 때 TUI 푸터에 나타납니다.
빠른 시작
목표 설정:
/goal start get CI green for PR 87469 and push the fix확인:
/goal작업이 의도적으로 대기 중일 때 일시 중지:
/goal pause waiting for CI다시 시작:
/goal resume완료로 표시:
/goal complete pushed and verified지우기:
/goal clear목표의 용도
여러 턴에 걸쳐 계속 표시되어야 하는 구체적인 결과가 세션에 있을 때 목표를 사용하세요.
- PR 마무리: 수정, 검증, 자동 리뷰, 푸시, PR 열기 또는 업데이트.
- 디버그 실행: 버그 재현, 소유 표면 식별, 패치, 수정 증명.
- 문서 작업: 관련 문서 읽기, 새 페이지 작성, 교차 링크 추가, 문서 빌드 검증.
- 유지보수 작업: 현재 상태 점검, 범위가 제한된 변경 수행, 적절한 검사 실행, 변경 사항 보고.
목표는 작업 큐가 아닙니다. 작업을 분리해서 실행하거나, 일정에 따라 반복하거나, 관리되는 하위 작업으로 확장하거나, 정책으로 지속해야 할 때는 TaskFlow, 작업, Cron 작업 또는 상시 지시를 사용하세요.
명령 참조
인수 없이 /goal을 실행하면 현재 목표 요약이 출력됩니다.
GoalStatus: activeObjective: get CI green for PR 87469 and push the fixTokens used: 12kToken budget: 12k/50k Commands: /goal pause, /goal complete, /goal clear명령:
/goal또는/goal status는 현재 목표를 표시합니다./goal start <objective>는 현재 세션에 새 목표를 만듭니다./goal set <objective>및/goal create <objective>는start의 별칭입니다./goal pause [note]는 활성 목표를 일시 중지합니다./goal resume [note]는 일시 중지됨, 차단됨, 사용량 제한됨 또는 예산 제한됨 상태의 목표를 다시 시작합니다./goal complete [note]는 목표를 달성됨으로 표시합니다./goal done [note]는complete의 별칭입니다./goal block [note]는 목표를 차단됨으로 표시합니다./goal blocked [note]는block의 별칭입니다./goal clear는 세션에서 목표를 제거합니다.
한 세션에는 한 번에 하나의 목표만 존재할 수 있습니다. 현재 목표를 지우기 전까지 두 번째 목표를 시작하면 실패합니다.
상태
목표는 작은 상태 집합을 사용합니다.
active: 세션이 목표를 추구하고 있습니다.paused: 운영자가 목표를 일시 중지했습니다./goal resume을 실행하면 다시 활성 상태가 됩니다.blocked: 에이전트 또는 운영자가 실제 차단 요소를 보고했습니다. 새 정보나 상태를 사용할 수 있을 때/goal resume을 실행하면 다시 활성 상태가 됩니다.budget_limited: 구성된 토큰 예산에 도달했습니다./goal resume을 실행하면 동일한 목적에서 다시 추구를 시작합니다.usage_limited: 사용량 제한 중지 상태를 위해 예약되어 있습니다. 허용되면/goal resume을 실행해 다시 추구를 시작합니다.complete: 목표가 달성되었습니다. 완료된 목표는 종료 상태입니다. 다른 목표를 시작하기 전에/goal clear를 사용하세요.
/new와 /reset은 의도적으로 새 세션 컨텍스트를 시작하므로 현재 세션 목표를
지웁니다.
토큰 예산
목표에는 선택적인 양수 토큰 예산을 둘 수 있습니다. 예산은 목표와 함께 저장되며, 생성 시점의 세션 새 토큰 수를 기준으로 측정됩니다. 목표가 시작될 때 현재 세션에 오래되었거나 알 수 없는 토큰 사용량만 있으면 OpenClaw는 다음 새 세션 토큰 스냅샷을 기다린 뒤 이를 기준선으로 사용하므로, 목표가 존재하기 전에 소비된 토큰은 목표에 부과되지 않습니다.
토큰 사용량이 예산에 도달하면 목표는 budget_limited로 변경됩니다. 이 동작은
목표를 삭제하거나 목적을 지우지 않습니다. 목표가 다시 시작되거나 지워질 때까지
더 이상 적극적으로 추구되지 않음을 운영자와 에이전트에게 알려줍니다.
토큰 예산은 세션 목표 보호 장치이지 과금 한도가 아닙니다. 공급자 할당량, 비용 보고, 컨텍스트 창 동작은 계속 일반 OpenClaw 사용량 및 모델 제어를 사용합니다.
모델 도구
OpenClaw는 에이전트 하네스에 세 가지 핵심 목표 도구를 노출합니다.
get_goal: 상태, 목적, 토큰 사용량, 토큰 예산을 포함해 현재 세션 목표를 읽습니다.create_goal: 사용자, 시스템 또는 개발자 지시가 명시적으로 요청한 경우에만 목표를 만듭니다. 세션에 이미 목표가 있으면 실패합니다.update_goal: 목표를complete또는blocked로 표시합니다.
모델은 목표를 조용히 일시 중지, 다시 시작, 지우기 또는 교체할 수 없습니다.
이들은 /goal 및 재설정 명령을 통한 운영자/세션 제어입니다. 이를 통해
에이전트가 조용히 대상을 옮기지 못하게 하면서도, 달성 또는 실제 차단 요소를
보고할 수 있는 깔끔한 경로를 유지합니다.
update_goal 도구는 목적이 실제로 달성된 경우에만 목표를 complete로 표시해야
합니다. 동일한 차단 조건이 반복되었고, 새 사용자 입력이나 외부 상태 변경 없이는
에이전트가 의미 있는 진전을 만들 수 없을 때만 목표를 blocked로 표시해야 합니다.
TUI
TUI는 에이전트, 세션, 모델, 실행 제어, 토큰 수 옆의 푸터에 활성 세션의 목표를 계속 표시합니다.
푸터 예:
- 토큰 예산이 있는 활성 목표의 경우
Pursuing goal (12k/50k). - 일시 중지된 목표의 경우
Goal paused (/goal resume). - 차단된 목표의 경우
Goal blocked (/goal resume). - 사용량 제한 목표의 경우
Goal hit usage limits (/goal resume). - 예산 제한 목표의 경우
Goal unmet (50k/50k). - 완료된 목표의 경우
Goal achieved (42k).
푸터는 의도적으로 간결합니다. 전체 목적, 참고, 토큰 예산, 사용 가능한 명령은
/goal을 사용하세요.
채널 동작
/goal 명령은 TUI와 텍스트 명령을 허용하는 채팅 표면을 포함해, 명령을 사용할 수
있는 OpenClaw 세션에서 작동합니다. 목표 상태는 전송 수단이 아니라 세션 키에
연결됩니다. 두 표면이 같은 세션을 사용하면 같은 목표를 봅니다.
목표 상태는 전달 지시가 아닙니다. 채널을 통해 답장을 강제하거나, 큐 동작을 변경하거나, 도구를 승인하거나, 작업을 예약하지 않습니다.
문제 해결
Goal error: goal already exists는 세션에 이미 목표가 있다는 뜻입니다. /goal로
확인하고, 완료되었다면 /goal complete를 사용하거나, 다른 목적을 시작하기 전에
/goal clear를 사용하세요.
Goal error: goal not found는 세션에 아직 목표가 없다는 뜻입니다.
/goal start <objective>로 목표를 시작하세요.
Goal error: goal is already complete는 목표가 종료 상태라는 뜻입니다.
다른 목적을 시작하거나 다시 시작하기 전에 지우세요.
토큰 사용량이 0처럼 보이거나 오래된 값으로 보인다면, 활성 세션에 아직 새 토큰
스냅샷이 없을 수 있습니다. OpenClaw가 세션 사용량과 대화 기록에서 파생된 합계를
기록하면 사용량이 새로 고쳐집니다.
