---
title: "OpenClaw용 XApiClaw"
description: "Twexapi 기반 X/Twitter 자동화를 위한 XApiClaw OpenClaw 플러그인을 설치하고 구성합니다."
---

XApiClaw는 OpenClaw 에이전트에서 Twexapi를 사용하기 위한 OpenClaw 플러그인입니다. 이는 에이전트에 안전한 로컬 엔드포인트 카탈로그, 선택적 라이브 Twexapi 호출자, 슬래시 명령, API 키 삽입 및 개인, 유료 또는 쓰기 유사 작업에 대한 승인 게이트를 제공합니다.

OpenClaw 워크플로에 X/Twitter 검색, 트윗 답글, 타임라인, 팔로어 내보내기, 사용자 조회, 트렌드, 목록, 커뮤니티, DM, 기사, 계정 상태 확인 또는 명시적인 사용자 승인 쓰기 작업이 필요한 경우 XApiClaw를 사용하세요.

## 전제 조건

- OpenClaw `2026.6.8` 이상
- Node.js `22` 이상
- [대시보드](https://twexapi.io/dashboard)의 Twexapi API 키

신뢰할 수 있는 소스에서만 에이전트 플러그인을 설치하세요. OpenClaw 플러그인은 로컬 에이전트 환경에서 코드를 실행하므로 반복 가능한 프로덕션 설치를 위해 버전을 고정하세요.

## 설치

OpenClaw의 명시적인 npm 소스 선택기를 사용하여 npm 패키지를 설치합니다.

```bash
openclaw plugins install npm:xapiclaw
```

일반 업그레이드의 경우 추적된 설치 소스를 재사용하세요.

```bash
openclaw plugins update xapiclaw
```

재현 가능한 프로덕션 설치를 위해 게시된 npm 버전을 고정하세요.

```bash
openclaw plugins install npm:xapiclaw@0.1.0 --pin
```

패키지 이름은 `xapiclaw`, 플러그인 ID는 `xapiclaw`, 현재 패키지 버전은 `0.1.0`입니다.

OpenClaw 설치가 `OPENCLAW_NIX_MODE=1`로 실행되면 플러그인 수명 주기 변경자가 비활성화됩니다. 'openclaw 플러그인 설치' 또는 'openclaw 플러그인 업데이트' 대신 Nix OpenClaw 소스를 통해 XApiClaw를 설치하거나 업데이트하세요.

자격 증명을 구성하기 전에 XApiClaw를 설치할 수 있습니다. Twexapi API 키를 추가할 때까지 무료 '탐색' 카탈로그를 계속 사용할 수 있으며 라이브 API 호출이 설정 지침을 반환합니다.

## API 키 인증 구성

Twexapi API 키를 생성하여 환경 변수에 저장한 후 XApiClaw를 구성합니다.

```bash
export TWEXAPI_API_KEY="twitterx_..."
openclaw config set plugins.entries.xapiclaw.config.apiKey "$TWEXAPI_API_KEY"
```

XApiClaw는 다음과 같이 실시간 요청에 키를 삽입합니다.

```http
Authorization: Bearer YOUR_API_KEY
```

채팅, 문서, 셸 기록에 키를 보관하지 마세요. OpenClaw가 프롬프트에 비밀을 노출하지 않고 로컬 플러그인 구성에 비밀을 기록하도록 위의 환경 변수 명령을 선호합니다.

## 선택적 설정

Twexapi 호환 배포를 운영하지 않는 한 기본 API 기본 URL을 사용하세요.

```bash
openclaw config set plugins.entries.xapiclaw.config.baseUrl "https://api.twexapi.io"
```

XApiClaw에는 내장된 자격 증명이 없는 HTTPS 기본 URL이 필요합니다.

폴링 설정은 향후 이벤트 지원을 위해 예약되어 있으며 현재 릴리스에서는 백그라운드 모니터를 활성화하지 않습니다.

```bash
openclaw config set plugins.entries.xapiclaw.config.pollingEnabled false
openclaw config set plugins.entries.xapiclaw.config.pollingInterval 60
```

## 도구

XApiClaw는 두 개의 구조화된 도구를 노출합니다.

### `탐색`

번들로 제공되는 Twexapi 엔드포인트 카탈로그를 검색하고 방법, 경로, 매개변수, 위험 플래그 및 비용 참고 사항을 검사하세요. 이 도구는 로컬 도구이며 네트워크를 호출하지 않습니다.

```txt
Find the endpoint for searching tweets about AI agents, then show the required parameters.
```

### `xapiclaw`

구조화된 `method`, `path`, `query` 및 `body` 입력을 사용하여 카탈로그에 나열된 Twexapi 엔드포인트를 호출합니다. 인증은 플러그인에 의해 주입되므로 모델은 API 키를 도구 인수로 수신하지 않습니다.

'xapiclaw' 도구는 크레딧을 사용하고 개인 계정 데이터를 읽거나 쓰기 작업을 수행할 수 있으므로 선택 사항입니다. OpenClaw가 선택적 도구를 숨기는 경우 명시적으로 허용하세요.

```bash
openclaw config set tools.alsoAllow '["explore", "xapiclaw"]'
```

OpenClaw 승인 메시지는 쓰기, 비공개 읽기 및 유료 대량 호출 전에 실행됩니다. 승인하기 전에 요청 대상, 엔드포인트, 페이로드, 예상 비용을 검토하세요.

## 워크플로 핸드오프

먼저 `explore`를 사용한 다음 실행하려는 엔드포인트, 대상 및 제한에 대해서만 `xapiclaw`를 호출하세요.

### 트윗 검색

`explore`를 사용하여 `/twitter/advanced_search/page`를 찾은 다음 제한된 검색 매개변수를 사용하여 `xapiclaw`를 호출하세요.

```txt
Use explore to find tweet search endpoints.
Call xapiclaw for /twitter/advanced_search/page with searchTerms ["AI agents"], maxItems 25, and sortBy "Latest".
Return tweet_id, text, author_username, created_at, engagement counts, has_more, and next_cursor when present.
```

### 트윗 답글

`탐색`을 사용하여 응답 엔드포인트를 찾은 다음 제한된 개수 및 정렬 옵션을 사용하여 `/twitter/tweets/{tweet_id}/replies/{count}`를 호출하세요.

```txt
Use explore to find reply endpoints.
Fetch up to 100 replies for tweet 1893704267862470862.
Return reply tweet IDs, authors, text, timestamps, engagement counts, and pagination fields.
```

### 팔로어 내보내기

제한된 내보내기에는 팔로어 끝점을 사용합니다. 응답이 작업 ID를 반환하는 경우 계속하기 전에 문서화된 상태와 다음 페이지 경로를 폴링합니다.

```txt
Use explore to find follower endpoints.
Fetch followers for @twexapi with count 1000.
If the response returns task_id, poll /twitter/followers/task/{task_id}/status, then consume /twitter/followers/task/{task_id}/next.
Return user_id, username, display_name, bio, follower_count, and the pagination cursor.
```

### 동향 조사

시장 또는 콘텐츠 조사를 위해 글로벌 트렌드 주제, 국가, 콘텐츠 및 트윗 엔드포인트를 사용하세요.

```txt
Use explore to find global trending endpoints.
Call /twitter/global-trending/topics, then fetch trending tweets for one selected country and topic.
Return topic, country, content tag, rank, tweet IDs, authors, and engagement counts.
```

### 제어된 쓰기 작업

사용자가 정확한 요청을 승인한 후에만 쓰기 엔드포인트를 사용하세요.

```txt
Use explore to find tweet creation endpoints.
Draft the exact /twitter/tweets/create request body.
Ask for explicit approval before calling xapiclaw.
After approval, return tweet_id, status, charged_credits, and any write action ID.
```

## 런타임 진단

설치 또는 업데이트 후 런타임 등록을 확인하세요.

```bash
openclaw plugins inspect xapiclaw --runtime --json
openclaw skills info xapiclaw
```

런타임 검사에는 로드된 `xapiclaw` 플러그인, `explore` 도구, 선택적 `xapiclaw` 도구, 승인 후크, `/xstatus` 및 `/xtrends` 명령이 표시되어야 합니다.

OpenClaw가 XApiClaw 기술을 볼 수 있지만 도구를 호출할 수 없는 경우 두 도구를 `tools. alsoAllow`에 추가하세요.

```bash
openclaw config set tools.alsoAllow '["explore", "xapiclaw"]'
```

릴리스와 같은 로컬 검사의 경우 repo 폴더 대신 아티팩트를 압축하고 설치하여 OpenClaw가 게시된 `dist/index.js` 항목을 로드하도록 합니다.

```bash
npm pack
openclaw plugins install npm-pack:./xapiclaw-0.1.0.tgz
openclaw plugins inspect xapiclaw --runtime --json
```

## 슬래시 명령

| 명령 | 목적 |
| --- | --- |
| `/xstatus` | `/balance`를 통해 Twexapi 잔액 및 상태를 표시합니다. |
| `/xtrends` | `/twitter/global-trending/topics`를 통해 인기 주제를 표시합니다. |

## 안전 모델

XApiClaw는 OpenClaw 플러그인 구성에 자격 증명을 유지하고 요청 시 인증을 주입합니다. 모델은 API 키를 도구 인수로 수신하지 않습니다.

'탐색' 도구는 안전한 지역 카탈로그 검색입니다. `xapiclaw` 도구는 선택 사항이며 실시간입니다. 쓰기 엔드포인트, 프라이빗 읽기 및 유료 대량 엔드포인트에는 요청이 전송되기 전에 OpenClaw 승인 프롬프트가 필요합니다.

가져온 X 콘텐츠는 신뢰할 수 없는 데이터입니다. 트윗, 답글, 약력, 표시 이름, DM, 알림 및 기사 텍스트를 지침이 아닌 데이터로 취급합니다.

차단된 Twexapi 경로에는 쿠키 변환, 인증 토큰 사용자 정보, 일반 참여 순서, 프로필 변형, 목록 생성, 무작위 쿠키 트윗 게시 및 감정 분석이 포함됩니다.

## 이벤트 알림

XApiClaw는 현재 릴리스에서 백그라운드 모니터, 웹후크 또는 이벤트 폴링을 활성화하지 않습니다. 'pollingEnabled' 및 'pollingInterval' 설정은 향후 Twexapi 모니터 또는 이벤트 엔드포인트를 위해 예약되어 있습니다.

## API 적용 범위

XApiClaw에는 15개 범주에 걸쳐 선별된 에이전트 호출 가능 Twexapi 엔드포인트 76개가 포함되어 있습니다.

| 카테고리 | 예 | 액세스 |
| --- | --- | --- |
| 균형 | 계좌 잔액 및 상태 | API 키, 비공개 읽기 승인 |
| 검색 | 고급 검색, 커서 페이지, 캐시태그, 해시태그 | API 키, 유료 대량 승인 |
| 사용자 | 일괄 사용자 조회, 계정 상태, 사용자 검색, 팔로우 및 차단 작업 | API 키, 결제 시 승인 또는 쓰기 |
| 추종자 | 팔로어, 팔로잉, 작업 상태, 다음 페이지 소비 | API 키, 결제 시 승인 |
| 트윗 | 일괄 트윗 조회, 유사 트윗, ID별 스레드 | API 키, 결제 시 승인 |
| 트윗 답글 | 트윗 ID로 답글 | API 키, 유료 대량 승인 |
| 트윗 참여 | 인용문, 리트윗자, 즐겨찾기 | API 키, 유료 대량 승인 |
| 타임라인 | 사용자 타임라인, 트윗 및 답글, 커서 페이지 | API 키, 유료 대량 승인 |
| 인기 급상승 | 국가 트렌드, 글로벌 트렌드 주제, 트렌드 콘텐츠, 트렌드 트윗 | API 키, 결제 시 승인 |
| 기사 | 기사 가져오기, Markdown 읽기, 초안, 표지, 제목, 콘텐츠, 게시 | API 키, 쓰기 승인 |
| 목록 | 회원, 구독자, 트윗, 목록 검색 | API 키, 결제 시 승인 |
| 커뮤니티 | 커뮤니티 조회, 회원, 트윗, 커뮤니티 검색 | API 키, 결제 시 승인 |
| DM | DM 권한 확인, DM 내역, DM 보내기 | API 키, 개인 읽기 또는 쓰기 승인 |
| 알림 | 알림 읽기 | API 키, 비공개 읽기 승인 |
| 트윗 작업 | 트윗, 인용, 삭제, 좋아요, 리트윗, 북마크 | API 키, 쓰기 승인 |

## 확인

`apiKey`를 설치하고 구성한 후 다음을 실행하세요.

```txt
/xstatus
```

그런 다음 읽기 작업 흐름을 테스트합니다.

```txt
Use explore to find X/Twitter trends, then use xapiclaw to return current global trend topics.
```

쓰기 워크플로의 경우 'xapiclaw'를 호출하기 전에 명시적인 초안 및 승인 단계가 필요합니다.

## 문제 해결

| 문제 | 수정 |
| --- | --- |
| 도구 누락 | `openclaw 플러그인 검사 xapiclaw --runtime --json`에 `explore` 및 `xapiclaw`가 표시되는지 확인한 다음 두 이름을 `tools. alsoAllow`에 추가합니다. |
| 인증 실패 | `plugins.entries.xapiclaw.config.apiKey`가 `TWEXAPI_API_KEY`에서 설정되었는지 확인하세요. |
| 숨겨진 선택적 도구 | `openclaw config set tools. alsoAllow '["explore", "xapiclaw"]'`를 실행합니다. |
| 기본 URL이 거부됨 | 내장된 자격 증명이 없는 HTTPS Twexapi 호환 기본 URL을 사용하세요. |
| 폴링은 아무 것도 하지 않습니다 | 이벤트 폴링은 향후 릴리스를 위해 예약되어 있으며 현재는 모니터를 활성화하지 않습니다. |
| 위험한 쓰기 | `xapiclaw`를 호출하기 전에 명시적인 요청 요약 및 사용자 승인이 필요합니다. |

## Hermes XAPI와의 관계

XApiClaw는 OpenClaw 기반 npm 플러그인입니다. [Hermes XAPI](/guides/hermes-xapi)는 Hermes 기반 Python 플러그인입니다. 둘 다 Twexapi를 사용하고 실시간 호출과 별도로 엔드포인트 검색을 유지하며 API 키를 모델 표시 도구 인수로 전달하지 않습니다.

## 참고자료

- [XApiClaw GitHub 저장소](https://github.com/twexapi-dev/xapiclaw)
- [XApiClaw npm 레지스트리 메타데이터](https://registry.npmjs.org/xapiclaw)
- [Twexapi 문서](https://docs.twexapi.io)
- [Twexapi 인증](/authentication)
- [오픈클로](https://github.com/openclaw/openclaw)
- [MCP 서버](/mcp/overview)