𝗖𝗼𝗱𝗶𝗻𝗴 𝗔𝗴𝗲𝗻𝘁𝘀 𝗼𝘃𝗲𝗿 𝗧𝗲𝗹𝗲𝗴𝗿𝗮𝗺: 𝗙𝗿𝗼𝗺 𝗭𝗲𝗿𝗼 𝘁𝗼 𝗔𝗻 𝗔𝗴𝗲𝗻𝘁 𝗧𝗵𝗮𝘁 𝗔𝗻𝘀𝘄𝗲𝗿𝘀

𝗖𝗼𝗱𝗶𝗻𝗴 𝗔𝗴𝗲𝗻𝘁𝘀 𝗼𝘃𝗲𝗿 𝗧𝗲𝗹𝗲𝗴𝗿𝗮𝗺: 𝗙𝗿𝗼𝗺 𝗭𝗲𝗿𝗼 𝘁𝗼 𝗔𝗻 𝗔𝗴𝗲𝗻𝘁 𝗧𝗵𝗮𝘁 𝗔𝗻𝘀𝘄𝗲𝗿𝘀

Припиніть читати й почніть діяти.

До кінця цього посібника ви матимете тему в Telegram, де кодинг-агент відповідатиме на ваші повідомлення. Цей агент керуватиме панеллю tmux на вашій власній машині.

Це основна мета. Вам поки що не потрібні пам'ять, монітори чи сервери інструментів. Вам потрібно лише змусити агента відповідати вам.

⏱️ Необхідний час: 30–45 хвилин.

🛠️ Попередні вимоги

Перш ніж почати, переконайтеся, що у вас підготовлено наступне:

• Машина з tmux та доступом до shell.
• Працюючий кодинг-агент (наприклад, OpenCode або Claude Code), який уже запущений у панелі tmux.
• Точна ціль tmux для вашого агента (приклад: mybox:1.1).
• Точна команда для запуску вашого агента.
• Встановлений OpenClaw runtime.
• Акаунт Telegram та додаток Telegram.

📦 Необхідні версії

Не пропускайте цей крок. Неправильні версії призводять до прихованих помилок.

• Node.js: 24.11.1 • Package Manager: pnpm 11.2.2 • OpenClaw: зафіксуйте конкретний коміт.

🚀 Швидкий шлях налаштування

Ви можете використовувати ці скрипти для локального налаштування:

1. Завантажте скрипти: curl -fsSL "https://gist.githubusercontent.com/jerilkuriakose/cd0f8353aac74e47c591111b758943e9/raw/setup-openclaw.sh" -o setup-openclaw.sh curl -fsSL "https://gist.githubusercontent.com/jerilkuriakose/7cf94af3e96526f9f14d0c28b6c26b69/raw/ready-check.sh" -o ready-check.sh chmod +x setup-openclaw.sh ready-check.sh

2. Запустіть налаштування з вашим токеном бота: OPENCLAW_BOT_TOKEN="<YOUR_TOKEN>" OPENCLAW_BOT_ACCOUNT="my-bot" ./setup-openclaw.sh

3. Перевірте налаштування: AGENT_ID=my-agent PANE=mybox:1.1 ./ready-check.sh

📱 Налаштування Telegram

Виконайте ці кроки у додатку Telegram:

• Створіть бота через @BotFather і збережіть токен.
• Створіть нову групу та додайте свого бота.
• Зробіть бота адміністратором. Це дозволить йому бачити ваші повідомлення.
• Увімкніть "Теми" (Topics) у налаштуваннях групи.
• Створіть тему для вашого проєкту.
• Надішліть одне повідомлення в цій темі, щоб згенерувати Topic ID у ваших логах.

⚙️ З'єднання всього докупи

Шлюз використовує JSON-конфігурацію за шляхом ~/.openclaw/openclaw.json.

Використовуйте Фазу 1, щоб знайти свій Chat ID та Topic ID, надіславши повідомлення та перевіривши логи шлюзу.

Використовуйте Фазу 2, щоб обмежити доступ у групі. Змініть політику на "allowlist" і додайте лише свій числовий Telegram User ID. Прив'яжіть свій Topic ID до конкретного Agent ID.

📝 Контракт агента

Створіть файл AGENTS.md у робочому просторі вашого агента. Цей файл вказує агенту, як поводитися. Ви повинні визначити:

• Як читати панель (tmux capture-pane).
• Як писати в панель (tmux send-keys).
• Як обробляти специфічні команди, такі як "status", "send" або "restart".

✅ Тест на готовність

Ви завершили роботу лише тоді, коли пройдете ці п'ять перевірок:

1. Бот відповідає у вашій темі Telegram.
2. Ваш промпт потрапляє в панель tmux.
3. Агент для написання коду починає працювати над промптом.
4. Файл логів підтверджує, що агент обробив вашу тему.
5. Група обмежена доступом лише для вашого User ID.

Джерело: https://dev.to/jerilk/coding-agents-over-telegram-part-2-from-zero-to-an-agent-that-answers-2777

Додаткова спільнота для навчання: https://t.me/GyaanSetuAi