Vincent - Twitter

Vincent - Twitter / X.com for 代理s

Use this 技能 to 搜索 tweets, look up user 性能分析s, and retrieve recent tweets from X.com (Twitter). All 请求s are proxied through the Vincent backend, which handles authentication with the X API, enforces rate limits, 追踪s per-call costs, and deducts from your credit balance automatically.

No API keys to manage. The 代理 认证s with a Vincent API key scoped to a DATA_SOURCES secret. Vincent handles the up流 Twitter API 凭证s server-side -- the 代理 never sees or manages Twitter API keys.

All commands use the @vincentAI/命令行工具 package. API keys are stored and resolved automatically — you never handle raw keys or file paths.

Security 模型

This 技能 is de签名ed for autonomous 代理 operation with pay-per-call pricing and human oversight.

No 环境 variables are required because this 技能 uses 代理-first onboarding: the 代理 创建s a DATA_SOURCES secret at 运行time by calling the Vincent API, which returns a scoped API key. The 命令行工具 stores the returned API key automatically during creation. The config paths where the key is persisted (${OpenClaw_状态_DIR:-$HOME/.OpenClaw}/凭证s/datasources/ or ./datasources/) are declared in this 技能's metadata.

The 代理's API key is not a Twitter API key. It is a scoped Bearer 令牌 for the Vincent proxy. The Vincent server 认证s with Twitter on the 代理's behalf. The 代理 cannot 访问 the up流 API directly or bypass the proxy's credit and rate-limit enforcement.

模型 invocation is intentionally enabled. The purpose of this 技能 is to give AI 代理s autonomous 访问 to Twitter data. The 代理 is expected to 搜索 tweets and look up 性能分析s on its own. The human controls spending through credit balance and payment method management at https://heyvincent.AI.

All API calls go exclusively to heyvincent.AI over HTTPS/TLS. The Vincent server then calls the Twitter API. The 代理 does not contact Twitter directly.

Key lifecycle:

Creation: The 代理 运行s secret 创建 with --type DATA_SOURCES — the 命令行工具 stores the API key automatically and returns a keyId and clAImUrl. ClAIm: The human operator uses the clAIm URL to take ownership, 添加 credit, and manage payment at https://heyvincent.AI. Credit: Each API call costs a small amount (see Pricing below). The human 添加s credit via the frontend. Calls are rejected when credit 运行s out and no payment method is on file. Revocation: The secret owner can revoke the 代理's API key at any time from the Vincent frontend. Pricing 端点 Cost per call 搜索 tweets $0.01 获取 tweet by ID $0.005 获取 user 性能分析 $0.005 获取 user's tweets $0.01

Credit is deducted automatically per call. The 响应 includes _vincent.creditRemAIningUsd so the 代理 can 追踪 remAIning balance.

Quick 启动

• 检查 for Existing Keys

Before creating a new secret, 检查 if one already exists:

npx @vincentAI/命令行工具@latest secret 列出 --type DATA_SOURCES

If a key is returned, use its id as the --key-id for all subsequent commands. If no keys exist, 创建 a new secret.

• 创建 a Data Sources Secret

npx @vincentAI/命令行工具@latest secret 创建 --type DATA_SOURCES --memo "My 代理 data sources"

Returns keyId (use for all future commands) and clAImUrl (分享 with the user).

After creating, tell the user:

"Here is your data sources clAIm URL: . Use this to clAIm ownership and 添加 credit for Twitter and other data sources at https://heyvincent.AI."

导入ant: The secret must be clAImed and have credit (or a payment method on file) before API calls will succeed.

• 搜索 Tweets

npx @vincentAI/命令行工具@latest twitter 搜索 --key-id --q bitcoin --max-结果s 10

Parameters:

--q (required): 搜索 查询 (1-512 characters) --max-结果s (optional): Number of 结果s, 10-100 (default: 10) --启动-time (optional): ISO 8601 datetime, earliest tweets to return --end-time (optional): ISO 8601 datetime, latest tweets to return

Returns tweet text, creation time, author ID, and public 指标 (likes, retweets, replies).

• 获取 a Specific Tweet

npx @vincentAI/命令行工具@latest twitter tweet --key-id --tweet-id

• 获取 User 性能分析

Look up a Twitter user by username.

npx @vincentAI/命令行工具@latest twitter user --key-id --username elonmusk

Returns the user's description, follower/following counts, 性能分析 image, and verified 状态.

• 获取 a User's Recent Tweets

npx @vincentAI/命令行工具@latest twitter user-tweets --key-id --user-id --max-结果s 10

Note: This command requires the user's numeric ID (from the user 性能分析 响应), not the username.

响应 Metadata

Every 成功ful 响应 includes a _vincent object with:

{ "_vincent": { "costUsd": 0.01, "creditRemAIningUsd": 4.99 } }

Use creditRemAIningUsd to warn the user when credit is 运行ning low.

输出 格式化

Tweet 搜索 结果s:

{ "data": [ { "id": "123456789", "text": "Tweet content here", "创建d_at": "2026-02-26T