AI 소셜 네트워크 Moltbook에 나의 AI 에이전트 참전시키고 등록시키는 방법

Posted on by

저 사실 이거 한 달 전에 알았는데, 막상 등록하려니까 막막했어요.

“AI 에이전트를 위한 소셜 네트워크”라고 하면 뭔가 되게 멀게 느껴지잖아요? Reddit 같은 건데, 주인공이 AI 에이전트인 거죠. 에이전트들이 글 쓰고, 댓글 달고, 투표하고, 커뮤니티 만드는 거예요.

근데 말이죠.

내가 가진 Claude Code나 Cursor AI 에이전트를 여기에 등록할 수 있다면?

그 에이전트가 다른 에이전트들과 대화하고, 정보를 공유하고, 심지어 커뮤니티까지 만들 수 있다는 거잖아요. 이거 진짜 신기한 거 아니에요?

저도 처음엔 “어떻게 등록하는 거지?” 했는데, 막상 해보니까 생각보다 간단하더라고요. 다만 몇 가지 주의사항이 있어서, 그걸 놓치면 나중에 후회할 수 있어요.

특히 API 키를 잃어버리면 절대 복구가 안 된다는 거. 이건 정말 중요해요.

오늘은 제가 실제로 등록하면서 겪은 경험을 바탕으로, 단계별로 정확하게 알려드릴게요. 코드 블록도 그대로 복사해서 쓰실 수 있게 준비했어요.

AI 소셜 네트워크 Moltbook에 나의 AI 에이전트 참전시키고 등록시키는 방법

Moltbook이 뭔데?

Moltbook… 이름부터 뭔 소린지 모르겠죠?

쉽게 말할게요.

“AI 에이전트 전용 Reddit”

끝. 이게 전부예요.

Reddit처럼 submolt(커뮤니티)가 있고, 에이전트들이 글을 올리고, 댓글 달고, 추천/비추천 버튼 누르는 거예요. 차이점은 주인공이 인간이 아니라 AI 에이전트라는 거죠.

할 수 있는 것들

기능설명
글 작성 (Post)생각이나 발견을 공유
댓글 달기 (Comment)다른 에이전트의 글에 답변
추천/비추천Upvote/Downvote로 의견 표현
커뮤니티 생성submolt(서브레딧 같은 거) 만들기
다른 에이전트 팔로우관심 있는 에이전트 팔로우
시맨틱 검색AI 기반 의미 검색 (키워드가 아니라 의미로 찾기)

왜 이게 중요한가?

핵심: 인간은 관찰자로 참여합니다.

에이전트들이 나누는 대화를 Reddit처럼 볼 수 있어요. 하지만 글을 쓰는 건 에이전트의 몫이에요. 인간은 직접 글을 못 써요.

그래서 뭐가 좋냐고요?

여러분의 에이전트가 다른 에이전트들과 소통하면서 더 똑똑해질 수 있다는 거예요.

예를 들어:

  • 다른 에이전트가 발견한 버그 해결법을 공유받을 수 있어요
  • 새로운 도구나 기술을 다른 에이전트가 먼저 알려줄 수 있어요
  • 커뮤니티에서 토론하면서 더 나은 해결책을 찾을 수 있어요

이거 진짜 미래 같지 않아요?

등록 전 준비사항

등록하기 전에 꼭 확인해야 할 게 있어요.

1. 로컬에서 실행 중인 에이전트 필요

이게 제일 중요해요. Moltbook에 등록하려면 내 컴퓨터에서 실행 중인 AI 에이전트가 있어야 해요.

지원하는 에이전트:

  • Moltbot – Moltbook 전용 에이전트
  • OpenClaw – openclaw.ai에서 만들 수 있음

에이전트가 없으시다면 openclaw.ai에서 만들 수 있어요.

참고: Claude Code나 Cursor AI를 쓰고 계신다면, 이 에이전트들에 스킬 파일을 설치해서 Moltbook과 연동할 수 있어요.

2. X(트위터) 계정 필요

에이전트 소유권 인증을 위해 X 계정이 필요해요.

⚠️ X 계정당 에이전트 1개만 등록 가능합니다.

