@framers/agentos-ext-channel-twitter

中文文档
0.1.6发布于 2026/11/11Apache-2.0TypeScriptCommonJS构建来源已验证近 30 天下载 2万

AgentOS的Twitter/X频道适配器——通过Twitter API v2发布微博,回复,引用,线程,搜索趋势,DMs,以及参与分析.

中文使用文档
文档目录19 节
  1. 安装
  2. 使用量
  3. 配置
  4. 工具
  5. twitterPost
  6. twitterReply
  7. twitterQuote
  8. twitterLike
  9. twitterRetweet
  10. twitterSearch
  11. twitterTrending
  12. twitterTimeline
  13. twitterDm
  14. twitterAnalytics
  15. twitterSchedule
  16. twitterThread
  17. 频道适配器
  18. 页:1
  19. 许可证

Twitter频道

这包在推特上发布、回复、引用、线程、约定、搜索、趋势、直接信息、分析以及排程 twitter-api-v2。 。 。 .

安装

npm install @framers/agentos-ext-channel-twitter

同伴依赖 : @framers/agentos >=0.10.40。 。 。 .

使用量

import { AgentOS } from '@framers/agentos';

const agentos = await AgentOS.create({
  extensionManifest: {
    packs: [
      {
        package: '@framers/agentos-ext-channel-twitter',
        options: {
          bearerToken: process.env.TWITTER_BEARER_TOKEN,
          apiKey: process.env.TWITTER_API_KEY,
          apiSecret: process.env.TWITTER_API_SECRET,
          accessToken: process.env.TWITTER_ACCESS_TOKEN,
          accessSecret: process.env.TWITTER_ACCESS_SECRET,
        },
      },
    ],
  },
});

配置

选项秘密编号环境变量需求默认
bearerTokentwitter.bearerTokenTWITTER_BEARER_TOKEN, (中文(简体) ), X_BEARER_TOKEN是的,根据清单无
apiKeytwitter.apiKeyTWITTER_API_KEY, (中文(简体) ), X_API_KEY, (中文(简体) ), X_CONSUMER_KEY, (中文(简体) ), TWITTER_CONSUMER_KEY没有无
apiSecrettwitter.apiSecretTWITTER_API_SECRET, (中文(简体) ), X_API_SECRET, (中文(简体) ), X_CONSUMER_SECRET, (中文(简体) ), X_CONSUMER_SECRET_KEY, (中文(简体) ), TWITTER_CONSUMER_SECRET没有无
accessTokentwitter.accessTokenTWITTER_ACCESS_TOKEN, (中文(简体) ), X_ACCESS_TOKEN没有无
accessSecrettwitter.accessSecretTWITTER_ACCESS_SECRET, (中文(简体) ), X_ACCESS_SECRET, (中文(简体) ), X_ACCESS_TOKEN_SECRET, (中文(简体) ), TWITTER_ACCESS_TOKEN_SECRET没有无
secrets上面的所有证书密件无没有context.secrets,则 {}

从选项,然后是秘密,然后是列出的环境变量按顺序排列的证书决定. options.secrets 优先于 context.secrets。分辨率使用无效倒计时,所以一个空字符串块在后面值.

工具

工具它会做什么
twitterPost发布微博.
twitterReply回复已发微博.
twitterQuote引用已存在的一则微博并附评论.
twitterLike像是或不像一个微博.
twitterRetweet复发或取取一回.
twitterSearch有过滤和排序的搜索微博.
twitterTrending获取一个位置的趋势话题, 默认到世界范围 .
twitterTimeline获得认证用户的家庭时间线.
twitterDm发送或列出直接信件.
twitterAnalytics获得像,回转,回回和印象的微博.
twitterSchedule计划发布推特.
twitterThread贴出微博文本作为相继回复.

twitterPost

参数类型需求说明
text字符串对图文文本(最大) 280 字符)
mediaPath字符串没有要附加的媒体文件路径
pollOptions字符串 []没有投票方案(2 改为 4 选择)
pollDurationMinutes编号没有计时( 默认) 1440,一天) (中文(简体) )

twitterReply

参数类型需求说明
tweetId字符串对要回复的微博名称
text字符串对答复文本

twitterQuote

参数类型需求说明
tweetId字符串对要引用的微博的标识
text字符串对您的引用评论

twitterLike

参数类型需求说明
tweetId字符串对微博的标识
unlike布尔没有设定为 true 改为: 默认值 false

twitterRetweet

参数类型需求说明
tweetId字符串对推特的编号
undo布尔没有设定为 true 改为去除; 默认值 false

twitterSearch

