fft Telegram 运维

运维部署社区

作者仓库星标 0
作者仓库 nano-core

解读按原文结构重写，命令、链接、术语均保留；右侧可核对作者原始 SKILL.md

原文结构

Guardrails：Never run destructive git commands unless explicitly requested. Preserve unrelated worktree changes. Main-chat-only enforcement is mandatory for admin/delegation operations.
Enable Telegram：Set host env: TELEGRAMBOTTOKEN=... Optional for secure main claiming:
Main Chat Setup：DM the bot and run /id. Claim main chat: /main <secret> (requires TELEGRAMADMINSECRET)

适用与边界

When to use this skill：Use when setting up or repairing Telegram bot routing in FFTnano. Use when claiming/maintaining main chat and admin command boundaries. Use when verifying Telegram media intake and command policy behavior.
When not to use this skill：Do not use for WhatsApp-only flows. Do not use for non-chat backend setup tasks unrelated to Telegram routing. Do not use to bypass main/admin restrictions for privileged commands.

原文中的明确线索

要点：「Use this skill for Telegram onboarding, operations, and safe admin command handling.」、「- Use when setting up or repairing Telegram bot routing in FFTnano.」、「- Do not use for WhatsApp-only flows.」、「- Never run destructive git commands unless explicitly requested.」、「1. Set host env: - TELEGRAMBOTTOKEN=...」、「1. DM the bot and run /id.」、「- Main chat responds to all messages.」、「- Run /status in Telegram to confirm runtime and channel state.」
文件与命令：TELEGRAMBOTTOKEN=...、TELEGRAMADMINSECRET=...、WHATSAPPENABLED=0 ./scripts/start.sh dev telegram-only、/id、/main <secret>、TELEGRAMADMINSECRET、TELEGRAMMAINCHATID、/help

流狐整理：以上内容来自当前 SKILL.md 的章节与原词；未补写作者没有声明的工具、兼容性或能力。

FFT Telegram Ops

Use this skill for Telegram onboarding, operations, and safe admin command handling.

When to use this skill

Use when setting up or repairing Telegram bot routing in FFT_nano.
Use when claiming/maintaining main chat and admin command boundaries.
Use when verifying Telegram media intake and command policy behavior.

When not to use this skill

Do not use for WhatsApp-only flows.
Do not use for non-chat backend setup tasks unrelated to Telegram routing.
Do not use to bypass main/admin restrictions for privileged commands.

Guardrails

Never run destructive git commands unless explicitly requested.
Preserve unrelated worktree changes.
Main-chat-only enforcement is mandatory for admin/delegation operations.

Enable Telegram

Set host env:
- TELEGRAM_BOT_TOKEN=...
Optional for secure main claiming:
- TELEGRAM_ADMIN_SECRET=...
Recommended Telegram-only dev mode:
- WHATSAPP_ENABLED=0 ./scripts/start.sh dev telegram-only

Main Chat Setup

DM the bot and run /id.
Claim main chat:
- /main <secret> (requires TELEGRAM_ADMIN_SECRET)
Alternative: set TELEGRAM_MAIN_CHAT_ID and restart.

Command Policy

Available everywhere:

/help
/status
/id

Main/admin chat only:

/main <secret>
/tasks
/task_pause <id>
/task_resume <id>
/task_cancel <id>
/groups
/reload
/panel
/coder <task>
/coder-plan <task>

Messaging Behavior

Main chat responds to all messages.
Non-main chats require trigger prefix @<ASSISTANT_NAME> (default @FarmFriend).
Coder delegation is rejected in non-main chats.
/delivery [stream|append|off|draft] controls Telegram text preview behavior for the current chat. It is not cron delivery.
/text_delivery is an alias for /delivery.
stream is the default durable preview message/edit mode.
append sends durable in-flight update blocks that remain in chat; the final answer is sent separately.
off disables preview streaming and sends only the final answer.
draft uses Telegram native sendMessageDraft for ephemeral in-flight previews; the final answer is still sent as a normal durable message.

Media Intake

Telegram uploads are persisted under:
- groups/<group>/inbox/telegram/
Agent sees uploaded files as:
- /workspace/group/inbox/telegram/...
Size limit controlled by TELEGRAM_MEDIA_MAX_MB.

