把 Claude Code、OpenClaw、Kilo Code、Gemini CLI 变成 24/7 在线的聊天 Bot——跑在飞书、Discord、钉钉上，支持共享记忆、bot 间协作、运行时热切换、浏览器语音通话。

CloseCrab 把全球顶尖的 AI Agent CLI 工具包装成多平台聊天 Bot。它不重新实现 agent 能力——直接驱动 CLI 进程，所以上游生态里的每一个 Skill、Plugin、MCP Server 都能即装即用，零适配成本。

🌍 English readers: see README.en.md for the full English documentation.

4 个 Agent Runtime · 3 个聊天平台 · 33 个内置 Skill · 1 套统一身份和记忆。

每个 runtime 是一个不同的 AI Agent CLI。CloseCrab 让同一个 bot 在它们之间运行时切换——身份 / 记忆 / 团队上下文在切换中全部保留。

切换中自动处理：model 命名空间翻译（claude-opus-4-7 → provider/model:openclaw）· workspace 文件自愈（GEMINI.md / AGENTS.md 缺失自动重写）· memory 索引重建（OpenClaw sqlite 启动扫描）。

延伸阅读：Hybrid Agent Runtimes——4 个 Agent CLI 如何互相吸收对方的能力

每个 bot 都有四层持久化记忆，重启、runtime 切换、迁移机器后不丢：

自动写入：agent 在对话中发现 user / feedback / project / reference 级别的信息时主动落盘——参考 Karpathy LLM Wiki 理念，知识编译而非检索。

多 bot 跨机器协作，分两层通道：

• 协调通道：Leader 在 #team-ops 飞书/Discord 频道用 @mention 派活，Teammate 完成后 @Leader 汇报
• 异步通道：scripts/inbox-send.py 写 Firestore messages 集合，对端 bot 通过 on_snapshot 实时推送（不是轮询）

# Leader 给 teammate 派任务（异步，非阻塞）
python3 scripts/inbox-send.py bunny "在 B200 上跑 Llama 4 benchmark，写到 CC Pages 给我链接"

Team 角色配置存 Firestore bots/{name}.team，build_system_prompt() 根据角色动态注入协调规则，所以 Leader 看到的 system prompt 跟 Teammate 不一样。

两种语音入口：

LiveKit 通话栈（scripts/install-livekit.sh 一键装）：

• livekit-server + livekit-frontend（fork 自 agent-starter-react）+ Caddy 自动 LE 证书 + systemd unit
• 多 bot 共享一台机器一份 LiveKit infra，靠 URL ?bot= 参数路由 + per-bot HMAC key 验签
• STT/TTS 走 Vertex AI 的 Gemini，需要 roles/aiplatform.user

部署详见 docs/voice-deploy-quickstart.md。

每个 skill 是 skills/{name}/SKILL.md 加可选的 scripts/ 和 references/，deploy.sh 自动 symlink 到 ~/.claude/skills/{name}。新建 skill 用 skill-creator 自举。

不依赖具体 worker 的运行时能力，所有 bot 都能调：

# 真并行多个 LLM sub-agent（每个独立推理 + bash + read）
python3 scripts/subagent-parallel.py --inline '{"tasks":[{"label":"A","prompt":"..."}]}'

# 定时提醒 / cron（精度 30s，daemon 自动跑）
python3 scripts/cron-tool.py add --target <bot> --in 10m --message "..."
python3 scripts/cron-tool.py add --target <bot> --cron "0 9 * * MON-FRI" --message "..."
python3 scripts/cron-tool.py list|remove <id>

# 自查 model / cost / token / 历史 turns
python3 scripts/session-status.py <bot> [--days N]

# 图片生成（Gemini 3 Pro Image）
~/CloseCrab/skills/imagen-generator/scripts/imagen-generate.sh "prompt" --aspect 16:9

