How should x-oauth-api be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

Claim this agent

Agent DossierGITHUB OPENCLEWSafety 100/100

Xpersona Agent

x-oauth-api

Post to X (Twitter) using the official OAuth 1.0a API. Free tier compatible. --- name: x-oauth-api description: Post to X (Twitter) using the official OAuth 1.0a API. Free tier compatible. metadata: { "openclaw": { "requires": { "env": ["X_API_KEY", "X_API_SECRET", "X_ACCESS_TOKEN", "X_ACCESS_TOKEN_SECRET"] } } } --- X OAuth API Skill Post to X (formerly Twitter) using the official X API with OAuth 1.0a authentication. Overview This skill provides direct access to X API v2 for posting tweets,

OpenClaw · self-declared

Schema refs publishedTrust evidence available

View Source

git clone https://github.com/ngmeyer/x-oauth-api.git

Overall rank

#30

Adoption

No public adoption signal

Trust

Unknown

Freshness

Feb 24, 2026

Freshness

Last checked Feb 24, 2026

Best For

Contract is available with explicit auth and schema references.

Not Ideal For

x-oauth-api is not ideal for teams that need stronger public trust telemetry, lower setup complexity, or more explicit contract coverage before production rollout.

Evidence Sources Checked

editorial-content, capability-contract, runtime-metrics, public facts pack

Overview Evidence & Timeline Artifacts & Docs API & Reliability Media & Related Machine Appendix

Overview

Key links, install path, reliability highlights, and the shortest practical read before diving into the crawl record.

Verifiededitorial-content

Overview

Executive Summary

No verified compatibility signals

Trust score

Unknown

Compatibility

OpenClaw

Freshness

Feb 24, 2026

Vendor

Ngmeyer

Artifacts

Benchmarks

Last release

Unpublished

Install & run

Setup Snapshot

git clone https://github.com/ngmeyer/x-oauth-api.git

1
Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
2
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Evidence & Timeline

Public facts grouped by evidence type, plus release and crawl events with provenance and freshness.

Verifiededitorial-content

Public facts

Evidence Ledger

Vendor (1)

Vendor

Ngmeyer

profilemedium

Observed Apr 15, 2026Source link Provenance

Compatibility (2)

Protocol compatibility

OpenClaw

contractmedium

Observed Feb 24, 2026Source link Provenance

Auth modes

api_key, oauth

contracthigh

Observed Feb 24, 2026Source link Provenance

Artifact (1)

Machine-readable schemas

OpenAPI or schema references published

contracthigh

Observed Feb 24, 2026Source link Provenance

Security (1)

Handshake status

UNKNOWN

trustmedium

Observed unknownSource link Provenance

Integration (1)

Crawlable docs

6 indexed pages on the official domain

search_documentmedium

Observed Apr 15, 2026Source link Provenance

Events

Release & Crawl Timeline

Docs Update

Docs refreshed: Sign in to GitHub · GitHub

search_documentmedium

Fresh crawlable documentation was indexed for the official domain.

Observed Apr 15, 2026

Artifacts & Docs

Parameters, dependencies, examples, extracted files, editorial overview, and the complete README when available.

Self-declaredGITHUB OPENCLEW

Captured outputs

Artifacts Archive

Extracted files

Examples

Snippets

Languages

typescript

Parameters

Executable Examples

text

X_API_KEY              # Consumer Key (API Key)
X_API_SECRET           # Consumer Secret
X_ACCESS_TOKEN         # Access Token
X_ACCESS_TOKEN_SECRET  # Access Token Secret
X_USER_ID              # Optional: Your numeric user ID (speeds up mentions)

bash

# Post a simple tweet
x post "Hello from X API"

# Post a thread
x thread "First tweet" "Second tweet" "Third tweet"

# Check mentions
x mentions --limit 10

# Search recent tweets
x search "AI agents" --limit 5

Editorial read

Docs & README

Docs source

GITHUB OPENCLEW

Editorial quality

ready

Full README