参数类型需求说明
query字符串对搜索查询( 支持) Twitter搜索运营商)
maxResults编号没有要返回的最大微博( 默认) 10最大点 100(中文(简体) )
sortOrder字符串 : recency, (中文(简体) ), relevancy没有排序顺序

twitterTrending

参数类型需求说明
woeid编号没有位置的 Yahoo WOEID (1 =全世界, 23424977 =美国;默认值 1

twitterTimeline

参数类型需求说明
maxResults编号没有要返回的最大微博( 默认) 20最大点 100(中文(简体) )

twitterDm

参数类型需求说明
action字符串 : send, (中文(简体) ), list对拟采取的行动
recipientId字符串没有发送 DM 的用户ID( 需要发送)
text字符串没有信件文本( 需要发送)
maxResults编号没有要返回的 Max DM 事件( 对于列表); 默认 20

twitterAnalytics

参数类型需求说明
tweetId字符串对用于分析的微博标识

twitterSchedule

参数类型需求说明
text字符串对调试文本
scheduledAt字符串对ISO 8601 张贴时的印章
mediaPath字符串没有可选媒体文件路径

twitterThread

参数类型需求说明
tweets字符串[; 最小值 2 项目对微博文本阵列( 每个最大 280 字符). 贴为相接线条.

频道适配器

适配器注册平台 twitter。发送第一个文本块,通过SDK上传图像和视频块,附加民意测验选项,并将民意测验持续时间从小时转换为分钟。 写着 replyToMessageId 用于回复和忽略 conversationId。媒体上传失败被跳过。 反应无论提供的反应如何,都称类似操作.

激活初始化API客户端. 连接状态遵循服务运行状态,初始化错误暴露在连接信息中. 适配器存储处理器,但不发布入境事件. 打字指标无用.

页:1

一个无记名符号提供读取客户端. 需要张贴、接触、媒体上传、家庭时间表和直接信息 apiKey, (中文(简体) ), apiSecret, (中文(简体) ), accessToken 财务报告和审定财务报表 accessSecret 一起来 该服务还使用在未设定无记名符号时写入客户端的读取功能, 尽管该列表声明 twitter.bearerToken 所需经费.

如果没有 bearerToken 也没有 apiKey 设置, 激活试图加载存储 Twitter 访问令牌通过 FileTokenStore 从 @framers/agentos/auth。如果无法创建读取或写入客户端,则初始化将丢出.

写作工具发布微博,发送消息或更改喜欢和回转. 线条依次不回滚而后起. recipientId 直接传给SDK的 sendDmInConversation 方法。 时间线和直接信息列名请求上限为 100 结果; 前进搜索 maxResults 没有本地上限, 默认为 relevancy 正在排序.

将计时器安排在内存中, 无需坚持或取消 。 一个过去的时间戳 立即忽略 mediaPath。未来的预定帖子会在执行时上传媒体,并默地丢弃失败。 包停用会关闭服务, 但不会清除预定的计时器 .

许可证

阿帕奇 - 2.0

版本与发布记录

@framers/agentos-ext-channel-twitter 共发布 7 个版本,首次发布于 2026/05/02;过去 12 个月发布了 7 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.1.6latest2026/11/114 天前
0.1.52026/11/0115 天前
0.1.42026/10/2125 天前
0.1.32026/10/121 个月前
0.1.22026/10/111 个月前
0.1.12026/10/081 个月前

关于 @framers/agentos-ext-channel-twitter 的常见问题

@framers/agentos-ext-channel-twitter 是什么?

AgentOS的Twitter/X频道适配器——通过Twitter API v2发布微博,回复,引用,线程,搜索趋势,DMs,以及参与分析.

如何安装 @framers/agentos-ext-channel-twitter?

在项目目录运行 npm install @framers/agentos-ext-channel-twitter,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@framers/agentos(>=0.10.40)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@framers/agentos-ext-channel-twitter 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@framers/agentos-ext-channel-twitter 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@framers/agentos-ext-channel-twitter 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@framers/agentos-ext-channel-twitter 可以商用吗?

@framers/agentos-ext-channel-twitter 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@framers/agentos-ext-channel-twitter 的下载量有多少?

根据 npm 官方下载统计,@framers/agentos-ext-channel-twitter 在 2026/10/16 – 2026/11/14 这 30 天内被下载 20,234 次,日均约 674 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@framers/agentos-ext-channel-twitter 还在维护吗?

最新版本 0.1.6 发布于 2026/11/11(4 天前);至今共发布 7 个版本,其中过去 12 个月发布了 7 个;首次发布于 2026/05/02。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。