# 语音生成（Gemini TTS，15 voice + 情绪标签）
~/CloseCrab/skills/tts-generator/scripts/tts-generate.py "[casually] hello"

# 1. 克隆
git clone https://github.com/yangwhale/CloseCrab.git && cd CloseCrab

# 2. 配置 Firestore（只填 project + database，其它走 Firestore）
cp .env.example .env && vim .env

# 3. 一键部署（交互式引导 API keys，会装 Claude Code + Gemini CLI + Skills + Python 依赖）
./deploy.sh

# 4. 创建 bot（默认 channel 推荐飞书）
python3 scripts/config-manage.py create mybot --channel feishu \
    --app-id "cli_xxxxxxx" --app-secret "xxxxxxxxxxxx"

# 5. 启动（run.sh 是带自动重启的 wrapper）
nohup ./run.sh mybot > /tmp/mybot.log 2>&1 &

Pro tip：已经装了 Claude Code？在这个目录跑 claude，然后说"按照 README 帮我部署成飞书 bot"——它会读这份文档帮你搞定全程。

# 已有 bot 增量加 voice infra
./deploy.sh --voice \
    --voice-frontend-domain  live.example.com \
    --voice-signaling-domain livekit.example.com \
    --voice-email            you@example.com

# 给某个 bot 配 voice 凭据（auto-detect 从本机读）
python3 scripts/config-manage.py set-livekit <bot> --auto-detect \
    --frontend-url https://live.example.com --enable

别随便升级。CC 没有 auto-upgrade，所有升级都是手动 claude install <version>。已知 2.1.144+ 存在 900K 上下文 regression，下次升级前必须先按下面流程验证「上下文有没有被卡死在 200K」。

根因（反编译验证）：Math.min(jL() cap, autoCompactWindow) - min(CqH(H), 20000)，144 改了 compact decision function 让 autoCompactWindow 失效。详见 memory 的 cc-version-matters-for-jl.md。

# Step 1: 备份当前 binary（symlink 固化在 2.1.143）
cp -a ~/.local/share/claude/versions/2.1.143 /tmp/claude-2.1.143.backup

# Step 2: 在测试 bot 上装目标版本（不要拿主力 bot 测）
claude install <target-version>

# Step 3: 压力测试 —— 让测试 bot 连续 read 5+ 个大文件 (>50K tokens each)
#         触发 cache_read 增长，观察是否在 200K 卡住

# Step 4: 验收标准（两项都要满足才算 PASS）
#   ✅ peak_cache_read > 250K
#   ✅ 0 个新增 compact 事件（grep ~/.claude/projects/-home-chrisya/*.jsonl）

# Step 5: 失败 → 立即回滚
ln -sfn ~/.local/share/claude/versions/2.1.143/cli.js ~/.local/bin/claude

# Step 6: PASS 才升主力 bot（jarvis/bunny/hulk/tiemu...）

Memory 索引：feedback_cc-upgrade-checklist.md + feedback_cc-version-matters-for-jl.md。

飞书是 CloseCrab 的 一等公民——下面的配置最完整。Discord 和钉钉是基础支持。

飞书是 CloseCrab 主力平台，配套 4 类事件订阅 + 4 类回调 + 完整命令体系。只复制 App ID 和 Secret 是远远不够的，需要额外配置以下内容：

1. 打开 飞书开放平台 → 创建企业自建应用
2. 在 凭证与基础信息 复制 App ID（形如 cli_xxxxxxx）和 App Secret
3. Lark 海外版同样流程，在 Lark Developer 操作

进 事件与回调 → 事件订阅，订阅方式选 长连接（CloseCrab 不需要 webhook URL），添加以下 4 个事件：

⚠️ 常被遗漏的两项：reaction.created_v1 和 bot.menu_v6 默认不订阅，导致用户给 bot 加 👍 没反应、点 bot 菜单没反应。

进 权限管理，申请以下 scope：