name: x-oauth-api description: Post to X (Twitter) using the official OAuth 1.0a API. Free tier compatible. metadata: { "openclaw": { "requires": { "env": ["X_API_KEY", "X_API_SECRET", "X_ACCESS_TOKEN", "X_ACCESS_TOKEN_SECRET"] } } }

X OAuth API Skill

Post to X (formerly Twitter) using the official X API with OAuth 1.0a authentication.

Overview

This skill provides direct access to X API v2 for posting tweets, managing threads, and monitoring mentions. No proxy or third-party service required — uses your X API credentials directly.

Use when:

User says "post to X", "tweet this", "post on Twitter"
Need to create threads or media posts
Want to check mentions or engage with replies

Quick Start

1. Configure X API Credentials

Store these environment variables (from your X Developer Account):

X_API_KEY              # Consumer Key (API Key)
X_API_SECRET           # Consumer Secret
X_ACCESS_TOKEN         # Access Token
X_ACCESS_TOKEN_SECRET  # Access Token Secret
X_USER_ID              # Optional: Your numeric user ID (speeds up mentions)

Free Tier vs Paid Tier

Free tier supports:

✅ Posting tweets and threads
✅ Deleting tweets
✅ Account info lookup (x me)

Requires Basic+ tier:

🔒 Search tweets
🔒 Fetch mentions
🔒 Media uploads

2. Basic Usage

# Post a simple tweet
x post "Hello from X API"

# Post a thread
x thread "First tweet" "Second tweet" "Third tweet"

# Check mentions
x mentions --limit 10

# Search recent tweets
x search "AI agents" --limit 5

Commands

`x post <text>`

Post a single tweet.

Options:

--reply-to <tweet-id> - Reply to a specific tweet
--quote <tweet-id> - Quote tweet
--media <file> - Attach image/video

`x thread <tweet1> <tweet2> ...`

Post a tweet thread.

`x mentions [options]`

Get recent mentions of your account.

Options:

--limit <n> - Number of mentions (default: 10, max: 100)
--since <tweet-id> - Only mentions after this ID
--format json - Output as JSON

`x search <query> [options]`

Search recent tweets.

Options:

--limit <n> - Number of results (default: 10, max: 100)
--format json - Output as JSON

`x delete <tweet-id>`

Delete a tweet.

`x me`

Show current account info (name, username, follower counts, user ID).

API Rate Limits

| Endpoint | Limit | Window | |----------|-------|--------| | POST /2/tweets | 200 | 15 min (Free tier) | | GET /2/tweets/search/recent | 100 | 15 min (Free tier) | | GET /2/users/:id/mentions | 100 | 15 min (Free tier) |

Rate limits vary by access tier. See X API documentation for details.

Authentication

OAuth 1.0a is handled transparently. Just provide your credentials via environment variables. The skill will sign all requests automatically.

Troubleshooting

"Unauthorized" error

Check X API credentials are correct
Verify credentials are set in environment
Ensure your app has write permissions in X Developer Portal

"Rate limit exceeded"

Wait 15 minutes for limit to reset
Reduce request frequency

"This endpoint requires a paid X API tier"

Search and mentions require Basic+ tier on X API
Free tier only supports posting, deleting, and account lookup

Requirements

X Developer Account with API access
OAuth 1.0a credentials configured
Network access to api.twitter.com

Cost

Free. X API is free for basic usage. Check your app's rate limits in X Developer Portal.

API & Reliability

Machine endpoints, contract coverage, trust signals, runtime metrics, benchmarks, and guardrails for agent-to-agent use.

Verifiedcapability-contract

Machine interfaces

Contract & API

Endpoints

Dossier API Snapshot API Contract API Trust API

Contract coverage

Status

ready

Auth

api_key, oauth

Streaming

Data region

global

Protocol support

OpenClaw: self-declared

Requires: openclew, lang:typescript

Forbidden: none

Guardrails

Operational confidence: medium

Contract is available with explicit auth and schema references.

Trust confidence is not low and verification freshness is acceptable.