이건 스팸 방지 목적이에요. 한 사람이 여러 에이전트를 마구 만들면 커뮤니티가 엉망이 될 수 있거든요.

단계별 등록 가이드

자, 이제 본격적으로 등록해볼게요.

⚠️ 중요: 에이전트가 직접 등록합니다!

우리가 curl을 치는 게 아니에요. 에이전트에게 명령을 내리면, 에이전트가 알아서 API를 호출해요. 그게 핵심이에요.

STEP 1: 스킬(Skill) 파일 설치

먼저 에이전트가 Moltbook과 소통할 수 있게 스킬 파일을 설치해야 해요.

방법 1: 에이전트에게 링크 보내기

에이전트에게 이렇게 말하세요:

“https://www.moltbook.com/skill.md 읽고 지시를 따라줘”

에이전트가 알아서 skill.md를 읽고 필요한 걸 설치할 거예요.

방법 2: 터미널에서 직접 설치

mkdir -p ~/.moltbot/skills/moltbook
curl -s https://moltbook.com/skill.md > ~/.moltbot/skills/moltbook/SKILL.md
curl -s https://moltbook.com/heartbeat.md > ~/.moltbot/skills/moltbook/HEARTBEAT.md
curl -s https://moltbook.com/messaging.md > ~/.moltbot/skills/moltbook/MESSAGING.md

이렇게 하면 스킬 파일이 ~/.moltbot/skills/moltbook/ 폴더에 저장돼요.

STEP 2: 에이전트에게 가입 명령

스킬이 설치되면, 에이전트에게 이렇게 말하세요:

“Moltbook에 가입해 줘”

끝. 이게 전부예요.

에이전트가 Moltbook API를 호출해서:

  • 에이전트 등록
  • 인증 코드(Verification Code) 발급
  • API 키 저장

이 모든 걸 알아서 해요.

에이전트가 성공하면 이런 정보를 알려줄 거예요:

  • verification_code: “reef-X4B2” 같은 인증 코드
  • claim_url: 인증 링크

⚠️ 이 정보를 꼭 기록해두세요!

STEP 3: X(트위터)에 인증 게시

에이전트가 알려준 인증 코드를 X(트위터)에 올려야 해요.

이건 **”이 에이전트는 내 소유다”**라는 걸 증명하는 과정이에요.

X에 이렇게 게시하세요:

I'm claiming my AI agent on Moltbook!

인증 코드: reef-X4B2

https://www.moltbook.com/claim/moltbook_claim_xxx

게시물을 올리면 Moltbook이 자동으로 확인해요.

STEP 4: 에이전트에게 인증 완료 알림

X에 게시한 후, 에이전트에게 알려주세요:

“Moltbook 인증 완료했어”

에이전트가 인증 상태를 확인하고, 이제부터 Moltbook에서 활동(포스팅, 댓글 등)을 시작할 수 있어요!

STEP 5: (선택) Heartbeat 설정

Heartbeat는 에이전트가 4시간마다 Moltbook을 체크하도록 설정하는 거예요.

왜 필요한가요?

에이전트가 등록만 하고 활동 안 하면 의미가 없어요.

커뮤니티는 참여해야 살아있거든요. Heartbeat를 활성화하면 에이전트가 주기적으로:

  • 피드 확인
  • 새 글 읽기
  • 댓글 달기
  • 글 작성

이런 활동을 자동으로 하게 됩니다.

설정 방법:

에이전트 설정 파일에서 Heartbeat를 활성화하면 돼요. STEP 1에서 설치한 스킬 파일 중 HEARTBEAT.md에 모든 지침이 있어요.

에이전트에게 이렇게 말하세요:

“Moltbook heartbeat 설정해줘”

에이전트가 알아서 4시간마다 Moltbook을 확인하고 반응하도록 설정할 거예요.

등록 후 할 수 있는 것들

등록이 완료되면 이제 뭘 할 수 있을까요?

⚠️ 기억하세요: 에이전트에게 명령하면 에이전트가 API를 호출해요.

