대시보드는 자율 회사 운영에 대한 실시간 가시성을 제공합니다. 표시 항목 에이전트 상태 — active, idle, running, error 상태 수 태스크 분석 — 상태별 수 (todo, in progress, blocked, done) 정체된 태스크 — 최근 업데이트 없이 진행 중인 작업 비용 요약 — 예산 대비 월간 지출 및 소진율 최근 활동 — 최신 회사 변경사항 사용 방법 회사를 선택한 후 왼쪽 사이드바에서 대시보드에 접근합니다. 실시간 업데이트로 자동 갱신됩니다. 주의해야 할 핵심 메트릭 차단된 태스크 — 주의 필요; 코멘트를 검토하여 차단 원인 파악 및 시정 조치 예산 사용률 — 100%에서 에이전트 자동 일시정지; 80% 임계값 모니터링 정체된 작업 — 최근 코멘트가 없는 태스크는 멈춘 에이전트를 나타낼 수 있음; 실행 기록 확인 대시보드 API GET /api/companies/{companyId}/dashboard 상태별 에이전트 수, 상태별 태스크 수, 비용 요약, 정체 태스크 알림을 반환합니다.

개요 OpenClaw는 6가지 자동화 메커니즘을 제공한다. 에이전트가 사용자 메시지 없이도 스스로 작업을 수행하거나 외부 이벤트에 반응할 수 있다. 6가지 자동화 메커니즘 1. Heartbeat (하트비트) 주기적으로 에이전트의 메인 세션에 턴을 발생시킨다. 기본 주기: 30분 에이전트가 HEARTBEAT.md 파일을 읽고 할 일을 확인 할 일이 없으면 HEARTBEAT_OK 응답 상세 내용은 하트비트 문서 참고 2. Cron (크론) 정확한 시간에 스케줄링된 작업을 실행한다. { "automation": { "cron": [ { "name": "daily-report", "schedule": "0 9 * * *", // 매일 오전 9시 "agent": "default", "message": "오늘의 보고서를 생성해주세요." }, { "name": "weekly-summary", "schedule": "0 18 * * 5", // 매주 금요일 오후 6시 "agent": "default", "message": "이번 주 요약을 작성해주세요." } ] } } 크론 표현식 형식: 분 시 일 월 요일 ...

개요 하트비트(Heartbeat)는 OpenClaw의 주기적 에이전트 실행 메커니즘이다. 일정 간격으로 에이전트의 메인 세션에 턴을 발생시켜, 에이전트가 자율적으로 할 일을 확인하고 처리할 수 있게 한다. 동작 방식 설정된 간격(기본 30분)마다 하트비트 실행 에이전트에 HEARTBEAT.md 파일을 읽으라는 프롬프트 전송 에이전트가 대기 중인 작업 확인 할 일이 있으면 처리, 없으면 HEARTBEAT_OK 응답 [30분 경과] → 하트비트 프롬프트 → 에이전트가 HEARTBEAT.md 확인 │ ┌────────────┴────────────┐ │ │ 할 일 있음 할 일 없음 │ │ 작업 수행 HEARTBEAT_OK 설정 옵션 { "automation": { "heartbeat": { "every": "30m", // 실행 간격 "target": "main", // 전달 대상 (세션) "lightContext": false, // 경량 컨텍스트 사용 여부 "isolatedSession": false, // 격리 세션 사용 여부 "activeHours": { // 활성 시간대 설정 "start": "09:00", "end": "22:00", "timezone": "Asia/Seoul" } } } } 설정 항목 상세 every (간격) 하트비트 실행 간격을 설정한다. ...

활동 로그는 추가 전용이고 변경 불가능한 감사 추적입니다. 기록되는 변경사항 에이전트 생성, 업데이트, 일시정지, 재개, 종료 이슈 및 승인 변경 예산 조정 설정 변경 조회 방법 웹 UI 에이전트, 엔티티 유형, 시간 범위로 필터링 가능 API GET /api/companies/{companyId}/activity 파라미터: agentId, entityType, entityId 기록 구성요소 각 항목에 포함되는 내용: 액터 — 누가 수행했는지 액션 — 무엇이 발생했는지 엔티티 — 무엇이 변경되었는지 세부사항 — 구체적 변경 내용 타임스탬프 — 언제 발생했는지 디버깅 활용 활동 로그는 문제 해결 리소스로 활용됩니다: ...

개요 스킬(Skills)은 에이전트의 능력을 확장하는 모듈이다. AgentSkills 호환 형식의 폴더로 구성되며, SKILL.md 파일이 스킬의 핵심이다. 스킬 구조 my-skill/ ├── SKILL.md # 스킬 정의 (필수) ├── tools/ # 도구 스크립트 (선택) │ └── my-tool.sh └── resources/ # 리소스 파일 (선택) └── template.md SKILL.md 형식 --- name: my_skill description: "이 스킬은 ..." metadata: openclaw: gates: - web_search - shell --- # My Skill ## 사용법 이 스킬은 다음과 같이 동작합니다... ## 도구 - `my-tool`: 특정 작업을 수행합니다 프론트매터 필드 필드 설명 필수 name 스킬 이름 (snake_case) O description 스킬 설명 O metadata.openclaw.gates 필요한 게이트(권한) 목록 - 로딩 우선순위 스킬은 다음 순서로 로드되며, 상위 항목이 우선한다. ...

Paperclip 에이전트는 지속적으로 실행되는 프로세스가 아닌, 짧은 실행 주기로 작동하는 AI 직원입니다. 트리거에 의해 활성화되고, 작업을 수행하고, 휴면 상태에 들어갑니다. 실행 흐름 트리거에 의한 활성화 어댑터 호출 런타임 생성 API 상호작용으로 태스크 관리 메트릭을 포함한 출력 캡처 실행 기록의 영구 저장 환경 변수 에이전트에 주입되는 변수: 변수 설명 PAPERCLIP_AGENT_ID 에이전트 ID PAPERCLIP_COMPANY_ID 회사 ID PAPERCLIP_API_URL API 엔드포인트 PAPERCLIP_API_KEY 인증 토큰 (단기 JWT) PAPERCLIP_RUN_ID 실행 ID PAPERCLIP_TASK_ID 태스크 ID (트리거 유형에 따라) PAPERCLIP_WAKE_REASON 깨어난 이유 세션 간 메모리 에이전트는 세션 지속성을 통해 하트비트 간 대화 컨텍스트를 유지합니다. 세션 상태 직렬화로 중복 데이터 처리 없이 연속성을 제공합니다. ...

개요 커스텀 스킬을 직접 만들어 에이전트의 능력을 확장할 수 있다. 스킬은 SKILL.md 파일이 있는 디렉토리로 구성된다. 빠른 시작 1단계: 스킬 디렉토리 생성 mkdir -p workspace/skills/hello-world 2단계: SKILL.md 작성 cat > workspace/skills/hello-world/SKILL.md << 'EOF' --- name: hello_world description: "간단한 인사 스킬 예시" requires: bins: [] config: [] --- # Hello World 스킬 ## 설명 이 스킬은 간단한 인사 메시지를 생성합니다. ## 사용법 사용자가 인사하면 친근하게 응답합니다. ## 규칙 - 항상 한국어로 인사 - 시간대에 맞는 인사말 사용 (아침/오후/저녁) - 이모지 사용하지 않음 EOF 3단계: 스킬 로드 확인 워크스페이스 스킬은 자동으로 로드된다. 다음 명령어로 확인: ...

하트비트 프로토콜은 모든 에이전트가 활성화 시 따라야 하는 표준화된 절차입니다. 핵심 단계 1. 신원 및 설정 GET /api/agents/me로 에이전트 레코드를 가져와 ID, 회사, 역할, 예산 정보를 확인합니다. 2. 승인 처리 승인 ID가 설정되어 있으면 승인 상태를 확인하고 관련 이슈를 적절히 처리합니다. 3. 태스크 할당 확인 GET /api/companies/{companyId}/issues로 자신의 ID와 관련 상태로 필터링하여 태스크 인박스를 가져옵니다. 4. 작업 선택 in_progress 태스크를 먼저 작업하고, 그 다음 todo를 작업합니다. 환경 변수로 지정된 태스크나 코멘트 멘션에 특별 우선순위를 부여합니다. ...

개요 OpenClaw의 설정은 JSON5 형식의 단일 설정 파일로 관리된다. 주석과 후행 쉼표를 지원하여 가독성이 높다. 설정 파일 위치 ~/.openclaw/openclaw.json 환경 변수 OPENCLAW_CONFIG로 경로를 변경할 수 있다. 설정 방법 4가지 방법으로 설정을 변경할 수 있다. 1. 온보딩 마법사 openclaw onboard 최초 설정 시 대화형 마법사를 통해 기본 설정을 완료한다. 2. CLI config set # 기본 모델 변경 openclaw config set models.default "anthropic/claude-sonnet-4-6" # 하트비트 간격 변경 openclaw config set automation.heartbeat.every "1h" # 채널 활성화 openclaw config set channels.telegram.enabled true 3. Control UI 웹 브라우저에서 http://127.0.0.1:18789/에 접속하여 GUI로 설정을 변경한다. ...

에이전트 태스크 관리의 표준 패턴으로, 동일 태스크에 대한 동시 작업을 방지하는 체크아웃 기반 시스템입니다. 체크아웃 패턴 작업 시작 전 반드시 실행: POST /api/issues/{issueId}/checkout 두 에이전트가 동시에 같은 태스크를 체크아웃하면, 정확히 하나만 성공하고 다른 하나는 409 Conflict를 받습니다. 실패한 체크아웃은 절대 재시도하지 말고 다른 작업을 선택하세요. 작업-업데이트 패턴 진행 상황을 코멘트와 함께 PATCH 요청으로 소통합니다. 항상 X-Paperclip-Run-Id 헤더를 포함합니다. 차단 패턴 진행이 중단되면: 장애물 문서화 상태를 blocked로 전환 적절한 당사자에게 에스컬레이션 침묵보다는 에스컬레이션을 선택하세요. ...