deepcoldy/botmux：README に基づく導入ガイド

deepcoldy/botmux の README はプロジェクトを「Bridge Feishu/Lark to AI coding CLIs , Claude Code, Codex, Gemini, OpenCode… every DM, group or topic spawns its own live-streaming CLI session」と説明しています。ここではリポジトリで確認できる事実だけを整理します。star 数やバッジは注目度の手掛かりであり、品質の証明ではありません。「botmux」には次の説明があります。Daemon 监听飞书消息，为每个新会话自动 spawn 一个独立的会话进程，把 AI 编程 CLI / Agent 的输出实时流式回传成飞书卡片，并提供可交互的 Web 终端。它不重造 Agent 能力，而是直接桥接你已经在用的工具（20+ CLI / Agent 适配器，见 支持的 CLI / Agent）。。これは範囲の説明であり、本番検証の結果ではありません。

README の「它解决什么」にある内容から、用途が合うかを先に判断できます。CLI 不感知飞书上下文 , 把机器人拉进话题群 / oncall 群，@ 一句就在你本机的代码库里开跑；会话可以用 /relay 原样搬到另一个群，上下文一点不丢。。目的が違うなら、人気だけで採用する理由にはなりません。プロジェクト名やコマンドは原文のまま残し、一次資料へ戻って用語を確認できるようにしています。 README には次の確認可能な項目もあります。Agent 收不到通知、手机控不了 , CLI 跑在开发机上，人在手机上。botmux 把每轮输出推成飞书卡片，随时随地查看 / 追问 / 打断，还能开可写 Web 终端直接操作。。初回テストの材料にはなりますが、実際の環境での確認を省略する理由にはなりません。

動作の説明は「5 分钟接入」など複数の箇所に分かれています。確認できる情報は次の通りです。然后私聊机器人、或 botmux dashboard 拉个群，直接开聊。完整步骤（含 Lark 国际版、--no-open-platform-auto 后手动配置权限 / 发版、排查）见 5 分钟快速接入。。書かれていない構成、性能、セキュリティを推測で補いません。導入時はディレクトリ、設定ファイル、release 履歴を確認してください。

初回導入は README の入口から始めます。確認できるコマンドは次の通りです。 npm install -g botmux # 需要 Node >= 22 botmux setup # 一次扫码建应用 → 选 CLI → 选工作目录（自动配权限 + 发版） botmux start # 启动 daemon（botmux autostart enable 设开机自启） 実行可能なコマンドがない場合は手順を作らず、「它解决什么」で依存関係、待受ポート、初回設定を確認します。

日常運用は公式文書の範囲に限ります。「支持的 CLI / Agent」にはbots.json 里用 cliId 一键切换。20+ 适配器，覆盖本地 CLI（进程隔离，tmux attach 可直连）和 API / 云 Agent（如 Mira、riff,,通过 API / 远端接入，非本地进程）。代表项：とあります。設定、環境変数、権限、データ保存先は明記されたものだけを扱います。未記載の既定値は隔離環境で確認し、戻せる設定を保存してください。 同じ資料には单个 Agent 不够用 , 同一个群里放多个不同 CLI 的机器人，@ 谁谁干活，让 Claude Code 和 Codex 一起 review 同一个 MR、各自独立分析、观点不同自动互怼。ともあります。