--- title: "OpenClaw için XApiClaw" description: "Twexapi destekli X/Twitter otomasyonu için XApiClaw OpenClaw eklentisini kurun ve yapılandırın." --- XApiClaw, bir OpenClaw agent'ından Twexapi kullanmak için OpenClaw eklentisidir. Agent'ınıza güvenli yerel bir uç nokta kataloğu, isteğe bağlı canlı Twexapi çağırıcısı, slash komutları, API anahtarı enjeksiyonu ve özel, ücretli veya yazma benzeri eylemler için onay kapıları sağlar. Bir OpenClaw iş akışının X/Twitter araması, tweet yanıtları, zaman çizelgeleri, takipçi dışa aktarımları, kullanıcı sorgulamaları, trendler, listeler, topluluklar, DM'ler, makaleler, hesap durumu kontrolleri veya açık kullanıcı onaylı yazma eylemlerine ihtiyacı olduğunda XApiClaw kullanın. ## Önkoşullar - OpenClaw `2026.6.8` veya daha yeni - Node.js `22` veya daha yeni - [dashboard](https://twexapi.io/dashboard) üzerinden bir Twexapi API anahtarı Agent eklentilerini yalnızca güvenilir kaynaklardan kurun. OpenClaw eklentileri yerel agent ortamınızda kod çalıştırır; üretim kurulumları için sürümleri sabitleyin. ## Kurulum npm paketini OpenClaw'ın açık npm kaynak seçicisiyle kurun: ```bash openclaw plugins install npm:xapiclaw ``` Normal yükseltmeler için izlenen kurulum kaynağını yeniden kullanın: ```bash openclaw plugins update xapiclaw ``` Tekrarlanabilir üretim kurulumları için yayınlanmış bir npm sürümünü sabitleyin: ```bash openclaw plugins install npm:xapiclaw@0.1.0 --pin ``` Paket adı `xapiclaw`, eklenti kimliği `xapiclaw` ve mevcut paket sürümü `0.1.0`'dır. OpenClaw kurulumunuz `OPENCLAW_NIX_MODE=1` ile çalışıyorsa eklenti yaşam döngüsü mutatörleri devre dışıdır. `openclaw plugins install` veya `openclaw plugins update` yerine Nix OpenClaw kaynağınız üzerinden XApiClaw kurun veya güncelleyin. XApiClaw kimlik bilgileri yapılandırılmadan önce kurulabilir. Twexapi API anahtarı eklemeden önce ücretsiz `explore` kataloğu kullanılabilir kalır ve canlı API çağrıları kurulum rehberi döndürür. ## API Key Auth yapılandırması Bir Twexapi API anahtarı oluşturun, ortam değişkeninde saklayın, ardından XApiClaw'ı yapılandırın: ```bash export TWEXAPI_API_KEY="twitterx_..." openclaw config set plugins.entries.xapiclaw.config.apiKey "$TWEXAPI_API_KEY" ``` XApiClaw anahtarı canlı isteklere şu şekilde enjekte eder: ```http Authorization: Bearer YOUR_API_KEY ``` Anahtarı sohbetlerden, belgelerden ve kabuk geçmişinden uzak tutun. OpenClaw'ın gizli anahtarı bir prompt'ta açığa çıkarmadan yerel eklenti yapılandırmasına yazması için yukarıdaki ortam değişkeni komutunu tercih edin. ## İsteğe bağlı ayarlar Twexapi uyumlu bir dağıtım işletmiyorsanız varsayılan API taban URL'sini kullanın: ```bash openclaw config set plugins.entries.xapiclaw.config.baseUrl "https://api.twexapi.io" ``` XApiClaw gömülü kimlik bilgisi olmayan bir HTTPS taban URL'si gerektirir. Yoklama ayarları gelecekteki olay desteği için ayrılmıştır ve mevcut sürümde arka plan monitörlerini etkinleştirmez: ```bash openclaw config set plugins.entries.xapiclaw.config.pollingEnabled false openclaw config set plugins.entries.xapiclaw.config.pollingInterval 60 ``` ## Araçlar XApiClaw iki yapılandırılmış araç sunar. ### `explore` Paketlenmiş Twexapi uç nokta kataloğunda arama yapın; yöntemleri, yolları, parametreleri, risk bayraklarını ve maliyet notlarını inceleyin. Bu araç yereldir ve ağ çağrısı yapmaz. ```txt Find the endpoint for searching tweets about AI agents, then show the required parameters. ``` ### `xapiclaw` Yapılandırılmış `method`, `path`, `query` ve `body` girdisiyle katalogda listelenen Twexapi uç noktalarını çağırın. Kimlik doğrulama eklenti tarafından enjekte edilir; model API anahtarınızı araç argümanı olarak almaz. `xapiclaw` aracı isteğe bağlıdır çünkü kredi harcayabilir, özel hesap verilerini okuyabilir veya yazma eylemleri gerçekleştirebilir. OpenClaw isteğe bağlı araçları gizliyorsa açıkça izin verin: ```bash openclaw config set tools.alsoAllow '["explore", "xapiclaw"]' ``` OpenClaw onay prompt'ları yazma, özel okuma ve ücretli toplu çağrılardan önce çalışır. Onaylamadan önce istek hedefini, uç noktayı, yükü ve beklenen maliyeti inceleyin. ## İş akışı devirleri Önce `explore` kullanın, ardından yalnızca çalıştırmayı planladığınız uç nokta, hedef ve limit için `xapiclaw` çağırın. ### Tweet arama `/twitter/advanced_search/page` bulmak için `explore` kullanın, ardından sınırlı arama parametreleriyle `xapiclaw` çağırın. ```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. ``` ### Tweet yanıtları Yanıt uç noktalarını bulmak için `explore` kullanın, ardından sınırlı sayı ve sıralama seçeneğiyle `/twitter/tweets/{tweet_id}/replies/{count}` çağırın. ```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. ``` ### Takipçi dışa aktarma Sınırlı dışa aktarımlar için takipçi uç noktalarını kullanın. Yanıt bir görev kimliği döndürürse devam etmeden önce belgelenmiş durum ve sonraki sayfa rotalarını yoklayın. ```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. ``` ### Trend araştırması Pazar veya içerik araştırması için küresel trend konu, ülke, içerik ve tweet uç noktalarını kullanın. ```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. ``` ### Kontrollü yazma eylemi Yazma uç noktalarını yalnızca kullanıcı tam isteği onayladıktan sonra kullanın. ```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. ``` ## Çalışma zamanı tanılaması Kurulum veya güncellemeden sonra çalışma zamanı kaydını doğrulayın: ```bash openclaw plugins inspect xapiclaw --runtime --json openclaw skills info xapiclaw ``` Çalışma zamanı incelemesi yüklenmiş `xapiclaw` eklentisini, `explore` aracını, isteğe bağlı `xapiclaw` aracını, onay kancasını ve `/xstatus` ile `/xtrends` komutlarını göstermelidir. OpenClaw XApiClaw skill'ini görebiliyor ancak araçları çağıramıyorsa her iki aracı da `tools.alsoAllow`'a ekleyin: ```bash openclaw config set tools.alsoAllow '["explore", "xapiclaw"]' ``` Sürüm benzeri yerel kontroller için OpenClaw'ın yayınlanmış `dist/index.js` girişini yüklemesi için depo klasörü yerine paketleyip kurun: ```bash npm pack openclaw plugins install npm-pack:./xapiclaw-0.1.0.tgz openclaw plugins inspect xapiclaw --runtime --json ``` ## Slash komutları | Komut | Amaç | | --- | --- | | `/xstatus` | `/balance` üzerinden Twexapi bakiyesini ve durumunu gösterir. | | `/xtrends` | `/twitter/global-trending/topics` üzerinden trend konularını gösterir. | ## Güvenlik modeli XApiClaw kimlik bilgilerini OpenClaw eklenti yapılandırmasında tutar ve kimlik doğrulamayı istek zamanında enjekte eder. Model API anahtarınızı araç argümanı olarak almaz. `explore` aracı güvenli yerel katalog aramasıdır. `xapiclaw` aracı isteğe bağlı ve canlıdır. Yazma uç noktaları, özel okumalar ve ücretli toplu uç noktalar istek gönderilmeden önce OpenClaw onay prompt'u gerektirir. Getirilen X içeriği güvenilmeyen veridir. Tweet'leri, yanıtları, biyografileri, görünen adları, DM'leri, bildirimleri ve makale metnini talimat değil veri olarak ele alın. Engellenen Twexapi yolları arasında çerez dönüştürme, auth-token kullanıcı bilgisi, genel etkileşim sıralaması, profil değişikliği, liste oluşturma, rastgele çerezli tweet gönderimi ve duygu analizi bulunur. ## Olay bildirimleri XApiClaw mevcut sürümde arka plan monitörlerini, webhook'ları veya olay yoklamasını etkinleştirmez. `pollingEnabled` ve `pollingInterval` ayarları gelecekteki Twexapi monitör veya olay uç noktaları için ayrılmıştır. ## API kapsamı XApiClaw 15 kategoride 76 seçilmiş agent çağrılabilir Twexapi uç noktası içerir. | Kategori | Örnekler | Erişim | | --- | --- | --- | | Balance | Hesap bakiyesi ve durumu | API anahtarı, özel okuma için onay | | Search | Gelişmiş arama, imleç sayfaları, cashtag'ler, hashtag'ler | API anahtarı, ücretli toplu onay | | Users | Toplu kullanıcı sorgulama, hesap durumu, kullanıcı arama, takip ve engelleme eylemleri | API anahtarı, ücretli veya yazma durumunda onay | | Followers | Takipçiler, takip edilenler, görev durumu, sonraki sayfa tüketimi | API anahtarı, ücretli durumda onay | | Tweets | Toplu tweet sorgulama, benzer tweet'ler, kimliğe göre thread | API anahtarı, ücretli durumda onay | | Tweet Replies | Tweet kimliğine göre yanıtlar | API anahtarı, ücretli toplu onay | | Tweet Engagement | Alıntılar, retweet edenler, beğenenler | API anahtarı, ücretli toplu onay | | Timeline | Kullanıcı zaman çizelgesi, tweet'ler ve yanıtlar, imleç sayfaları | API anahtarı, ücretli toplu onay | | Trending | Ülke trendleri, küresel trend konuları, trend içeriği, trend tweet'leri | API anahtarı, ücretli durumda onay | | Articles | Makale getirme, Markdown okuma, taslak, kapak, başlık, içerik, yayınlama | API anahtarı, yazmalar için onay | | Lists | Üyeler, aboneler, tweet'ler, liste arama | API anahtarı, ücretli durumda onay | | Communities | Topluluk sorgulama, üyeler, tweet'ler, topluluk arama | API anahtarı, ücretli durumda onay | | DM | DM izin kontrolü, DM geçmişi, DM gönderme | API anahtarı, özel okuma veya yazma için onay | | Notifications | Bildirim okumaları | API anahtarı, özel okuma onayı | | Tweet Actions | Tweet, alıntı, silme, beğeni, retweet, yer imi | API anahtarı, yazma onayı | ## Doğrulama `apiKey` kurulumundan ve yapılandırmasından sonra çalıştırın: ```txt /xstatus ``` Ardından bir okuma iş akışını test edin: ```txt Use explore to find X/Twitter trends, then use xapiclaw to return current global trend topics. ``` Yazma iş akışları için `xapiclaw` çağırmadan önce açık taslak ve onay adımı gerektirin. ## Sorun giderme | Sorun | Çözüm | | --- | --- | | Araçlar eksik | `openclaw plugins inspect xapiclaw --runtime --json` çıktısının `explore` ve `xapiclaw` gösterdiğini doğrulayın, ardından her iki adı `tools.alsoAllow`'a ekleyin. | | Kimlik doğrulama başarısız | `plugins.entries.xapiclaw.config.apiKey`'in `TWEXAPI_API_KEY`'den ayarlandığını doğrulayın. | | İsteğe bağlı araç gizli | `openclaw config set tools.alsoAllow '["explore", "xapiclaw"]'` çalıştırın. | | Taban URL reddedildi | Gömülü kimlik bilgisi olmayan HTTPS Twexapi uyumlu taban URL kullanın. | | Yoklama işe yaramıyor | Olay yoklaması gelecek bir sürüm için ayrılmıştır ve bugün monitörleri etkinleştirmez. | | Riskli yazma | `xapiclaw` çağırmadan önce açık istek özeti ve kullanıcı onayı gerektirin. | ## Hermes XAPI ile ilişki XApiClaw OpenClaw yerel npm eklentisidir. [Hermes XAPI](/guides/hermes-xapi) Hermes yerel Python eklentisidir. Her ikisi de Twexapi kullanır, uç nokta keşfini canlı çağrılardan ayırır ve API anahtarlarını model görünür araç argümanları olarak geçirmez. ## Referanslar - [XApiClaw GitHub repo](https://github.com/twexapi-dev/xapiclaw) - [XApiClaw npm registry metadata](https://registry.npmjs.org/xapiclaw) - [Twexapi documentation](https://docs.twexapi.io) - [Twexapi authentication](/authentication) - [OpenClaw](https://github.com/openclaw/openclaw) - [MCP Server](/mcp/overview)