Ajaniti wa Coding kupitia Telegram: Kutoka Sifuri hadi kwenye Ajaniti Anayejibu

Acha kusoma na anza kutenda.

Kufikia mwisho wa mwongozo huu, utakuwa na mada (topic) ya Telegram ambapo ajaniti wa coding anajibu ujumbe wako. Ajaniti huyu ataendesha tmux pane kwenye mashine yako mwenyewe.

Hili ndilo lengo kuu. Bado huhitaji kumbukumbu (memory), monita, au seva za zana (tool servers). Unahitaji tu kumfanya ajaniti akujibu.

⏱️ Muda Unaohitajika: dakika 30–45.

🛠️ Mahitaji ya Awali

Kabla ya kuanza, hakikisha una vitu hivi tayari:

  • Mashine yenye tmux na ufikiaji wa shell.
  • Ajaniti wa coding anayefanya kazi (kama OpenCode au Claude Code) ambao tayari anafanya kazi kwenye tmux pane.
  • Lengo sahihi la tmux kwa ajenti wako (mfano: mybox:1.1).
  • Amri sahihi ya kuwasha ajaniti wako.
  • OpenClaw runtime ikiwa imewekwa.
  • Akaunti ya Telegram na programu ya Telegram.

📦 Matoleo Yanayohitajika

Usiyapuuze haya. Matoleo yasiyo sahihi husababisha hitilafu zisizoonekana.

• Node.js: 24.11.1 • Package Manager: pnpm 11.2.2 • OpenClaw: Weka kwenye commit maalum.

🚀 Njia ya Usanidi wa Haraka

Unaweza kutumia skripti hizi kushughulikia usanidi wa ndani:

  1. Pakua skripti: 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. Endesha usanidi ukitumia token yako ya bot: OPENCLAW_BOT_TOKEN="<YOUR_TOKEN>" OPENCLAW_BOT_ACCOUNT="my-bot" ./setup-openclaw.sh

  3. Thibitisha usanidi: AGENT_ID=my-agent PANE=mybox:1.1 ./ready-check.sh

📱 Usanidi wa Telegram

Fuata hatua hizi kwenye programu yako ya Telegram:

  • Tengeneza bot kupitia @BotFather na uhifadhi token.
  • Tengeneza kikundi kipya na uongeze bot yako.
  • Mfanye bot kuwa Msimamizi (Administrator). Hii inairuhusu kuona ujumbe wako.
  • Washa "Topics" kwenye mipangilio ya kikundi.
  • Tengeneza mada (topic) kwa ajili ya mradi wako.
  • Tuma ujumbe mmoja katika mada hiyo ili kuzalisha Topic ID kwenye log zako.

⚙️ Kuunganisha Kila Kitu

Mlango wa mawasiliano (gateway) unatumia usanidi wa JSON kwenye ~/.openclaw/openclaw.json.

Tumia Awamu ya 1 (Phase 1) kupata Chat ID na Topic ID yako kwa kutuma ujumbe na kuangalia log za gateway.

Tumia Awamu ya 2 (Phase 2) kufunga kikundi. Badilisha sera (policy) kuwa "allowlist" na uongeze User ID yako ya namba ya Telegram pekee. Unganisha Topic ID yako na Agent ID yako mahususi.

📝 Mkataba wa Ajaniti

Tengeneza faili la AGENTS.md kwenye agent workspace yako. Faili hili linaelekeza wakala jinsi ya kutenda. Lazima uainishe:

  • Jinsi ya kusoma pane (tmux capture-pane).
  • Jinsi ya kuandika kwenye pane (tmux send-keys).
  • Jinsi ya kushughulikia amri maalum kama "status", "send", au "restart".

✅ Jaribio la Utayari

Utakuwa umemaliza tu unapopita ukaguzi huu mitano:

  1. Bot inajibu kwenye mada (topic) yako ya Telegram.
  2. Prompt yako inafika kwenye pane ya tmux.
  3. Coding agent anaanza kufanya kazi kwenye prompt hiyo.
  4. Faili la log linathibitisha kuwa wakala alishughulikia mada yako.
  5. Kikundi kimefungwa kwa User ID yako pekee.

Chanzo: https://dev.to/jerilk/coding-agents-over-telegram-part-2-from-zero-to-an-agent-that-answers-2777

Jumuiya ya hiari ya kujifunza: https://t.me/GyaanSetuAi