进 机器人能力 → 自定义菜单，添加以下 8 个菜单项，event_key 填命令名（带不带 / 都行，bot 会自动规范化）：

用户点菜单 → 飞书发 application.bot.menu_v6 → bot 把 event_key 映射成 /restart 这样的命令执行。

用户给 bot 上一条消息加 emoji，会被合成为一段"用户表态"消息发给 LLM。约束：只对 bot 自己发出的消息 上的 reaction 响应（避免群里别人互相 reaction 触发 bot）。

其他 emoji 默认不映射，由 LLM 自行判断是否响应。

bot 发的交互卡片（如 ExitPlanMode 审批卡、/sessions 切换卡）的按钮 / 下拉菜单点击，通过 card.action.trigger 事件回传。卡片用 _decode_feishu_card_action() 校验：

• 发起人必须是原 chat 的用户（防止群里别人点别人的卡片）
• 卡片必须未过期（默认 1 小时）
• 卡片必须在当前 session 上下文

无需额外订阅，绑定卡片即生效。

创建版本 → 申请发布 → 管理员审批通过后，bot 才能在企业内使用。

python3 scripts/config-manage.py create mybot --channel feishu \
    --app-id "cli_xxxxxxx" --app-secret "xxxxxxxxxxxxx"

# 可选：单聊 + 群聊 + log_chat（专门转发日志的群）
python3 scripts/config-manage.py set-feishu mybot \
    --allowed-open-ids "ou_xxx,ou_yyy" \
    --log-chat-id "oc_zzzz"

每个 bot 可独立配置 @higcp.com 风格的企业邮件，详见 docs/full-reference.md#飞书企业邮箱。

1. 打开 Developer Portal → New App → 改名 → Bot 子页 → 复制 Token
2. 开启 Message Content Intent（必须，否则收不到消息内容）
3. OAuth2 → URL Generator：勾 bot + applications.commands，权限勾 Send Messages Read Message History Connect（语音）Speak（语音）
4. 拿生成的邀请 URL 邀请到 server
5. 配置到 Firestore：

python3 scripts/config-manage.py create mybot --channel discord --token "DISCORD_TOKEN"
python3 scripts/config-manage.py set-discord mybot --allowed-user-ids "123,456"

Discord 自带 7 个 slash command（/status /end /restart /stop /docs /context /sessions），bot 启动时自动注册到 Server。

1. 钉钉开放平台 → 企业内部开发 → 创建应用
2. 复制 Client ID + Client Secret
3. 开启 Stream 模式（CloseCrab 长连接），勾 企业内机器人 权限
4. 配到 Firestore：

python3 scripts/config-manage.py create mybot --channel dingtalk \
    --client-id "dingxxxx" --client-secret "xxxxxxxxxxxx"

钉钉只支持文字消息，不支持语音 / 斜杠命令 / 卡片按钮回调。

任何平台发以下关键词立即中断当前 turn：

停 stop 取消 算了 打住 急刹车 停下 别做了 不要了

中断不是 SIGINT，是通过 worker 自己的协议传过去（Claude socketpair / ACP session/cancel / SSE close），保证 agent 干净退出。

# 本地 bot 管理
scripts/launcher.sh start|stop|restart|status|logs <bot>

# 远程部署（多 bot 调度）
scripts/dispatch-bot.sh deploy|recall|move|check <bot> <host>

# Runtime 切换
scripts/config-manage.py set-worker-type <bot> claude|openclaw|kilo|gemini

# Bot 间消息（Firestore inbox，on_snapshot 实时推送）
scripts/inbox-send.py <target> "<msg>"

# 记忆同步备份（GCS + private repo）
scripts/sync-memory.sh --push|--pull

# 直接发到指定 Discord 频道（异步通知用）
scripts/send-to-discord.sh --channel <id> "<msg>"

See CONTRIBUTING.md for guidelines.

Copyright 2025-2026 Chris Yang (yangwhale). Apache License 2.0 — see LICENSE.