긍정우

2026-05-09-openclaw-setup

5 min read

작성 일자 : 2026-05-09

기획

OpenClaw 개인 에이전트 작업 환경을 점검하고, Telegram 직결 대화 기준으로 응답 가능 여부를 확인하는 것이 목적이었다.

  • 워크스페이스 기준 경로 확인
  • 부트 문서 존재 여부 확인
  • 숨김 폴더 .openclaw 인식 여부 확인
  • Telegram direct chat 기준 main agent 연결 상태 확인
  • 이후 정리용 문서화 기반 마련

설계

화면 설계

별도 UI 설계 작업은 없었고, Telegram direct chat와 로컬 워크스페이스를 함께 사용하는 구조로 확인했다.

필요 기술

  • OpenClaw agent workspace 구조 이해
  • Telegram direct chat 라우팅 확인
  • 로컬 파일 탐색
  • 세션 메모 기록 확인
  • Obsidian 문서화 템플릿 적용

핵심

  • 현재 작업 디렉터리는 workspace 루트
  • .openclaw는 숨김 폴더라 기본 Finder/ls 설정에 따라 보이지 않을 수 있음
  • boot.md 소문자 파일은 없고, 워크스페이스 루트에 BOOT.md가 존재함
  • 워크스페이스 상태 파일 기준:
    • bootstrapSeededAt: 2026-05-06T13:24:09.288Z
    • setupCompletedAt: 2026-05-08T23:07:34.724Z

구현 완료

현재까지 확인된 세팅 내용

  • 워크스페이스 루트 구성 확인
    • AGENTS.md
    • BOOT.md
    • HEARTBEAT.md
    • IDENTITY.md
    • SOUL.md
    • TOOLS.md
    • USER.md
    • memory/
  • OpenClaw 내부 상태 파일 존재 확인
    • .openclaw/workspace-state.json
  • 개인 문서화 지침 확인
    • Documents/openclaw/BOOT.md
    • 새 문서 생성 우선
    • overwrite 금지
    • 템플릿 기반 작성

현재까지 테스트한 내용

  1. Telegram direct chat 응답 테스트
    • hello 메시지에 대해 응답 수행
  2. main agent 연결 인식 테스트
    • talk to main 요청에 대해 현재 이 대화가 이미 main agent와 연결되어 있음을 확인
  3. 워크스페이스 경로 확인 테스트
    • 실제 작업 위치가 workspace 루트인지 확인
  4. 숨김 폴더 확인 테스트
    • .openclaw 디렉터리가 실제로 존재함을 확인
  5. 부트 파일 확인 테스트
    • boot.md는 없음
    • BOOTSTRAP.md도 없음
    • BOOT.md는 존재

요약

  • OpenClaw 기본 작업 환경은 이미 생성되어 있었고, 세팅 완료 시점도 상태 파일에 기록되어 있다.
  • Telegram direct chat 기준으로 main agent 응답은 동작했다.
  • 사용자 혼동 포인트는 .openclaw가 숨김 폴더라는 점과 boot.md가 아니라 BOOT.md라는 점이었다.

시행착오

  • 초기 확인 과정에서 boot.md와 BOOT.md를 구분하지 않으면 오인하기 쉬웠다.

  • .openclaw가 숨김 폴더라서 경로에 없다고 느껴질 수 있었다.

  • 세션 메모상 초반 일부 assistant turn failed 기록이 있어, 초기 안정성 점검은 추가로 필요해 보인다.

한계점

  • 현재 문서는 오늘 대화와 로컬 확인 결과만 기준으로 정리했다.
  • 설치 명령, 패키지 구성, node 연결, 외부 서비스 인증 같은 세부 세팅 내역은 아직 확인하지 못했다.
  • heartbeat 실제 동작 결과나 cron 기반 자동화 테스트 내역은 이번 기록에 포함하지 않았다.

개선점

  • 다음 단계에서 아래 항목을 별도 문서로 추가 정리하면 좋다.
    • OpenClaw 설치 절차
    • Telegram 연결 절차
    • heartbeat/cron 테스트 결과
    • 실패 로그 원인과 재현 여부
  • 08_openclaw 폴더 안에서 주제별로 문서를 분리하면 추후 추적이 쉬워진다.
  • 설정 확인 시 파일명 대소문자와 숨김 폴더 여부를 체크리스트로 고정하면 혼동을 줄일 수 있다.

Graph View