Invocation examples

curl -s "https://xpersona.co/api/v1/agents/ngmeyer-x-oauth-api/snapshot"

curl -s "https://xpersona.co/api/v1/agents/ngmeyer-x-oauth-api/contract"

curl -s "https://xpersona.co/api/v1/agents/ngmeyer-x-oauth-api/trust"

Operational fit

Reliability & Benchmarks

Trust signals

Handshake

UNKNOWN

Confidence

unknown

Attempts 30d

unknown

Fallback rate

unknown

Runtime metrics

Observed P50

unknown

Observed P95

unknown

Rate limit

unknown

Estimated cost

unknown

No benchmark suites or observed failure patterns are available.

Machine Appendix

Raw contract, invocation, trust, capability, facts, and change-event payloads for machine-side inspection.

Verifiedcapability-contract

Contract JSON

{
  "contractStatus": "ready",
  "authModes": [
    "api_key",
    "oauth"
  ],
  "requires": [
    "openclew",
    "lang:typescript"
  ],
  "forbidden": [],
  "supportsMcp": false,
  "supportsA2a": false,
  "supportsStreaming": false,
  "inputSchemaRef": "https://github.com/ngmeyer/x-oauth-api#input",
  "outputSchemaRef": "https://github.com/ngmeyer/x-oauth-api#output",
  "dataRegion": "global",
  "contractUpdatedAt": "2026-02-24T19:52:25.061Z",
  "sourceUpdatedAt": "2026-02-24T19:52:25.061Z",
  "freshnessSeconds": 4438165
}

Invocation Guide

{
  "preferredApi": {
    "snapshotUrl": "https://xpersona.co/api/v1/agents/ngmeyer-x-oauth-api/snapshot",
    "contractUrl": "https://xpersona.co/api/v1/agents/ngmeyer-x-oauth-api/contract",
    "trustUrl": "https://xpersona.co/api/v1/agents/ngmeyer-x-oauth-api/trust"
  },
  "curlExamples": [
    "curl -s \"https://xpersona.co/api/v1/agents/ngmeyer-x-oauth-api/snapshot\"",
    "curl -s \"https://xpersona.co/api/v1/agents/ngmeyer-x-oauth-api/contract\"",
    "curl -s \"https://xpersona.co/api/v1/agents/ngmeyer-x-oauth-api/trust\""
  ],
  "jsonRequestTemplate": {
    "query": "summarize this repo",
    "constraints": {
      "maxLatencyMs": 2000,
      "protocolPreference": [
        "OPENCLEW"
      ]
    }
  },
  "jsonResponseTemplate": {
    "ok": true,
    "result": {
      "summary": "...",
      "confidence": 0.9
    },
    "meta": {
      "source": "GITHUB_OPENCLEW",
      "generatedAt": "2026-04-17T04:41:50.884Z"
    }
  },
  "retryPolicy": {
    "maxAttempts": 3,
    "backoffMs": [
      500,
      1500,
      3500
    ],
    "retryableConditions": [
      "HTTP_429",
      "HTTP_503",
      "NETWORK_TIMEOUT"
    ]
  }
}

Trust JSON

{
  "status": "unavailable",
  "handshakeStatus": "UNKNOWN",
  "verificationFreshnessHours": null,
  "reputationScore": null,
  "p95LatencyMs": null,
  "successRate30d": null,
  "fallbackRate": null,
  "attempts30d": null,
  "trustUpdatedAt": null,
  "trustConfidence": "unknown",
  "sourceUpdatedAt": null,
  "freshnessSeconds": null
}

Capability Matrix

{
  "rows": [
    {
      "key": "OPENCLEW",
      "type": "protocol",
      "support": "unknown",
      "confidenceSource": "profile",
      "notes": "Listed on profile"
    },
    {
      "key": "posting",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    }
  ],
  "flattenedTokens": "protocol:OPENCLEW|unknown|profile capability:posting|supported|profile"
}

Facts JSON

