xurl 是做什么的？
使用 xurl 进行 X API 相关操作。快捷命令返回 JSON；原始模式可用于任意 v2 端点。
认证
~/.xurl存储令牌；请使用xurl auth status检查认证状态，而非直接读取该文件。- 通过提示符将密钥传递给认证命令，不要内联传递，以使其远离 shell 历史记录。
--verbose会在工具输出中打印认证头。
常用快捷命令
xurl post "Hello world!"
xurl reply POST_ID "Nice."
xurl quote POST_ID "My take"
xurl delete POST_ID
xurl read POST_ID
xurl search "query" -n 20
xurl whoami
xurl user @handle
xurl timeline -n 20
xurl mentions -n 10
xurl like POST_ID
xurl unlike POST_ID
xurl repost POST_ID
xurl unrepost POST_ID
xurl bookmark POST_ID
xurl unbookmark POST_ID
xurl followers -n 20
xurl following -n 20
xurl follow @handle
xurl unfollow @handle
xurl block @handle
xurl unblock @handle
xurl mute @handle
xurl unmute @handle
xurl dm @handle "message"
xurl dms -n 10
POST_ID 可以是完整的 https://x.com/<user>/status/<id> URL。
媒体
xurl media upload image.jpg
xurl media upload clip.mp4
xurl media status MEDIA_ID
xurl post "caption" --media-id MEDIA_ID
视频可能需要处理；请轮询 media status。
认证/应用管理
xurl auth status
xurl auth apps list
xurl auth default
xurl auth default APP_NAME USERNAME
xurl auth apps remove APP_NAME
按请求指定：
xurl --app APP_NAME /2/users/me
xurl --auth oauth2 /2/users/me
原始 API
xurl /2/users/me
xurl -X POST /2/tweets -d '{"text":"Hello world!"}'
xurl '/2/tweets/search/recent?query=openclaw&max_results=10'
当快捷命令无法覆盖某个端点时，使用原始模式。对于复杂的 JSON 负载，请将其保存在临时文件中。
输出与错误
- 成功时输出 JSON stdout。
- API/认证/网络错误时返回非零退出码。
- 401/403：认证、作用域或应用不匹配；请检查
xurl auth status。 - 429：速率限制，请退避。
- 媒体上传失败：请检查文件类型/大小和媒体处理状态。