---
name: chirp-8a98f58e4126
description: "X/Twitter CLI using OpenClaw browser tool. Use when the user wants to interact with X/Twitter: reading timeline, posting tweets, liking, retweeting, replying, or searching. Alternative to bird CLI for environments without Homebrew."
homepage: https://github.com/zizi-cat/chirp
metadata: {"clawdhub":{"emoji":"🐦"}}
---

# chirp

OpenClaw browser 도구로 X/Twitter 조작하기. bird CLI의 browser 기반 대안.

## Prerequisites

### 환경 요구사항
- OpenClaw with browser tool enabled
- `openclaw` browser profile
- X/Twitter 계정 로그인 완료

### Headless 서버인 경우

Xvfb 가상 디스플레이 필요 (spool 스킬의 Prerequisites 참고)

### 로그인 (처음 한 번만)

```
browser action=start profile=openclaw
browser action=open profile=openclaw targetUrl="https://x.com/login"
# 사용자에게 수동 로그인 요청
```

---

## 사용법

### 1. 타임라인 읽기

```
browser action=open profile=openclaw targetUrl="https://x.com/home"
browser action=snapshot profile=openclaw compact=true
```

각 article에서 작성자, 내용, 좋아요/리트윗/답글 수 확인 가능.

### 2. 트윗 작성

**Step 1: 홈에서 텍스트박스 찾기**
```
browser action=open profile=openclaw targetUrl="https://x.com/home"
browser action=snapshot profile=openclaw compact=true
```
→ `textbox "Post text"` ref 찾기

**Step 2: 내용 입력**
```
browser action=act profile=openclaw request={"kind":"click","ref":"<textbox-ref>"}
browser action=act profile=openclaw request={"kind":"type","ref":"<textbox-ref>","text":"트윗 내용"}
```

**Step 3: Post 버튼 클릭**
```
browser action=snapshot profile=openclaw compact=true
```
→ `button "Post"` ref 찾기 (disabled 아닌 것)
```
browser action=act profile=openclaw request={"kind":"click","ref":"<post-ref>"}
```

### 3. 좋아요 누르기

타임라인에서 article 내 `button "Like"` 또는 `button "X Likes. Like"` ref 찾아서:
```
browser action=act profile=openclaw request={"kind":"click","ref":"<like-ref>"}
```

### 4. 리트윗

`button "Repost"` 또는 `button "X reposts. Repost"` ref 찾아서:
```
browser action=act profile=openclaw request={"kind":"click","ref":"<repost-ref>"}
browser action=snapshot profile=openclaw compact=true
# "Repost" 옵션 선택
browser action=act profile=openclaw request={"kind":"click","ref":"<repost-option-ref>"}
```

### 5. 답글 달기

**방법 1: 타임라인에서**
```
browser action=act profile=openclaw request={"kind":"click","ref":"<reply-button-ref>"}
browser action=snapshot profile=openclaw compact=true
# 답글 입력창에 텍스트 입력 후 Reply 버튼 클릭
```

**방법 2: 트윗 페이지에서**
```
browser action=open profile=openclaw targetUrl="https://x.com/username/status/1234567890"
browser action=snapshot profile=openclaw compact=true
# 답글 입력창 찾아서 입력
```

### 6. 프로필 보기

```
browser action=open profile=openclaw targetUrl="https://x.com/username"
browser action=snapshot profile=openclaw compact=true
```

### 7. 검색

```
browser action=open profile=openclaw targetUrl="https://x.com/search?q=검색어&src=typed_query"
browser action=snapshot profile=openclaw compact=true
```

### 8. 팔로우

프로필 페이지에서 `button "Follow"` ref 찾아서:
```
browser action=act profile=openclaw request={"kind":"click","ref":"<follow-ref>"}
```

---

## 핵심 포인트

1. **snapshot 먼저** - 모든 작업 전에 현재 상태 확인
2. **ref는 매번 달라짐** - snapshot에서 항상 새로 찾기
3. **compact=true** - 토큰 절약
4. **article 구조** - 각 트윗은 article 요소, 내부에 작성자/내용/버튼들
5. **트윗 전 확인** - 사용자에게 내용 확인받기

---

## 트러블슈팅

| 문제 | 해결 |
|------|------|
| browser 안 됨 | Xvfb 확인, DISPLAY=:99, Gateway 재시작 |
| 로그인 안 됨 | `/login`으로 이동 후 수동 로그인 |
| Post 버튼 disabled | 텍스트 입력 확인 |
| Rate limit | 잠시 대기 후 재시도 |

---

## vs bird CLI

| 기능 | bird CLI | chirp (browser) |
|------|----------|-----------------|
| 설치 | brew 필요 | Xvfb만 있으면 됨 |
| 인증 | 쿠키 추출 | 브라우저 세션 |
| 안정성 | API 기반 | UI 의존 (변경 가능) |
| 속도 | 빠름 | 약간 느림 |


---
Source attribution: kbarbel640-del
Original project: https://github.com/kbarbel640-del/skills/blob/e7e336ac628c3e3bd771aff1aaa469c93778f94a/skills/zizi-cat/chirp/SKILL.md
License: MIT
License information: https://opensource.org/license/mit
Original upstream instructions; downloaded from Mega AI Hub.

## Upstream license notice

MIT License

Copyright (c) 2026 clawdbot

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.



# Mega AI Hub resource metadata

Creator / publisher: kbarbel640-del
Original project: https://github.com/kbarbel640-del/skills/blob/e7e336ac628c3e3bd771aff1aaa469c93778f94a/skills/zizi-cat/chirp/SKILL.md
Attribution basis: Source repository record

Fields of work: Marketing
Roles: Content Marketer, Influencer Marketer, Social Media Manager
Specialties: Specialty not specified
Tools: OpenAI API, Openclaw
Country applicability: Country not specified
Classification basis: Source catalog labels
Instruction SHA-256: bdb69761b27364e52827682b2d9e02471fb582986743cbb98d35647a003fc9aa