使用指南

访问 LabstarClaw 官网，点击右上角「免费注册」，填写邮箱和密码完成注册。注册即开通免费版，无需信用卡。

进入 控制台 Portal 的「管控中心」下载，或直接点击下方链接：

Windows：下载 .exe 安装包后双击运行，按向导完成安装。安装完成后桌面自动生成图标，双击即可启动。首次启动会自动下载依赖包（约 42MB，1-3 分钟），请耐心等待。

macOS：下载 .dmg 安装包后双击挂载，将 LabstarClaw.app 拖入 Applications 文件夹，双击即可启动。首次启动会自动安装依赖，约需 2–5 分钟。

安装完成后浏览器自动打开控制台，在右上角点击「登录/注册」输入账号密码。

在 LabstarClaw 客户端 顶部的「📡 房间」输入框中输入你的 B 站直播间房间号（从直播间网址 live.bilibili.com/XXXXXXXX 取最后的数字），点击 ✓ 确认保存。

确认房间号正确后，点击 LabstarClaw 客户端 界面上的「🦞 放虾入池」按钮启动引擎。按钮变为「运行中🟢」即代表 AI 已开始监听弹幕。去直播间发一条弹幕测试一下吧！

系统会向云端提交房间号。如果该房间号已有其他账号占用，会弹出「验证」窗口。

弹窗中会给你一个随机验证码，将该验证码临时加入直播间标题（如「我的直播间 VERIFY_XXXXXX」），然后回到 LabstarClaw 客户端 点击「确认验证」。验证通过后删除标题里的验证码即可，房间号绑定成功。

每个分身卡片里有独立的绑定入口，绑定相互独立不互影响。

打开手机 B 站 APP → 右上角「扫一扫」→ 扫描屏幕上的二维码 → 点击「确认授权」。授权成功后分身卡片会显示该账号的头像和昵称。

在「分身管理」面板，点击右上角的加号按钮。

给分身起一个名字（例如「小鱼干」「大钳子」），从内置人设中选择或自由书写人设说明，这会影响它回复弹幕的语气风格。

在分身卡片内点击「📱 扫码绑定」，用手机 B 站 APP 扫码授权。绑定成功后分身卡片会显示该账号的头像与昵称，即可发弹幕。如果不绑定，该分身仍可触发技能，只是不会主动发弹幕。

在分身的技能栏里，打开你想让它响应的弹幕指令（如#抽签、#决斗、#运势等）。不同分身可以分工，各自负责不同类型的互动。

打开 OBS → 顶部菜单「工具」→「WebSocket 服务器设置」→ 勾选「启用 WebSocket 服务器」→ 记下端口号（默认 4455）和密码。

打开 LabstarClaw 客户端 → 左侧「OBS 设置」→ 填入：

填完后点击「连接测试」，看到绿色「已连接」即可。

在 LabstarClaw 客户端 的 OBS 控制中心「字幕」技能面板里，点击「🚀 创建 OBS 源」按钮。系统会自动在 OBS 里创建名为 labstarClaw_AI字幕 的文字源，无需手动在 OBS 里操作。

默认字幕源名称 labstarClaw_AI字幕 已预填。只有你在 OBS 里手动改过源的名字时，才需要在 LabstarClaw 客户端 OBS 设置里同步修改，保持两边名称一致。

陪伴者需要独立绑定一个 B 站账号。建议专门注册一个小号，不要用主播账号，否则观众会认出来。

进入「陪伴者」面板，点击「✨ 缔结契约」，按提示完成性格设定后扫码授权 B 站小号。成功后陪伴者状态变为在线。

给陪伴者起一个和账号昵称对应的名字，成长阶段由亲密度自动演变：🌱 好奇小白（< 100）→ 🔥 忠实铁粉（100–499）→ 👑 资深老大哥（≥ 500），无需手动设置。

输入游戏名后系统会自动记住，不需要每次重填。填写后弹幕列表里每条弹幕旁会显示一个 📖 按钮。

浮层会实时显示博查 API 从网络检索到的相关游戏资料（角色强度、版本改动、机制说明等），供主播参考回答观众问题。

这个小号将作为群机器人身份发言。建议专门注册，不要用常用号，避免被封号影响主账号。

前往 NapCat GitHub Releases 下载 NapCat.Shell.Windows.Node.zip，解压后双击运行 napcat.bat。

浏览器打开 http://localhost:6099，用 QQ 小号扫码登录。然后进入「网络配置」，开启 WebSocket 服务端，端口保持默认 3001，保存。

默认地址 ws://127.0.0.1:3001 无需修改，直接点连接。连接成功后面板顶部显示绿色「粉丝群小号已接入」。

在「响应群白名单」输入框中填写允许 AI 响应的群号（多个群用英文逗号隔开）。留空则对小号加入的所有群都响应，点「💾 保存设置」。

完全自定义，可从空白剧本开始，也可参考「创建剧本」面板中的说明。

每个节点选择类型（旁白/事件反应/弹幕投票/主播挑战/等待热键），填写台词说明或事件描述，指定发言分身，并可选填 OBS 场景名（触发时自动切换场景）。

在 LabstarClaw 客户端 的「微剧本」面板选择剧本后点击「激活」，之后每次点击「推进」就执行下一个节点，也可以设置自动推进的间隔时间。