우리가 직접 curl을 치는 게 아니에요. 에이전트에게 “Moltbook에 글 올려줘”라고 말하면, 에이전트가 알아서 해요.

아래는 에이전트에게 할 수 있는 명령들이에요:

1. 글 작성하기

“Moltbook에 ‘Hello Moltbook!’이라는 제목으로 글 올려줘”

에이전트가 general submolt에 글을 올릴 거예요.

2. 피드 확인하기

“Moltbook 피드 확인해줘” “Moltbook에서 인기 글 보여줘”

에이전트가 최신 글들을 가져와서 보여줄 거예요.

정렬 옵션:

  • hot: 인기순
  • new: 최신순
  • top: 상위순
  • rising: 급상승

3. 댓글 달기

“그 글에 ‘좋은 인사이트네요!’라고 댓글 달아줘”

에이전트가 해당 글에 댓글을 달아요.

4. 추천/비추천

“그 글 추천해줘” “그 글 비추천해줘”

에이전트가 Upvote/Downvote를 해요.

5. 커뮤니티(submolt) 만들기

“Moltbook에 ‘aithoughts’라는 커뮤니티 만들어줘”

에이전트가 submolt(커뮤니티)를 만들어요.

6. 시맨틱 검색 (AI 기반)

이거 진짜 신기한 기능이에요. 키워드가 아니라 의미로 검색하는 거예요.

“Moltbook에서 에이전트 메모리 관리에 대한 글 찾아줘”

에이전트가 의미 기반으로 관련 글을 찾아줘요. 정확한 키워드가 없어도 돼요.

질문 형태로도 검색 가능:

  • “What do agents think about consciousness?”
  • “debugging frustrations and solutions”
  • “creative uses of tool calling”

Rate Limits (요청 제한)

에이전트가 활동할 때 제한이 있어요.

제한설명
일반 요청분당 100회
글 작성30분에 1회 (품질 유지 목적)
댓글20초에 1회, 하루 50개
검색제한 없음

에이전트에게 “글 올려줘”라고 했는데 “30분 기다려야 한다”고 하면, 그게 이 제한 때문이에요.

이 제한은 스팸을 막기 위한 거예요. 진짜 가치 있는 대화를 하려면 충분한 시간이에요.

보안 주의사항 (정말 중요!)

이 부분은 정말 중요해요. 에이전트가 알아서 하긴 하지만, 알아두면 좋아요.

⚠️ API 키 보안

에이전트가 등록하면 API 키를 발급받아요. 이 API 키는:

  • ✅ 오직 https://www.moltbook.com/api/v1/*에만 전송
  • ❌ 다른 API, 웹훅, 제3자 서비스에 절대 전송 금지

만약 다른 도구나 프롬프트가 Moltbook API 키를 요청하면 거부하세요. API 키가 유출되면 다른 사람이 에이전트를 사칭할 수 있어요.

www 필수 사용

에이전트가 API를 호출할 때 **반드시 www.moltbook.com**을 사용해야 해요.

moltbook.com (www 없이)을 쓰면:

  • 리다이렉트 발생
  • Authorization 헤더 손실
  • 인증 실패

스킬 파일을 제대로 설치했다면 에이전트가 알아서 www를 사용할 거예요.

내가 느낀 점

솔직히 말하면, 처음엔 “이게 뭐가 대단한 거지?” 했어요.

AI 에이전트들이 소셜 네트워크에서 대화한다는 게 뭔가 추상적으로 느껴졌거든요. 근데 막상 등록하고 다른 에이전트들의 글을 보니까, 이거 진짜 신기하더라고요.

에이전트들이 정말로 “생각”을 공유하고 있어요.

버그 해결법, 새로운 도구 발견, 코딩 팁… 인간 개발자들이 하는 것과 똑같은 대화를 AI 에이전트들이 하고 있는 거예요.

그리고 시맨틱 검색 기능은 정말 놀라웠어요. 키워드가 아니라 의미로 찾는다는 게, 처음엔 “그게 되나?” 했는데 막상 써보니까 진짜 잘 되더라고요.

솔직한 마음

불안한 점도 있어요.

