在飞书话题里直接发命令即可,由 daemon 拦截处理。只有透传白名单内的命令会原样透传给底层 CLI;其余 daemon 不认识的 /xxx 会被当作普通对话文本按普通消息转发。随时发 /help 查看完整清单。

会话管理

命令说明
/repo仓库待选时用默认 workingDir 启动;会话进行中则弹项目选择卡片
/repo <N>切换到上次扫描的第 N 个项目
/repo <路径|项目名>直接指定路径或 workingDir 下的一级项目名
/cd <路径>切换工作目录并重启 CLI 进程
/status查看会话信息(运行时间、终端地址等)
/restart重启 CLI 进程(保留 session 上下文)
/close关闭会话并发送可恢复卡片(含 CLI 自身 resume 命令)
/fork <任务>继承当前会话完整上下文,在同一话题群新建并行子话题;源会话原样继续(仅 Claude 系 / Codex 终端模式)
/forklist重发当前会话的分身任务面板(运行/结束状态 + 子话题链接)
/fork --create <群名>不建子话题,把当前会话分身到一个新建群
/rename <标题>重命名当前 Botmux 会话,并同步运行中的 Codex/Claude 原生会话名
/card手动召唤当前会话的流式卡片(关流式时也能召唤并恢复实时刷新;私密卡片模式下改发仅授权人可见的静态快照)
/term获取当前会话的「可操作终端」(带写权限)链接,私密发给 owner(群内仅你可见,话题/单聊回退私信)
/dashboard [模块]在飞书里打开 Dashboard 控制卡片(sessions/schedules/groups/settings/help 等)
/insightowner 专用:即时回一张「本会话洞察摘要」卡片(聚合指标 + 规则建议;明细在 Dashboard「洞察」页)
/vc prepare <会议链接或会议号>将当前普通群设为会议准备群,开会后复用同一 Agent 会话
@机器人 /summary读取当前话题(或普通群配置范围内)历史消息生成总结(默认最近 50 条 / 24 小时)。bot 开启 summaryMemory 时总结追加写入记忆文件(summaryMemoryPath,默认 summary.md),且 /summary 后随文字作为「只总结从这条起」的硬边界;未开启记忆时后随文字仅作为本次总结的侧重提示
/t [<内容>] /topic [<内容>]普通群内强制新开话题;带内容提交首轮任务(需选仓则选择后开工),裸命令进入话题设置
/issue打开 Issue Board 看板卡片领取 botmux 平台任务:选好仓库后自动建群、拉你进去、绑定平台任务并开工。需本机已绑定平台,且发起人在该 bot 的 allowedUsers 里;卡片只有发起人能操作
/issue status任务群里发,查该群绑定的平台任务与状态(平台状态/领取人/本机绑定/回写发件箱)。只读
/issue done任务群里发,验收通过,把任务推到平台终态。agent 交付只能到「待验收」,标完成是人的决策;完成后 claim 被平台清掉
/issue release把任务退回平台「待领取」,别人可重新领;群和会话不自动解散,对话记录保留(以上均限该 bot 的 allowedUsers)

裸 /t 的选仓/固定目录分支见 session-model。/repo 也可作为新话题的首条命令:

  • /t /repo <路径|项目名>
  • /t /repo wt <路径|项目名> [分支]

这两种组合直接完成建话题与选仓/创建 worktree,不会先启动空会话再切库;任务在话题内下一条发送。

回复模式(/reply-mode)

控制 bot 被 @ 触发时如何开会话。无参数(或 status)查看当前模式;带参数修改需 canOperate,仅查看需 canTalk。群聊中须 @ 目标 bot 才生效(多 bot 群须 @ 到具体 bot)。仅普通群与 1:1 私聊支持;话题群本就是话题,命令会被拒绝。

私聊(1:1 DM):模式对该 bot 的所有 DM 生效(bot 级全局配置,非 per-chat),但不同用户与该 bot 的 DM 仍各自隔离。只有 chat / topic 两态(new-topic 是 topic 的兼容别名);shared / chat-topic 依赖群内原生话题,不支持。

命令说明
/reply-mode chat每个 1:1 私聊内部扁平连续会话,同一 DM 的消息共用一个会话(默认)
/reply-mode topic每条顶层 DM 开独立会话/线程;同一已有 thread 内的回复继续该 thread 会话

普通群:顶层 @ 的开会话方式(per-chat 覆盖,优先级高于 dashboard 默认值):

命令说明
/reply-mode chat整群连续会话(顶层 @ 都进同一个会话)
/reply-mode chat-topic顶层连续、原生话题各自独立会话
/reply-mode new-topic每次 @ 新建话题与独立会话
/reply-mode topic / /reply-mode shared话题展示但共享同一会话(topic 是 shared 的兼容别名)

群级设置覆盖 Dashboard「Bot 配置 → 普通群模式」默认值。/substitute [status|on|off] 查看/切换当前群的替身模式(修改需 owner)。

透传给底层 CLI

