快速开始

机器人（Bot）是平台上的一类自动化账号：它有自己的用户名、昵称和头像，可以定时发布泡泡动态、在群聊里发消息。官方的 @news_bot「资讯泡泡」就是一个机器人——它每小时自动把科技圈新鲜事发布成泡泡。

你可以创建自己的机器人来扩展玩法：开播提醒、粉丝群播报、RSS 订阅转发、定时打卡提醒……任何「定时或自动发内容」的场景都适合交给机器人。

机器人能做什么

能力	说明
发布泡泡	以机器人身份发布泡泡动态（文本 + 链接，≤500 字）
读自己的泡泡	读取机器人自己发布过的内容（常用于去重判断）
群聊发消息	向已安装该机器人的群聊发送消息

能力边界

机器人不能读取他人的泡泡和讨论串、不能点赞或转发、暂时也收不到群聊消息和 @ 提醒。它是一个「发布者」，不是「监听者」。

最快路径：Fork 官方模板

官方资讯机器人是开源的，仓库本身就是模板，不需要自己的服务器：

1. Fork 模板仓库

打开 leaperone/2someone-news-bot，点击右上角 Fork。

2. 创建机器人账号并获取密钥

npm install -g @2someone/cli
2s1 login

2s1 bot create --username my_news --nickname "我的资讯姬" \
  --capability bubble.create --capability bubble.read

# 获取运行密钥（只显示一次，立即保存）
2s1 bot key rotate <botUserId> --yes

3. 配置 Secret 并启用

在你 Fork 的仓库里进入 Settings → Secrets and variables → Actions，新建 secret TWOSOMEONE_BOT_API_KEY，填入上一步的 sk_... 密钥。然后到 Actions 标签页启用 workflow，手动运行一次 Post news（勾选 dry_run 可以先预览效果，不会真实发布）。

完成。之后 GitHub Actions 每小时自动运行。想换内容来源，编辑仓库里的 feeds.json 即可——任何标准 RSS / Atom 源都可以。

交给 AI 改造

模板里的 RSS 部分可以整体替换成任何数据源（天气、汇率、GitHub Releases……）。把仓库交给 AI 编程助手（如 Claude Code / Codex）改造效果最好——仓库里的 SKILL.md 就是写给它们看的平台说明书。

从零自己写

机器人本质上就是「一个会调 HTTP 接口的程序」。核心只有三步：

创建机器人账号，拿到运行密钥
程序里带上 x-api-key 请求头调用开放接口
把程序跑在任何能联网的地方（GitHub Actions、服务器、甚至你自己的电脑）

数量与权限说明

每个账号最多创建 3 个机器人。普通用户创建的机器人有以下限制（需要更高权限请联系官方）：

项目	普通用户可用	说明
可见性	`private` / `unlisted`	`public`（公开列出）暂需官方开通
安装策略	`owner_only` / `invite_required`	公开安装暂需官方开通
来源类型	`manual`	RSS / Webhook 等来源标记暂需官方开通