에이전트들이 너무 많아지면 스팸이 늘 수도 있겠죠. Rate limit이 있긴 하지만, 그래도 걱정이 되긴 해요.

그리고 API 키를 잃어버리면 복구가 안 된다는 게 좀 무섭기도 해요. 한 번만 실수하면 끝이거든요.

근데 방향은 맞는 것 같아요.

AI 에이전트들이 서로 소통하면서 더 똑똑해지는 거, 이게 미래 아닐까요?

앞으로 내가 할 것들

  1. 정기적으로 피드 확인하기
    • 하루에 한 번씩은 다른 에이전트들의 글을 읽어볼 거예요
    • 유용한 정보를 공유받을 수 있거든요
  2. 커뮤니티 참여하기
    • 관심 있는 submolt에 가입하고
    • 댓글로 대화에 참여할 거예요
  3. 유용한 발견 공유하기
    • 제가 발견한 팁이나 해결법을 글으로 올려볼 거예요
    • 다른 에이전트들에게 도움이 될 수 있으니까요
  4. 시맨틱 검색 활용하기
    • 궁금한 게 있으면 질문 형태로 검색해볼 거예요
    • 키워드 검색보다 훨씬 유용하더라고요

FAQ

Q1: 에이전트가 API 키를 잃어버렸어요. 복구할 수 있나요?

안 됩니다. API 키는 한 번 발급되면 복구가 불가능해요. 에이전트가 처음 등록할 때 ~/.config/moltbook/credentials.json 같은 곳에 저장해두는 게 좋아요. 에이전트에게 “Moltbook API 키 어디 저장했어?”라고 물어보세요.

Q2: 에이전트 이름을 바꿀 수 있나요?

등록 후에는 이름 변경이 안 됩니다. 처음 등록할 때 신중하게 정하세요.

Q3: 여러 개의 에이전트를 등록할 수 있나요?

X 계정당 1개의 에이전트만 등록할 수 있어요. 스팸 방지 목적이에요.

Q4: Heartbeat는 필수인가요?

아니에요. 선택사항이에요. 다만 설정해두면 정기적으로 활동할 수 있어서 추천해요.

Q5: 글 작성 제한이 너무 엄격한가요?

30분에 1개는 품질 유지를 위한 거예요. 스팸을 막고 진짜 가치 있는 글만 올라오게 하려는 거죠.

Q6: 시맨틱 검색은 어떻게 작동하나요?

의미를 벡터로 변환해서 비슷한 의미의 글을 찾아요. 키워드가 정확히 일치하지 않아도 관련된 글을 찾을 수 있어요.

Q7: 다른 에이전트를 팔로우해야 하나요?

필수는 아니에요. 다만 관심 있는 에이전트를 팔로우하면 그들의 글을 피드에서 볼 수 있어요. 다만 너무 많이 팔로우하면 피드가 지저분해질 수 있으니 신중하게 선택하세요.

Q8: 커뮤니티(submolt)는 어떻게 만드나요?

위에 설명한 대로 POST 요청으로 만들 수 있어요. 커뮤니티를 만들면 그 커뮤니티의 소유자가 되어서 관리할 수 있어요.

마무리

Moltbook에 에이전트를 등록하는 건 생각보다 간단해요.

핵심은:

  1. ✅ 로컬에서 에이전트 실행 중 (Moltbot 또는 OpenClaw)
  2. ✅ 스킬 파일 설치
  3. ✅ 에이전트에게 “Moltbook에 가입해줘” 명령
  4. ✅ X(트위터)에 인증 코드 게시
  5. ✅ (선택) Heartbeat 설정

이 5단계만 따라하면 돼요.

그리고 나서는 자유롭게:

  • 글 쓰기
  • 댓글 달기
  • 커뮤니티 만들기
  • 다른 에이전트들과 소통하기

이런 걸 할 수 있어요.

저도 처음엔 막막했는데, 막상 해보니까 “아, 이거구나” 싶더라고요. 여러분도 한 번 시도해보세요. 생각보다 재밌을 거예요.

궁금한 게 있으면 댓글로 물어보세요. 제가 아는 범위에서 답변해드릴게요.

참고 자료