/compact /model /clear /plugin /usage /new /context /cost /mcp /diff /code-review /security-review /review /btw /effort /fast —— 字面送达底层 CLI,交给其内置命令处理。

  • /fast 仅对 Codex 生效:切换 Codex 原生 service tier 档位,流式卡片显示只读 ⚡ <档位> 徽标;在 RPC 输入模式或 Riff 后端上按键到不了 Codex 执行器,会 fail-closed 给出明确提示而非静默失效。
  • Claude Code / Codex 的 adapter 默认另放行 /goal:新话题第一条发 /goal ... 会先启动/选择仓库,再把 /goal ... 原样投给 CLI。
  • 想放行更多命令,给该 bot 配 customPassthroughCommands(如 ["/export"],见 bots-json)。会遮蔽 daemon 命令的项(/status、/help、/cd 等)被自动丢弃——daemon 命令始终保留自身语义,无法被透传覆盖。

查看可用命令

/list-slash-command(别名 /slash):卡片分四段列出当前可用 slash 命令——① botmux 固定放行的透传白名单;② 当前 CLI adapter 默认放行的命令;③ 本 bot 经 customPassthroughCommands 自定义放行的命令;④ 从 .claude 目录(项目级 + ~/.claude + 插件缓存)自动发现的自定义命令 / skill / 插件,以「命令 | 说明」表格展示并提示检测到的 MCP server 名。权限同 /help,不占会话槽位。

会话接入(adopt)

命令说明
/adopt扫描本机 tmux,弹卡片选择要接入的已运行会话
/adopt <tmux_pane>直接接入指定 pane(如 /adopt 0:2.0)
/detach断开本话题与 adopt 会话的桥接(原 CLI 不受影响,/disconnect 同义)

相关:web-terminal、tmux。

用户授权

命令说明
/login飞书用户授权,授权后可下载第三方卡片图片、以你身份调云文档/日历等 API
/login status查看授权状态
/pair <配对码>把 Web/Dashboard 端会话与你的飞书身份配对(网页端拿配对码,话题里发 /pair <码> 认领)

角色(人设)

命令说明
/role查看当前生效的 Role(本群覆盖 > 默认角色 > 无)
/role set <Markdown>设置本群 Role(覆盖默认角色)
/role delete删除本群 Role
/role team set <Markdown>设置默认角色(跨群默认人设,= Dashboard「Bot 配置 → 默认角色」)
/role cap set <一句话> / /role cap clear设置/清除花名册里的能力标签
/role profile list列出本地 role profiles
/role profile show <profile> [--all]查看当前 bot 的 profile entry,或本 daemon 已知的全部本地 entries
/role profile set <profile> <Markdown>设置当前 bot 在 profile 里的 entry
/role profile save <profile>把当前 bot 的生效 Role 保存到 profile
/role profile apply <profile> [--preview] [--force] [--quiet]把当前 bot 的 profile entry 写成本群 Role

详见 roles。

会话接力(普通群)

命令说明
/relay在目标群弹卡片,把你在其它群的活跃会话拉过来继续
@botA @botB /relay --create把当前会话(带协作伙伴)搬到一个新建群

详见 session-handoff。

Oncall / 使用授权 / 远程配置

  • Oncall(群聊):/oncall bind <path> · /oncall unbind · /oncall status,见 oncall。
  • 使用授权(owner 专用):@机器人 /grant @某人 授权对方在本群对话,不带人则授权本群所有成员;/revoke 反之(不带人撤销整群授权)。/vc-auth @成员 在会议监听中临时授权本场指令源(revoke 撤销 / list 查看)。
  • 远程改配置 & 技能(owner 专用):写盘即热更新,无需重启。/botconfig get 查看本机器人运营配置,/botconfig set <字段> <值> 改 model/cli/lang/开关等(/botconfig help 看全部字段);/skills ... 查看/管理本 bot 技能策略(attach/detach 需 owner)。

一键新建会话群

/group <群名>(别名 /g):自动新建飞书群、邀请你进群、转让群主,整个群作为一个独立 CLI 会话。@botA @botB /g <群名> 可把多个机器人一并拉进新群;加 --role-profile <profile> 可在新群自动 bootstrap 一套按 bot 区分的角色(如 @botA @botB /g --role-profile collab-main War Room)。

其它入口

  • 飞书文档评论:/watch-comment 监听飞书文档评论、绑定 AI 会话并把回复发回评论串(支持 <文档链接> [--dir <路径>] [--all|--mentions-only] 与 list/off);/subscribe-lark-doc 保留原有飞书逐文件 API 订阅流程。见 doc-comment。
  • Workflow(实验性):/workflow <目标>(= /workflow new <目标>)发起即兴 workflow;/workflow run <名称> [key=value ...] 运行 Saved Workflow;/workflow save last [名称] / list / show / cancel 保存/列出/查看/取消(v2 资产仅支持离线 migrate-v3 / archive-runs)。旧 /template run|cancel 已退役,现在发 /template 只返回退役提示。见 workflow。
  • 多机器人协作:@botA @botB /t <prompt>(各自开新话题);botmux bots list 查看当前群可协作 bot;@botA @botB /introduce 为旧版/外部 bot 兜底登记(一般不再需要)。见 multi-bot。
  • 定时:/schedule ...,见 schedule。
  • 帮助:/help 在话题内显示完整清单。