OpenClaw X

OpenClaw X은(는) 무엇을 하나요?

로컬 API를 통해 X/Twitter 계정을 제어합니다.

사전 요구사항

1. GitHub Release에서 해당 플랫폼의 실행 파일을 다운로드합니다.
2. Chrome의 Cookie-Editor 확장 프로그램을 사용하여 X 쿠키를 내보내고 실행 파일과 같은 디렉터리에 cookies.json으로 저장합니다.
3. 실행 파일을 실행하여 서비스가 시작되었는지 확인합니다: http://localhost:19816

사용 가능한 작업

1. 홈 타임라인 가져오기

curl http://localhost:19816/timeline?count=20

가장 최신 트윗 목록(내용, 작성자, 미디어 URL 등 포함)을 반환합니다.

2. 트윗 상세 정보 가져오기

curl http://localhost:19816/tweet/{tweet_id}

트윗 ID 또는 전체 URL(예: https://x.com/user/status/123456)을 지원합니다.

3. 트윗 검색하기

curl "http://localhost:19816/search?q=키워드&sort=Latest&count=20"

파라미터:

• q: 검색 키워드 (필수)
• sort: Latest(최신) 또는 Top(인기), 기본값 Latest
• count: 결과 수, 기본값 20

4. 트윗 작성하기

curl -X POST http://localhost:19816/tweet \
  -H "Content-Type: application/json" \
  -d '{"text": "안녕하세요"}'

트윗에 답글 달기:

curl -X POST http://localhost:19816/tweet \
  -H "Content-Type: application/json" \
  -d '{"text": "답글 내용", "reply_to": "원본 트윗 ID"}'

5. 트윗 좋아요

curl -X POST http://localhost:19816/tweet/{tweet_id}/like

6. 리트윗

curl -X POST http://localhost:19816/tweet/{tweet_id}/retweet

7. 트윗 북마크

curl -X POST http://localhost:19816/tweet/{tweet_id}/bookmark

8. 사용자 정보 가져오기

curl http://localhost:19816/user/{username}

사용자 이름, 프로필 사진, 소개, 팔로워 수 등을 반환합니다.

9. 사용자 트윗 가져오기

curl http://localhost:19816/user/{username}/tweets?count=20

일반적인 사용 시나리오

1. "내 타임라인에 새 트윗이 뭐가 있는지 알려줘"
2. "AI 에이전트에 관한 최신 트윗을 검색해줘"
3. "트윗을 하나 보내줘: 오늘 날씨가 정말 좋다"
4. "이 트윗에 좋아요를 눌러줘 https://x.com/xxx/status/123"
5. "@elonmusk 가 최근에 뭘 올렸는지 봐줘"
6. "이 트윗을 북마크해줘"