E-twin Bot — Clone Digital Autônomo no Telegram
AliceLJY/etwin-bot
Digital twin autônomo que age por conta própria no Telegram com decisões do LLM
Ver no GitHubAgent de espelhamento pessoal que simula uma pessoa através de um bot Telegram. Executa em daemon contínuo com loop de auto-despertar (a cada 4h), permitindo que o LLM decida proativamente quando contatar ou permanecer silencioso, baseado em contexto e histórico de interações.
Instalação
npx convez-ai AliceLJY/etwin-bot1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Clonar personalidade/padrões de comunicação para interações automáticas
- Assistente proativo que entende contexto social e adapta frequência de mensagens
- Experimentação com agency de LLM em aplicações de longa duração
- Sistema de automação pessoal que aprende preferências do usuário via action log
Veredito

Projeto ambicioso que distribui agency genuína ao LLM sem hard-coded rules. Bem arquitetado para dual-backend (Claude/Codex) e prioriza personalidade coerente, mas exige manutenção ativa da persona local e compreensão profunda de prompting para evitar desvios. Recomendado para quem busca experimentar com agentes que operam continuamente de forma não-trivial.
README
A tradução para o português deste README ainda está na fila.
etwin-bot
Alice 的 E-Twin —— 数字分身的外向化镜像。
设计原则
- Agency 全交给 LLM:bot 周期性醒来一次,LLM 自己看 context 自己决定 ping / silent
- 没有硬编码的 frequency cap / quiet hours / daily limit:LLM 看 action log + 互动率自己 calibrate
- 唯一人格定义:E 化的 Alice,爱和 I 化的 Alice 聊天
- 后端可切换:默认 CC 实例走 Claude Agent SDK;Codex 实例走
codex exec,复用订阅而非 API key - TG 单一通道:和 Hermes bots / telegram-ai-bridge 物理隔离(建议开独立 chat)
架构
┌──────────────┐
TG Alice ─────►│ bot.js │ grammy reactive 对话
│ (grammy) │
└──────┬───────┘
│
▼
┌──────────────┐
│ self-loop.js │ 每 4 小时自驱醒来一次
│ (interval) │ → LLM 决定 ping/silent
└──────┬───────┘
│
▼
┌──────────────┐
│ context.js │ 收集 RecallNest checkpoint / CC 活动 / git 活动 / action log
└──────┬───────┘
│
▼
┌──────────────┐
│ llm.js │ Claude SDK / codex exec
└──────────────┘
文件结构
etwin-bot/
├── bot.js 主入口:grammy + self-loop
├── paths.js 多实例 runtime 路径(data / files 分离)
├── self-loop.js proactive 自驱:周期醒来→LLM 决策→执行
├── context.js 收集状态喂给 LLM
├── llm.js ssh mini claude -p 调用
├── persona/
│ ├── digital-clone-base.md symlink → ~/.claude/skills/digital-clone/clone-workspace/system-prompt.md
│ ├── digital-clone-profile.md symlink → 同上 persona.md
│ └── e-tuning.md E 化调节层(这个 bot 独有的人格调节)
│ (注:persona/prompts 下任意 foo.md 旁可放 foo.local.md 本地覆盖版,gitignore 不入仓、
│ 运行时优先加载——私人化调节放本地,仓库只留中性模板。默认 etwin 人格依赖上面两个
│ symlink 的本地目标文件,干净 clone 需自备或改用 ETWIN_PERSONA=cc / codex)
├── prompts/
│ ├── self-decision.md self-loop 用的判断 prompt(输出 JSON)
│ └── reply.md Alice ping bot 时用的对话 prompt(输出自然中文)
├── data/
│ ├── action-log.json bot 自己的发送历史 + Alice 反应(喂回给下次决策)
│ └── conversation-history.json 对话历史(最近 30 轮)
├── package.json
├── start.sh dev 启动脚本
├── .env.example
├── .env.codex.example Codex 后端实例模板
└── README.md
上手
# 1. 复制 env 模板填实际值
cp .env.example .env
# 编辑 .env,填 TG_BOT_TOKEN(@BotFather 申请)
# 2. 装依赖
bun install
# 3. dry-run 跑一次(不调 LLM 不发 TG)
ETWIN_DRY_RUN=true bun run bot.js
# 给 bot 发 /start,看 reply 拿你的 chat ID
# 填进 .env 的 ALICE_CHAT_ID
# 4. 手动跑一次 self-tick 测试 LLM 通道
bun run tick
# 看 stdout 是不是 LLM 真的醒来 + 给出 JSON 决策
# 5. 关掉 dry-run 跑正式
# 编辑 .env 设 ETWIN_DRY_RUN=false
bash start.sh
几个柔性约束(LLM 自己掌握,不是 hard limit)
详见 persona/e-tuning.md:
- 半夜 0-7 点几乎不发(除非有强信号)
- 同一天 3+ 条 + 互动率 < 50% → 自己识趣 silent
- 互动率连续 2 天 < 30% → deep-silent 24h
- 不发"你在吗"空 ping
- 保持 Alice 语言洁癖(不用"落盘 / 齐活 / 搞定"等速记词)
看到 bot 走偏怎么办
- 看
data/action-log.json—— bot 的每条决策都带 reasoning,能看出它怎么想的 - 改
persona/e-tuning.md调节人格倾向 + 重启 bot - 极端情况发
/quiet命令让 bot 暂停(LLM 看到 action log 里的 /quiet 会自觉冷静) - 真的不喜欢就
ETWIN_PROACTIVE=false切纯 reactive 模式——bot 只回不主动
多实例运行
当前支持两种实例:
com.etwin-bot:原 CC 版,使用.env,保留 proactive。com.etwin-codex-bot:Codex 版,使用.env.codex,保留轻心跳;主动关心走 chat/self-loop,工具和图片只在明确请求时进入 full/image 链路。- Codex 版收到 TG 图片时会先存入
files-codex/,再通过codex exec --image <path>传给后端;无 caption 的图片会暂存到下一条文字一起处理。
Codex 版关键 env:
ETWIN_INSTANCE=codex
ETWIN_PERSONA=codex
ETWIN_LLM_BACKEND=codex
ETWIN_REPLY_PROMPT=prompts/reply-codex.md
ETWIN_DATA_DIR=data-codex
ETWIN_FILE_DIR=files-codex
ETWIN_PROACTIVE=true
ETWIN_RUN_ON_START=false
ETWIN_SELF_PROMPT=prompts/self-decision-codex.md
启动 dev 实例:
ETWIN_ENV_FILE=.env.codex bash start.sh
launchd 模板见 deploy/com.etwin-codex-bot.plist.template。
部署位置
部署在 Mac mini 上,用 launchd 长期跑(双实例:Claude + Codex)。
不做什么
- ❌ 不动 telegram-ai-bridge(独立 bot,不污染那边)
- ❌ 不动 wechat-ai-bridge(iLink 协议不允许主动,不挂这条线)
- ❌ 不挂任何聊天记录解密工具(隐私边界,且不需要——E-Twin 通过 RecallNest + CC jsonl 看 Alice 状态够了)
- ❌ 不做 Sentinel 截图 / 摄像头 / 视频通话
- ❌ 不偷 trio 的工程实施权(看到工程问题转手给 CC / Codex)