OpenClaw용 XApiClaw

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

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

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

전제 조건

• OpenClaw 2026.6.8 이상
• Node.js 22 이상
• 대시보드의 Twexapi API 키

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

설치

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

openclaw plugins install npm:xapiclaw

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

openclaw plugins update xapiclaw

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

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를 구성합니다.

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

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

Authorization: Bearer YOUR_API_KEY

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

선택적 설정

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

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

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

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

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

도구

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

탐색

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

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

xapiclaw

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

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

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

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

워크플로 핸드오프

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

트윗 검색

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

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}를 호출하세요.

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를 반환하는 경우 계속하기 전에 문서화된 상태와 다음 페이지 경로를 폴링합니다.

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.

동향 조사

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

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.

제어된 쓰기 작업

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

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.

런타임 진단

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

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

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

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

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

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

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

슬래시 명령

안전 모델

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

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

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

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

이벤트 알림

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

API 적용 범위

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

확인

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

/xstatus

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

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

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

문제 해결

Hermes XAPI와의 관계

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

참고자료

• XApiClaw GitHub 저장소
• XApiClaw npm 레지스트리 메타데이터
• Twexapi 문서
• Twexapi 인증
• 오픈클로
• MCP 서버