人工智能大模型LLM 网关AI Agent即时通讯【免费下载链接】openclaw-zero-tokenOpenClaw: Use All Major AI Models NO API Token! Claude/ChatGPT/Gemini/DeepSeek/Doubao/Grok/Qwen/Manus/Kimi项目地址https://gitcode.com/gh_mirrors/op/openclaw-zero-token点击查看免费下载本文以仓库中 twitch/CHANGELOG.md 为核心骨架围绕 OpenClaw 官方 Twitch 频道插件openclaw/twitch展开梳理其自 2026.1.23 初始发布以来的版本演进脉络逐项拆解初始发布的功能清单并下沉到 twitch/src 目录下的源码实现讲清楚多账号、访问控制、Token 刷新、消息投递等机制的底层原理与配置实战。读完本文你将掌握 Twitch 聊天机器人的完整接入方案以及该插件从配置到源码验证的全链路细节。一、版本演进与 OpenClaw 核心版本号严格对齐twitch/CHANGELOG.md记录了插件自初始发布以来的全部版本。其中2026.1.23是初始版本包含完整的功能与改进清单此后的 16 个版本2026.2.22 ~ 2026.3.14含2026.3.8-beta.1统一标注为同一项变更Version alignment with core OpenClaw release numbers版本号与核心 OpenClaw 发布号对齐这意味着 Twitch 插件发布后不再独立迭代功能而是跟随 OpenClaw 核心的发布节奏保持版本号一致以便在插件安装时进行宿主版本兼容性校验。这一机制在 twitch/package.json 中有直接印证{ name: openclaw/twitch, version: 2026.3.28, openclaw: { extensions: [./index.ts], install: { minHostVersion: 2026.3.28 } } }version字段使用与核心 OpenClaw 相同的日期式版本号2026.3.28install.minHostVersion: 2026.3.28声明插件要求宿主 OpenClaw 不低于该版本从安装环节即保证版本对齐。版本时间线一览版本号变更摘要2026.3.14 / 2026.3.13 / 2026.3.12 / 2026.3.11 / 2026.3.10版本号与核心 OpenClaw 对齐2026.3.9 / 2026.3.8-beta.1 / 2026.3.8 / 2026.3.7版本号与核心 OpenClaw 对齐2026.3.3 / 2026.3.2 / 2026.3.1版本号与核心 OpenClaw 对齐2026.2.26 / 2026.2.25 / 2026.2.24 / 2026.2.22版本号与核心 OpenClaw 对齐2026.1.23初始发布完整功能与改进清单见下文二、初始发布功能全景2026.1.23CHANGELOG 中2026.1.23条目列出 9 项 Features 与 3 项 Improvements构成了插件的能力骨架。以下逐项展开并结合源码给出实现证据。1. 基于 twurple 的 Twitch 聊天集成IRC 连接Twitch chat integration via twurple (IRC connection)插件依赖twurple/api、twurple/auth、twurple/chat三个 Twitch 官方生态库见 twitch/package.json通过 IRC 协议连接 Twitch 聊天服务器。核心连接管理实现在 twitch/src/twitch-client.ts 的TwitchClientManager类中每个账号持有一个ChatClient按username:channel生成唯一键缓存于Map中getAccountKey客户端初始化参数包括rejoinChannelsOnReconnect: true断线重连后自动重新加入频道与requestMembershipEvents: true请求成员事件Twurple 日志经custom.log适配器统一转发到 OpenClaw 的频道日志通道ChannelLogSink按CRITICAL/ERROR/WARNING/INFO/DEBUG/TRACE分级映射入站消息在onMessage回调中组装为TwitchChatMessage携带用户名、显示名、用户 ID、消息文本、频道、消息 ID、时间戳以及isMod/isOwner/isVip/isSub等角色标志字段定义见 twitch/src/types.ts供后续访问控制与回复流水线使用。2. 多账号支持与每频道独立配置Multi-account support with per-channel configuration配置解析层twitch/src/config.ts同时支持两种模式简化单账号模式username、accessToken、clientId、channel直接写在channels.twitch顶层隐式构成default账号多账号模式通过channels.twitch.accounts对象按账号 ID 分别配置每个账号可指定各自的用户名、Token、Client ID 与目标频道。关键合并逻辑源码注释明示For default account, base-level properties take precedence over accounts.default对 default 账号顶层属性优先于accounts.default即顶层配置与accounts.default同时存在时以顶层为准合并非 default 账号则只读取accounts对象。listAccountIds还会把存在顶层配置的隐式default账号与显式账号合并列出借助 plugin-sdk 的listCombinedAccountIds。3. 访问控制用户 ID 白名单与角色限制Access control via user ID allowlists and role-based restrictions访问控制是聊天机器人的安全底线实现在 twitch/src/access-control.ts 的checkTwitchAccessControl中按以下优先级判定requireMention默认true消息必须通过bot用户名提及机器人否则直接拒绝。提及提取由extractMentions用正则(\w)完成并统一转小写比对allowFrom硬性白名单若配置了该字段发送者必须命中白名单内的 Twitch用户 ID非用户名因为用户名可变而 ID 持久唯一。白名单为空数组时一律拒绝allowedRoles角色限制仅在未配置allowFrom时生效支持moderator、owner、vip、subscriber、all五种角色TwitchRole枚举定义于 twitch/src/types.ts。all表示放行所有人否则按消息携带的isMod/isOwner/isVip/isSub标志逐项匹配三者均未命中限制时默认放行。TwitchRoleSchema在 twitch/src/config-schema.ts 中通过 Zodz.enum定义配置阶段即校验合法角色值。4. 基于 RefreshingAuthProvider 的自动 Token 刷新Automatic token refresh with RefreshingAuthProviderToken 生命周期管理在 twitch/src/twitch-client.ts 的createAuthProvider中实现按是否提供clientSecret二选一提供clientSecret使用twurple/auth的RefreshingAuthProvider通过addUserForToken注入accessToken、refreshToken、expiresIn、obtainmentTimestamp并注册onRefresh记录刷新成功与新的有效期与onRefreshFailure记录刷新失败回调。若同时提供了refreshToken则启用自动刷新否则提示 token refresh disabled (no refresh token)未提供clientSecret退化为StaticAuthProviderToken 到期后需要手动更新配置。对应地twitch/src/types.ts 的TwitchAccountConfig定义了clientSecret、refreshToken、expiresIn、obtainmentTimestamp四个可选字段用于承载刷新所需的完整凭据信息。5. 环境变量回退OPENCLAW_TWITCH_ACCESS_TOKENEnvironment variable fallback for default account tokentwitch/src/token.ts 实现了 Token 解析优先级配置中的账号accessTokendefault 账号优先取顶层配置其次accounts.default环境变量OPENCLAW_TWITCH_ACCESS_TOKEN仅对 default 账号生效两者皆无时返回source: none与空 Token。同时normalizeTwitchToken会自动补全oauth:前缀——写入的 Token 若无此前缀解析层会统一加上保证与 Twurple 的兼容。6. 消息动作支持Agent 主动发消息Message actions supporttwitch/src/actions.ts 实现了ChannelMessageActionAdapter向 Agent 暴露send动作describeMessageTool返回支持的[send]动作列表extractToolSend从工具参数中解析必填的to目标频道与message消息内容handleAction执行发送未指定to时回落到账号配置的默认频道最终经由twitchOutbound.sendText完成投递并以 JSON 形式返回结果或错误详情。7. 状态监控与探测Status monitoring and probing状态体系由三部分协同构成探测Probetwitch/src/probe.ts 的probeTwitch使用StaticAuthProvider新建一个临时ChatClient通过onConnect、onDisconnect、onAuthenticationFailure三事件与超时timeoutMs竞速验证 Token 能否真实连上聊天服务器并返回connected状态、耗时等信息状态问题收集Status Issuestwitch/src/status.ts 的collectTwitchStatusIssues逐账号检查未配置、已禁用、缺clientId、allowFrom为空数组、allowedRoles: all与allowFrom冲突、clientSecret缺少refreshToken、运行时错误、长期未连接、连接超过 7 天建议重启等 10 类问题并附带修复建议fix字段插件接线twitch/src/plugin.ts 通过createComputedAccountStatusAdapter将探测与问题收集接入 OpenClaw 的渠道状态汇总startAccount/stopAccount管理连接生命周期。8. 出站消息投递与 Markdown 剥离Outbound message delivery with markdown strippingTwitch 聊天不支持 Markdown 且单条消息上限500 字符插件在出站链路twitch/src/outbound.ts、twitch/src/send.ts中做了两层处理Markdown 剥离twitch/src/utils/markdown.ts 的stripMarkdownForTwitch依次去除图片、链接保留链接文字、粗体、斜体、删除线、代码块、行内代码、标题与列表标记最后将换行统一替换为空格并压缩连续空白适配单行聊天场景词边界分块chunkTextForTwitch对超长文本按 500 字符上限分块优先在单词边界最后一个空格处切割避免生硬截断。twitchOutbound声明textChunkLimit: 500、deliveryMode: direct即时投递并支持sendMedia——Twitch 聊天不支持直接上传媒体因此将媒体 URL 拼入文本后按普通消息发送。发送前还会做账号配置校验isAccountConfigured要求username、accessToken、clientId三者齐备见 twitch/src/utils/twitch.ts并生成本地消息 IDTwurple 的say()不返回 ID见 twitch/src/send.ts。三、工程化改进校验、描述符与文档CHANGELOG 在 Improvements 中列出的三项对应插件的工程质量保障Zod 配置校验twitch/src/config-schema.ts 使用z.union([SimplifiedSchema, MultiAccountSchema])对两种配置模式做互斥判别——单账号模式要求顶层字段齐备多账号模式要求accounts至少含一个条目.refine(...)校验channel字段强制min(1)。插件侧通过buildChannelConfigSchema(TwitchConfigSchema)见 twitch/src/plugin.ts接入 OpenClaw 核心的配置校验体系插件描述符twitch/openclaw.plugin.json 声明id: twitch、关联频道[twitch]与空配置模式配合 twitch/package.json 的openclaw元数据channel.id、channel.label: Twitch (Chat)、aliases: [twitch-chat]使插件能被 OpenClaw 插件市场识别、安装并出现在频道选择列表文档twitch/README.md 提供了安装、最小配置、访问控制选项与多账号配置的完整说明是本文第四、五节实战内容的主要依据。四、安装与配置实战安装插件本地仓库安装openclaw plugins install ./extensions/twitchnpm 安装openclaw plugins install openclaw/twitch也可在 OpenClaw 引导流程Onboarding中选择Twitch并确认安装提示由系统自动拉取插件。获取凭据为机器人创建一个专用 Twitch 账号使用 Twitch Token Generator 生成Bot Token确认勾选chat:read与chat:write两个 scope将生成的Access Token填入accessToken字段可带oauth:前缀解析层会自动规范化将Client ID填入clientId字段启动网关gateway使配置生效。最小配置简化单账号{ channels: { twitch: { enabled: true, username: openclaw, accessToken: oauth:abc123..., // OAuth Access Token可省略 oauth: 前缀 clientId: xyz789..., // Token Generator 提供的 Client ID channel: vevisk, // 要加入的频道必填 allowFrom: [123456789], // 推荐你的 Twitch 用户 ID }, }, }⚠️ 重要requireMention默认为true。请务必配置访问控制allowFrom或allowedRoles防止未授权用户触发机器人响应。访问控制选项配置项说明requireMention: false关闭默认的 提及 要求机器人将响应所有消息请配合访问控制使用allowFrom: [your_user_id]仅允许指定 Twitch 用户 ID 与机器人交互优先使用用户 ID 而非用户名因为 ID 持久不变allowedRoles: [moderator, vip, subscriber]仅允许拥有指定角色的用户交互可用角色为moderator、owner、vip、subscriber、all多账号配置进阶{ channels: { twitch: { enabled: true, accounts: { default: { username: openclaw, accessToken: oauth:abc123..., clientId: xyz789..., channel: vevisk, }, channel2: { username: openclaw, accessToken: oauth:def456..., clientId: uvw012..., channel: secondchannel, }, }, }, }, }Token 解析优先级源码级结合 twitch/src/token.ts实际生效的 Token 按以下顺序确定default 账号顶层accessToken→accounts.default.accessToken配置来源source: config非 default 账号仅读取accounts.{accountId}.accessToken以上皆无且为目标为 default 账号时回退到环境变量OPENCLAW_TWITCH_ACCESS_TOKENsource: env仍无则返回source: none并判定账号未配置。任何来源的 Token 都会经过normalizeTwitchToken补全oauth:前缀而在真正发给 Twurple 时又会被normalizeTokentwitch/src/utils/twitch.ts剥离该前缀两层规范化确保配置写法宽松、内部处理一致。五、入站消息处理流水线源码级消息从 Twitch 聊天到达 Agent 的完整链路在 twitch/src/monitor.ts 的monitorTwitchProvider中实现建立连接通过clientManager.getClient获取或创建聊天客户端失败则抛出连接错误过滤自消息消息发送者用户名与机器人用户名相同时直接忽略访问控制调用checkTwitchAccessControl执行「提及 → allowFrom → allowedRoles」三级判定未通过则丢弃路由解析resolveAgentRoute将消息路由到对应 AgentTwitch 聊天统一按kind: group对待peer.id为频道名上下文构建formatAgentEnvelope与finalizeInboundContext组装面向 Agent 的入站上下文关键字段如From: twitch:user:{userId}、To: twitch:channel:{channel}、Provider/Surface: twitch、ChatType: group、ConversationLabel: {channel}会话记录recordInboundSession将入站上下文写入会话存储回复分发dispatchReplyWithBufferedBlockDispatcher以 fire-and-forget 方式异步处理消息不阻塞聊天接收回复经deliverTwitchReply剥离 Markdown 后通过client.say()发送。六、补充机制与测试保障目标解析Helix APItwitch/src/resolver.ts 通过twurple/api的ApiClient调用 Twitch Helix API将用户名或用户 ID 解析为结构化结果纯数字输入按getUserById查询其余按getUserByName查询输出{ input, resolved, id, name }并附带 display name 差异提示供会话绑定与目标寻址使用。配对与会话twitch/src/plugin.ts 通过createChatChannelPlugin组装插件并接入 OpenClaw plugin-sdk 的配对机制normalizeAllowEntry用正则/^(twitch:)?user:?/i剥离白名单条目前缀notifyApproval在配对获批时输出通知日志。测试保障插件目录内置了覆盖各模块的测试用例如 twitch/src/access-control.test.ts、twitch/src/config.test.ts、twitch/src/token.test.ts、twitch/src/send.test.ts、twitch/src/outbound.test.ts、twitch/src/probe.test.ts、twitch/src/status.test.ts、twitch/src/plugin.test.ts对访问控制判定、Token 解析优先级、消息分块、探测超时等关键逻辑均有自动化验证send与outbound模块还通过依赖注入deps参数实现可测试性见 twitch/src/send.ts。七、小结从 twitch/CHANGELOG.md 的版本脉络可以看出openclaw/twitch在 2026.1.23 初始发布时即具备了完整的聊天集成、多账号、访问控制、Token 自动刷新、状态监控与出站投递能力随后进入与核心 OpenClaw 版本号对齐的稳定维护期。源码层面twitch/src 目录为每一项能力都提供了清晰、可测试的实现twurple负责协议层连接RefreshingAuthProvider保障 Token 生命周期Zod schema 从配置入口拦截错误monitor串联消息处理流水线而 500 字符分块与 Markdown 剥离则确保回复在 Twitch 聊天场景下始终可读、可投递。开发者按 README 的最小配置即可在数分钟内接入自己的直播间再按需叠加多账号、角色白名单与 Token 刷新能力即可获得一个生产可用的 Twitch 聊天助手。赞分享人工智能大模型LLM 网关AI Agent即时通讯【免费下载链接】openclaw-zero-tokenOpenClaw: Use All Major AI Models NO API Token! Claude/ChatGPT/Gemini/DeepSeek/Doubao/Grok/Qwen/Manus/Kimi项目地址https://gitcode.com/gh_mirrors/op/openclaw-zero-token点击查看免费下载相关推荐farmfe/js-plugin-postcss 插件全解析从版本演进到源码实现与实战配置farmfe/js plugin postcss 插件全解析从版本演进到源码实现与实战配置 导读 farmfe/js plugin postcss 是 F前端构建构建工具开发工具CloudQuery ClickHouse Destination 插件全解析从 CHANGELOG 看版本演进、配置实战与源码级迁移机制CloudQuery ClickHouse Destination 插件全解析从 CHANGELOG 看版本演进、配置实战与源码级迁移机制 CloudQuer数据集成数据工程CLI插件系统tsParticles Absorbers 插件全解析从 CHANGELOG 演进史到源码实现与配置实战tsParticles Absorbers 插件全解析从 CHANGELOG 演进史到源码实现与配置实战 本篇技术指南以仓库中 plugins/absorbe前端上一篇Kepler.gl 深入指南使用 Updaters 在根 Reducer 中直接驱动地图状态下一篇游戏只有 DLSS 又不是 N 卡OptiScaler 免费上采样替换指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考