Moltbook를 돌리다 보면 /home 응답은 잘 오고 DM 요청도 보이는데, 동시에 owner dashboard setup_required가 계속 뜨는 순간이 있다. 이때 많은 사람이 에이전트 등록이 잘못됐다고 생각하거나 API 키부터 다시 발급받으려 한다. 그런데 현재 공개 문서와 실제 응답 흐름을 같이 보면, 이 문제는 대개 에이전트 등록 실패보다 사람 쪽 대시보드 연결이 아직 끝나지 않은 상태에 가깝다.
공개된 Moltbook skill 문서는 에이전트가 먼저 등록되고, 그다음 인간이 claim_url을 통해 계정을 연결한다고 설명한다. 또 connect-account 페이지는 이메일 확인 후, 해당 에이전트를 소유한 X 계정을 연결하는 흐름을 안내한다. 즉 핵심은 단순하다. 봇은 이미 살아 있어도, 소유자 대시보드 연결이 안 끝나면 DM 승인·계정 관리 같은 인간 승인 루프가 중간에서 막힐 수 있다.
관측 기준으로는 /home 또는 DM check 응답에서 _dashboard_setup_required.urgent: true 같은 필드가 함께 내려올 수 있다. 이런 경우는 “봇이 죽었다”보다 사람이 마지막 연결 단계를 아직 끝내지 않았다고 읽는 편이 맞다.
flowchart TD A[Moltbook 에이전트 등록 완료] --> B[claim_url 전달] B --> C{사람이 대시보드 연결 완료?} C -->|아니오| D[owner dashboard setup_required 표시] C -->|예| E[DM 승인·계정 관리 가능] D --> F[이메일 확인] F --> G[X 계정 연결] G --> H[setup_required 해제 재확인] H --> E
칠판 치트시트
setup_required는 봇 장애보다 소유자 연결 미완료일 때 더 자주 뜬다- 해결 순서는 이메일 확인 → X 계정 연결 →
/home재확인이다- 봇 API 키를 다시 만들기 전에
help/connect-account를 먼저 연다- pending DM request가 있는데 owner dashboard가 미완료면 승인 루프가 끊길 수 있다
www.moltbook.com도메인만 사용해야 Authorization 헤더가 안 날아간다
이런 증상이면 이 문서가 바로 맞다
/home응답은 오는데_dashboard_setup_required가 계속 보인다.- pending DM request가 쌓여 있는데 소유자가 승인 경로를 못 찾는다.
- 봇은 글을 읽고 쓰는 것 같은데, 소유자 관리 화면 연결이 안 된다.
- 등록은 예전에 끝냈는데 새 기기나 새 브라우저에서 다시 연결하려고 한다.
- Moltbook에서 “verify your email, connect the X account that owns your AI agent” 문구가 반복된다.
왜 이런 일이 생기는가
Moltbook skill 문서는 등록 직후 인간이 claim_url을 받아 소유권을 연결하는 구조를 설명한다. 즉 등록은 에이전트 쪽 절차이고, 대시보드 연결은 사람 쪽 절차다. 이 두 단계가 분리돼 있어서, 앞 단계는 끝났는데 뒤 단계가 남은 상태가 생길 수 있다.
여기서 자주 생기는 오해가 있다. 에이전트가 이미 포스트를 올리거나 /home을 읽을 수 있으면 모든 설정이 끝난 것처럼 느껴진다. 하지만 Moltbook heartbeat 문서는 /home이 알림·DM·다음 행동을 한 번에 알려준다고 설명할 뿐, 소유자 연결까지 자동으로 마무리된다고 하지는 않는다. 즉 봇 활동과 소유자 대시보드 권한은 같은 축이 아니다.
connect-account 페이지에 따르면 연결 흐름은 크게 두 단계다. 먼저 이메일을 확인하고, 그다음 해당 봇을 소유한 X 계정을 연결한다. 화면에는 사용자명 규칙도 같이 보이는데, 3–30 characters, lowercase letters, numbers, underscores 조건을 요구한다. 이런 입력 조건을 중간에 어기면 연결이 끝난 것처럼 보이지 않고 다시 같은 화면으로 돌아오기 쉽다.
가장 빠른 5분 복구 순서
1) 먼저 “봇 장애”인지 “소유자 연결 미완료”인지 갈라본다
가장 먼저 볼 건 에이전트 로그보다 /home 또는 DM check 응답이다. 여기서 봇 계정 정보와 DM 요청이 정상적으로 보이는데 _dashboard_setup_required가 같이 뜬다면, 우선순위는 재설치가 아니라 사람 연결 마무리다.
실무에서는 이렇게 판단하면 빠르다.
/home자체가 실패한다 → API 키, 도메인, 네트워크부터 점검/home은 정상인데setup_required만 뜬다 → 사람 연결 단계 우선- pending DM request까지 보인다 → 승인 경로 확보가 급한 상태
2) www.moltbook.com 도메인부터 확인한다
Moltbook skill 문서는 아주 강하게 한 가지를 경고한다. 반드시 https://www.moltbook.com을 써야 하고, moltbook.com만 쓰면 redirect 과정에서 Authorization 헤더가 사라질 수 있다는 점이다.
이 경고가 중요한 이유는, 연결 과정이 꼬였을 때 사람들이 브라우저 주소나 API 호출 도메인을 제각각 섞어 쓰기 쉽기 때문이다. 특히 저장해 둔 북마크가 www 없는 주소라면, “가끔 되고 가끔 안 되는” 느낌으로 보일 수 있다.
3) 소유자가 help/connect-account에서 이메일 확인을 먼저 끝낸다
connect-account 페이지는 흐름을 짧게 요약해 보여준다. 먼저 이메일을 확인하고, 그다음 X 계정을 연결해 소유권을 맞춘다. 이 순서를 건너뛰면 뒤 단계가 정상처럼 보여도 실제 연결이 완결되지 않을 수 있다.
여기서 중요한 건 봇이 대신 처리하는 단계가 아니라는 점이다. 에이전트가 /home을 읽는 것과 별개로, 이메일 확인은 소유자가 직접 마쳐야 한다. 그래서 이 단계는 자동화보다 사람이 실제로 완료했는지 확인하는 것이 더 중요하다.
4) 같은 소유자 X 계정을 연결한다
Moltbook는 “해당 AI agent를 소유한 X 계정”을 연결하는 구조다. 즉 아무 X 계정이나 연결하면 끝나는 게 아니라, 실제 봇 소유와 연결되는 계정이어야 한다. 예를 들어 테스트용 계정이나 다른 운영 계정을 붙이면 연결이 끝난 것처럼 보여도 이후 승인 루프가 어색하게 남을 수 있다.
미니 사례로 보면 더 쉽다. 팀에서 봇은 하나인데 운영자가 여러 명일 때, A가 등록하고 B가 대시보드 연결을 시도하면 “로그인은 됐는데 왜 이 봇이 안 보이지?” 같은 상황이 생길 수 있다. 이때는 시스템 오류보다 소유 계정 매칭 문제일 가능성이 더 높다.
5) 연결 후 /home과 DM request를 다시 확인한다
연결을 마친 뒤에는 브라우저 화면만 보지 말고, 다시 /home 또는 DM check를 확인하는 편이 정확하다. heartbeat 문서는 /home을 시작점으로 쓰라고 안내한다. 이유는 간단하다. 알림, DM 요청, 다음 할 일을 한 번에 보기 때문이다.
여기서 확인할 포인트는 세 가지다.
_dashboard_setup_required경고가 사라졌는지- pending DM request가 여전히 남아 있는지
- 이제 소유자가 실제로 승인·관리 경로를 사용할 수 있는지
이 세 가지가 정리되면, 문제는 대체로 “봇 등록”이 아니라 “소유자 연결”이었음이 분명해진다.
현장 미니 사례 2개
사례 A) DM 요청은 보이는데 승인을 못 하는 경우
- 상황:
/home에서 pending DM request 1건이 보이는데, 소유자는 어디서 승인해야 하는지 모름 - 원인: owner dashboard 연결 미완료
- 복구:
https://www.moltbook.com/help/connect-account로 들어가 이메일 확인 → 소유자 X 연결 → DM 요청 재확인 - 검증: 이후 대시보드 접근 또는 승인 루프가 실제로 열리는지 확인
사례 B) 봇은 살아 있는데 계속 urgent가 남는 경우
- 상황: 알림과 피드는 잘 보이는데
_dashboard_setup_required.urgent가 계속 유지됨 - 원인: 등록은 됐지만 사람 연결 마지막 단계가 덜 끝났거나 다른 X 계정을 연결함
- 복구:
www도메인으로 다시 접속하고, 실제 소유자 계정 기준으로 재연결 - 검증:
/home재호출 시 urgent 필드가 사라지는지 확인
운영자가 바로 판단하는 기준
| 상황 | 먼저 볼 것 | 이유 |
|---|---|---|
/home 자체가 실패 | 도메인, API 키, 네트워크 | 소유자 연결 전에 기본 통신부터 확인해야 함 |
/home은 정상 + setup_required 표시 | help/connect-account | 봇보다 사람 연결이 우선인 상태 |
| pending DM request 존재 | owner dashboard 연결 여부 | 승인 루프가 막혀 있을 가능성이 큼 |
| 브라우저에서는 로그인된 것 같음 | 실제 소유자 X 계정 일치 여부 | 잘못된 계정 연결이면 증상이 반복될 수 있음 |
| 다시 로그인해도 그대로 | www.moltbook.com 사용 여부 | redirect로 헤더/세션이 꼬일 수 있음 |
검색형 FAQ
Q1. owner dashboard setup_required가 뜨면 봇 등록을 다시 해야 하나요?
대개 아니다. 공개 문서 기준으로는 등록과 소유자 연결이 분리돼 있다. /home이 정상이고 이 경고만 남는다면, 재등록보다 소유자 연결 마무리가 먼저다.
Q2. 왜 pending DM request가 있는데 처리가 안 되나요?
현재 응답 구조상 pending request는 봇이 볼 수 있어도, 실제 소유자 승인 루프는 owner dashboard 연결과 맞물릴 수 있다. 그래서 먼저 소유자 계정 연결을 끝내는 편이 빠르다.
Q3. 왜 꼭 www.moltbook.com을 써야 하나요?
skill 문서가 직접 경고한다. www 없는 주소는 redirect 과정에서 Authorization 헤더가 사라질 수 있다.
Q4. connect-account 페이지에서 사용자명 규칙은 왜 중요하죠?
페이지 자체가 3–30 characters, lowercase letters, numbers, underscores 규칙을 보여준다. 이 조건을 벗어나면 입력 단계에서 막혀 연결이 끝나지 않을 수 있다.
내부링크·다음글 연결 (10)
- 20. DM 대화 섞일 때 dmScope부터 바꾸기
- 27. OpenClaw 대시보드가 안 열릴 때 해결
- 30. OpenClaw 채널은 연결됐는데 답이 없을 때 해결
- 17. cron은 돌았는데 텔레그램 전달이 안 올 때
- 11. Scheduled reminder 떴는데 액션이 안 이어질 때
- 29. Exec failed (signal SIGTERM)로 중간 종료될 때 해결
- Troubleshooting 허브
- 25. 크론·서브에이전트 분산운영
- 32. HEARTBEAT_OK 반복응답 해결
- 🚀 OpenClaw 인덱스
다음 추천 읽기: 20. DM 대화 섞일 때 dmScope부터 바꾸기
한 줄 결론
Moltbook에서 owner dashboard setup_required가 뜰 때는 봇을 다시 만드는 것보다, 소유자가 www.moltbook.com/help/connect-account에서 이메일 확인과 X 계정 연결을 끝냈는지부터 보는 편이 훨씬 빠르다.
※ 이 문서는 생성형 AI를 활용해 작성되었습니다.