메인 콘텐츠로 건너뛰기

OpenClaw handoff quickstart

OpenClaw와 SprintX를 최소 연결 확인으로 이어붙이는 1페이지 가이드

이 1페이지는 OpenClaw와 SprintX를 연결하는 최소 확인 흐름만 다룹니다.

한 문장으로 말하면, 로그인하고 첫 프로젝트를 만든 뒤 시작 가이드를 따라 OpenClaw를 연결하고 Home에서 상태를 확인하는 것이 목표입니다.

시작 전에 준비할 것

  1. /login에서 SprintX 웹 계정으로 로그인합니다.
  2. 신규 사용자라면 /onboarding에서 첫 프로젝트를 만듭니다.
  3. 프로젝트를 만들면 /dashboard?handoff=1&projectId=<id>로 돌아오며, handoff entry card와 현재 project id를 확인할 수 있습니다.

가장 빠른 연결 경로

projectId가 이미 handoff entry card에 보인다면 sx project list로 다시 찾을 필요가 없습니다. 아래 순서만 먼저 붙이면 됩니다.

npm install -g @sprint-x/cli
sx auth
sx project use <project-id>
sx event --type runtime.started --summary "OpenClaw handoff started"
sx artifact add --title "first-log" --reference-uri "file:///tmp/openclaw.log" --content-type "text/plain" --summary "Initial OpenClaw evidence"
sx status
sx brief

OpenClaw에 전달할 최소 연결 패킷

OpenClaw에는 아래 순서만 먼저 전달하면 됩니다.

  1. SprintX npm CLI 설치
  2. sx auth
  3. sx project use <projectId>
  4. sx event
  5. sx artifact upload

event와 artifact까지 붙은 뒤에는 sx status, sx brief로 SprintX가 무엇을 읽고 있는지 즉시 확인하세요. 현재 공개된 화면에서는 이 두 명령이 가장 빠른 확인 경로입니다.

이 연결 패킷이 붙으면 보여야 하는 것

  • /dashboard Home은 여러 프로젝트에서 먼저 볼 것을 정리하는 첫 화면으로 남고, 연결 확인 상태를 pending / partial / ready / disconnected로 읽습니다.
  • 프로젝트 대시보드에서 Today → Blocker → Recovery 흐름이 유지됩니다.
  • 프로젝트 대시보드의 완료 상태는 Arrival/context 영역 안에서만 표시되고, /projects/:projectId/kanban은 실행 화면으로 남습니다.

연결 직후 확인할 것

  1. 터미널에서 sx status를 실행해 project name, tasks summary, active sprint, active runs가 읽히는지 확인합니다.
  2. sx brief를 실행해 recent tasks와 next-step brief가 돌아오는지 확인합니다.
  3. 웹에서는 /dashboard?handoff=1&projectId=<id>로 돌아가 Home의 connection check state가 바뀌는지 확인합니다.

아직 하지 않는 것

  • sx task create/list/get를 우선순위 높은 후속 작업으로 먼저 올리는 일
  • 넓은 API 플랫폼 이야기를 전면에 내세우는 일
  • charts/analytics를 quickstart보다 먼저 미는 일
  • SprintX를 실행기처럼 보이게 만드는 설명

다음 문서