[
  {
    "factKey": "vendor",
    "category": "vendor",
    "label": "Vendor",
    "value": "Ngmeyer",
    "href": "https://github.com/ngmeyer/x-oauth-api",
    "sourceUrl": "https://github.com/ngmeyer/x-oauth-api",
    "sourceType": "profile",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:21:22.124Z",
    "isPublic": true
  },
  {
    "factKey": "docs_crawl",
    "category": "integration",
    "label": "Crawlable docs",
    "value": "6 indexed pages on the official domain",
    "href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceType": "search_document",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:03:46.393Z",
    "isPublic": true
  },
  {
    "factKey": "protocols",
    "category": "compatibility",
    "label": "Protocol compatibility",
    "value": "OpenClaw",
    "href": "https://xpersona.co/api/v1/agents/ngmeyer-x-oauth-api/contract",
    "sourceUrl": "https://xpersona.co/api/v1/agents/ngmeyer-x-oauth-api/contract",
    "sourceType": "contract",
    "confidence": "medium",
    "observedAt": "2026-02-24T19:52:25.061Z",
    "isPublic": true
  },
  {
    "factKey": "auth_modes",
    "category": "compatibility",
    "label": "Auth modes",
    "value": "api_key, oauth",
    "href": "https://xpersona.co/api/v1/agents/ngmeyer-x-oauth-api/contract",
    "sourceUrl": "https://xpersona.co/api/v1/agents/ngmeyer-x-oauth-api/contract",
    "sourceType": "contract",
    "confidence": "high",
    "observedAt": "2026-02-24T19:52:25.061Z",
    "isPublic": true
  },
  {
    "factKey": "schema_refs",
    "category": "artifact",
    "label": "Machine-readable schemas",
    "value": "OpenAPI or schema references published",
    "href": "https://github.com/ngmeyer/x-oauth-api#input",
    "sourceUrl": "https://xpersona.co/api/v1/agents/ngmeyer-x-oauth-api/contract",
    "sourceType": "contract",
    "confidence": "high",
    "observedAt": "2026-02-24T19:52:25.061Z",
    "isPublic": true
  },
  {
    "factKey": "handshake_status",
    "category": "security",
    "label": "Handshake status",
    "value": "UNKNOWN",
    "href": "https://xpersona.co/api/v1/agents/ngmeyer-x-oauth-api/trust",
    "sourceUrl": "https://xpersona.co/api/v1/agents/ngmeyer-x-oauth-api/trust",
    "sourceType": "trust",
    "confidence": "medium",
    "observedAt": null,
    "isPublic": true
  }
]

Change Events JSON

[
  {
    "eventType": "docs_update",
    "title": "Docs refreshed: Sign in to GitHub · GitHub",
    "description": "Fresh crawlable documentation was indexed for the official domain.",
    "href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceType": "search_document",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:03:46.393Z",
    "isPublic": true
  }
]

Overview

Executive Summary

Setup Snapshot

Evidence & Timeline

Evidence Ledger

Release & Crawl Timeline

Artifacts & Docs

Artifacts Archive

Docs & README

name: x-oauth-api description: Post to X (Twitter) using the official OAuth 1.0a API. Free tier compatible. metadata: { "openclaw": { "requires": { "env": ["X_API_KEY", "X_API_SECRET", "X_ACCESS_TOKEN", "X_ACCESS_TOKEN_SECRET"] } } }

X OAuth API Skill

Overview

Quick Start

1. Configure X API Credentials

Free Tier vs Paid Tier

2. Basic Usage

Commands

x post <text>

x thread <tweet1> <tweet2> ...

x mentions [options]

x search <query> [options]

x delete <tweet-id>

x me

API Rate Limits

Authentication

Troubleshooting

Requirements

Cost

API & Reliability

Contract & API

Reliability & Benchmarks

Media & Related

Media & Demo

Related Agents

Machine Appendix

`x post <text>`

`x thread <tweet1> <tweet2> ...`

`x mentions [options]`

`x search <query> [options]`

`x delete <tweet-id>`

`x me`