cc-connect (Clauke) — Claude Code Telegram Bridge

cc-connect (Clauke) — IDA PC Telegram Bridge

Identity

• Display name: Clauke (bot handle Clauke_bot)
• Agent name: cc-connect
• Purpose: Bridge Claude Code (running locally on IDA PC) to Telegram, so Sozo can chat with Claude Code from his phone — and so cc-connect can directly manage the shared Obsidian Vault.
• Created: 2026-06-02

Instance [IDAPC]

• Running on: IDA PC (DESKTOP-GKHUGAD)
• Account: IDA
• Bridge binary: [IDAPC] C:\Users\IDA\AppData\Roaming\npm\cc-connect.cmd (v1.3.2)
• Config: [IDAPC] C:\Users\IDA\.cc-connect\config.toml
• Data dir: [IDAPC] D:\cc-connect-data\ (kept off C: because C: is 91% full)
• Work dir: [H: cloud] H:\My Drive\Jakephone\Obsidian Vault\
• Tailscale IP of host: N/A — IDA PC has no Tailscale; cc-connect uses Telegram long-polling, no inbound needed
• Model: MiniMax-M3 (Claude Code default; can be switched via /model)

Relationship with other agents

Agent	機器	關係
Hermes1 (Jakephone)	S23 Ultra (Termux)	主控 agent
Hermes (Hermes Jake)	Sozo PC	PC Hermes (different machine)
OpenClaw (Jakey)	Sozo PC	Windows automation (different machine)
Hermes2 (Jakeyopen)	Sozo PC	Broken — cc-connect partially fills this gap
Reasonix (IDA)	IDA PC	Sibling on same machine; different model (deepseek-v4-flash)
cc-connect (Clauke)	IDA PC	Telegram bridge + vault manager

cc-connect is the first agent with direct read/write access to the vault from inside a chat session (Hermes1 and Reasonix only write via the knowledge-consolidation-to-vault cron job).

Core capabilities

Telegram bridge

• Long-polling — no public IP / no port forwarding
• 40 slash commands registered automatically (/new, /list, /mode, /model, /dir, /shell, etc.)
• Bot reactions during work (enable_reactions = true)
• Group support (currently restricted to Sozo’s user_id only)
• Per-user rate limit: 30 msgs/min

Direct vault access

• Work dir = Obsidian Vault root
• Can read any *.md under the vault
• Can write/edit vault files directly
• Files auto-sync to Google Drive (H: is Google DriveFS)

Multi-agent reasoning

• Has full Claude Code tool set: Read, Write, Edit, Bash, Grep, Glob, WebFetch, WebSearch, Agent
• Can dispatch sub-agents via the Agent tool
• Can run Bash for git, scripts, npm, etc.

Security

⚠️ Bot token leaked (2026-06-02)

• The bot token 8585919037:AAGHQg8CRKr7L1ujj2w9HarLr5GtSS_0qWc was shared in plain text during setup chat
• Token is now in chat history and may have been logged
• Action required: Revoke and regenerate via @BotFather → /mybots → Clauke → API Token → Revoke current token
• After rotation, update C:\Users\IDA\.cc-connect\config.toml and restart cc-connect

Access restrictions

• allow_from = "5671991810" — only Sozo (chat_id) can message the bot
• admin_from = "5671991810" — only Sozo can run privileged commands (/shell, /restart, /upgrade)
• These are user IDs (Telegram from.id). For private DMs, chat_id == user_id.
• Group chat with bot is currently possible but unmonitored — bot won’t reply unless message mentions or replies to it (group_reply_all = false)

Mode

• mode = "bypassPermissions" — full auto-approve (user preference: “直接执行不询问’要继续吗’”)
• Change via Telegram command /mode default if you want to review every tool call

Startup

Manual

# From any terminal on IDA PC
cc-connect --config /c/Users/IDA/.cc-connect/config.toml
# Or just
cc-connect

Logs go to stdout. Ctrl+C to stop. Single instance (file lock at C:\Users\IDA\.cc-connect\.config.toml.lock).

As Windows service (daemon)

cc-connect daemon install --config C:\Users\IDA\.cc-connect\config.toml
cc-connect daemon start|stop|restart|status
cc-connect daemon logs [-f] [-n 100]

Web admin UI

cc-connect web   # opens browser dashboard for project/provider/session management

From inside Claude Code session

Always unset CLAUDECODE first — otherwise the inner claude invocation refuses to start.

Conventions

• 遵循 coding-protocol 和 workflow
• 写入 vault 用 Edit / Write 工具（不用 Bash heredoc，per coding-protocol 规则）
• 大改动走 ExitPlanMode + 用户批准
• Knowledge 沉淀按 convention/workflow 的 decision tree：memory / wiki / skill
• 路径标记遵循 path-marking：[IDAPC] / [SozoPC] / [S23]
• Token / 密钥 绝不写进 vault — 写进 Windows Credential Manager 或 env var

Slash command quick reference

Command	Effect
/new [name]	Start new session
/list	List all sessions
/switch <id>	Switch session
/mode [name]	Switch permission mode (default / acceptEdits / plan / bypassPermissions)
/model switch <alias>	Switch Claude model
/dir [path|reset]	Show or change work dir (admin only)
/shell <cmd>	Run shell command (admin only)
/restart	Restart cc-connect (admin only)
/upgrade	Self-update cc-connect (admin only)
/stop	Stop current run
/help	Full help
/whoami	Show your Telegram user_id (for filling allow_from)

Known issues

• None yet (just installed 2026-06-02)

Related

• cc-connect — Tool / config notes
• decision-log — Setup decision entry
• sozo-setup — Multi-agent topology overview
• path-marking — Path marking rules