使用指南

启动机器人

在配置好 settings.toml 和 acl.toml 后，直接运行程序：

./teamspeakclaw

如果配置正确，您应该会看到类似以下的日志：

INFO Starting TeamSpeakClaw v0.x.x
INFO Bot ready. Listening for TS + NapCat events.

此时，机器人应该已经连接到您的 TeamSpeak 服务器。

命令行选项

• --log-level <LEVEL>: 设置控制台日志级别（error, warn, info, debug, trace），默认为 info。

交互方式

您可以通过以下方式与机器人交互：

1. 频道聊天: 在频道发送消息，带上触发前缀。

   • 默认前缀: !tsclaw, !bot, @TSClaw
   • 例如: !bot 播放周杰伦的夜曲

2. 私聊 (推荐): 双击机器人进行私聊。

   • 私聊通常不需要前缀（取决于 respond_to_private 设置）。
   • 例如: 踢掉那个叫 User123 的人

3. Headless 语音模式（可选）：启用 Headless 服务后，可直接通过语音与机器人交互。

   • 配置 settings.toml 中的 [headless] 区段
   • 说出唤醒词（默认 tsclaw）后说出指令
   • 机器人会通过语音回复（需配置 TTS）
   • 例如: （说）tsclaw 播放周杰伦的夜曲

4. NapCat / QQ（可选）：启用 NapCat 后可通过 QQ 私聊或群聊交互。

可用技能 (Skills)

机器人目前支持以下技能（取决于您的权限配置）：

🎵 音乐控制 (music_control)

TeamSpeakClaw 支持两种音乐后端：

模式一：ts3audiobot（默认）

通过 TS 私信控制 TS3AudioBot。需确保音乐机器人昵称为 TS3AudioBot。

模式二：tsbot_backend

通过 HTTP API 控制 NeteaseTSBot。需在 settings.toml 中配置 backend = "tsbot_backend" 和 base_url。

支持的操作：

动作	说明
play	播放歌曲（搜索关键词）
pause	暂停 / 继续播放
next / skip	切歌
previous	上一首
search	搜索并播放
repeat	循环模式（none/one/all）
volume	调节音量
fx	音效设置
ts_play	TS3AudioBot 专用播放
ts_add	TS3AudioBot 专用添加到队列
ts_gedan / ts_gedanid	TS3AudioBot 歌单操作
ts_playid / ts_addid	TS3AudioBot 按 ID 操作
ts_mode	TS3AudioBot 播放模式
ts_login	TS3AudioBot 登录
queue_netease	tsbot_backend: 网易云歌单入队
queue_qqmusic	tsbot_backend: QQ 音乐歌单入队

🛡️ 管理功能

• 踢出用户 (kick_client): "把 UserA 踢出服务器"
• 封禁用户 (ban_client): "封禁 UserB 10 分钟"
• 移动用户 (move_client): "把 UserA 移动到频道 12"

💬 通讯功能

• 戳一戳 (poke_client): "戳一下 UserA"
• 发送消息 (send_message): "给 UserA 发私信说你好"

send_message 跨平台路由说明

• TeamSpeak 场景：支持 mode=private|channel|server。
• NapCat 场景：默认走 NapCat 原生发送，支持 mode=private|group。
• 若希望从 NapCat 显式转发到 TeamSpeak，请传入 ts_route=true，此时支持 mode=private|channel|server（private 需 clid）。

ℹ️ 信息查询

• 查询在线用户 (get_client_list): "现在谁在线？"
• 查询用户信息 (get_client_info): "UserA 的详细信息"

常见问题

• 机器人没反应？

  • 检查是否使用了正确的前缀。
  • 检查后台日志是否有报错。
  • 确认 LLM API Key 是否正确且有余额。

• 提示"没有权限"？

  • 检查 acl.toml 中的配置，确认您的用户组 ID 是否在允许的规则中。

• 音乐功能不工作？

  • ts3audiobot 模式：确认 TS3AudioBot 是否在线且昵称是否为 TS3AudioBot。
  • tsbot_backend 模式：确认 NeteaseTSBot 后端服务是否运行，base_url 是否正确。