Operational Checks

Run /status in Telegram to confirm runtime and channel state.
Use /panel in main chat for task/group/coder quick actions.
If polling conflicts occur, stop duplicate FFT_nano instances.

流狐档案作者与许可取自来源；运行、权限和网络为流狐检测或估算

流狐分类: 运维部署
作者声明 Agent: 未找到明确声明；不据此推断已兼容或已测试
静态检查: 88 / 100 · 启发式扫描，不代表运行安全
作者 / 版本 / 许可: @0-CYBERDYNE-SYSTEMS-0 · 未声明 license
流狐 Token 估算: 低消耗
流狐接入估算: 即装即用
是否需要外部 API Key: 未发现要求
检测到的系统要求: 未声明
底层运行要求: 未声明
检测到的文件与系统行为: 只读
允许写入 / 修改
检测到的网络行为: 仅限本地
安装命令数: 无（仅作为资料）

档案由构建时根据 SKILL.md 与安装命令自动衍生，可能与作者实际意图存在差异。

需要注意： 未限定 allowed-tools，默认拥有全部工具权限。

输出预览 fft-telegram-ops.preview

作者没有在当前 SKILL.md 中定义固定输出样例。

SKILL.md SKILL.md

# FFT Telegram Ops

Use this skill for Telegram onboarding, operations, and safe admin command handling.

## When to use this skill

- Use when setting up or repairing Telegram bot routing in FFT_nano.
- Use when claiming/maintaining main chat and admin command boundaries.
- Use when verifying Telegram media intake and command policy behavior.

## When not to use this skill

- Do not use for WhatsApp-only flows.
- Do not use for non-chat backend setup tasks unrelated to Telegram routing.
- Do not use to bypass main/admin restrictions for privileged commands.

## Guardrails

- Never run destructive git commands unless explicitly requested.
- Preserve unrelated worktree changes.
- Main-chat-only enforcement is mandatory for admin/delegation operations.

## Enable Telegram

1. Set host env:
   - `TELEGRAM_BOT_TOKEN=...`
2. Optional for secure main claiming:
   - `TELEGRAM_ADMIN_SECRET=...`
3. Recommended Telegram-only dev mode:
   - `WHATSAPP_ENABLED=0 ./scripts/start.sh dev telegram-only`

## Main Chat Setup

1. DM the bot and run `/id`.
2. Claim main chat:
   - `/main <secret>` (requires `TELEGRAM_ADMIN_SECRET`)
3. Alternative: set `TELEGRAM_MAIN_CHAT_ID` and restart.

## Command Policy

Available everywhere:

- `/help`
- `/status`
- `/id`

Main/admin chat only:

- `/main <secret>`
- `/tasks`
- `/task_pause <id>`
- `/task_resume <id>`
- `/task_cancel <id>`
- `/groups`
- `/reload`
- `/panel`
- `/coder <task>`
- `/coder-plan <task>`

## Messaging Behavior

- Main chat responds to all messages.
- Non-main chats require trigger prefix `@<ASSISTANT_NAME>` (default `@FarmFriend`).
- Coder delegation is rejected in non-main chats.
- `/delivery [stream|append|off|draft]` controls Telegram text preview behavior for the current chat. It is not cron delivery.

…

证据边界与执行链路

作者原文负责流程事实；流狐只索引当前章节、要点、文件与命令。

章节    -> When to use this skill → When not to use this skill → Guardrails → Enable Telegram → Main Chat Setup → Command Policy
要点    -> Use this skill for Telegram onboarding, operations, and safe admin command handling. · - Use when setting up or repairing Telegram bot routing in FFTnano. · - Do not use for WhatsApp-only flows. · - Never run destructive git commands unless explicitly requested. · 1. Set host env: - TELEGRAMBOTTOKEN=... · 1. DM the bot and run /id. · - Main chat responds to all messages. · - Run /status in Telegram to confirm runtime and channel state.
文件/命令 -> TELEGRAMBOTTOKEN=... · TELEGRAMADMINSECRET=... · WHATSAPPENABLED=0 ./scripts/start.sh dev telegram-only · /id · /main <secret> · TELEGRAMADMINSECRET · TELEGRAMMAINCHATID · /help
内容 SHA-256 -> 171b77425b96