Preskoči na glavni sadržaj

Jednom komandom ubacite Claude Code u WeChat, slobodnije nego sa OpenClaw-om

Chenmo Wang ErAIWeClawClaude CodeWeChatAgent2669 reči9 minuta

U prethodna dva tutorijala podučavao sam kako da pomoću OpenClaw-a ubacite jastoga u WeChat, a neki su me pitali: može li se povezati Claude Code?

Odgovor je — može!

I ne morate da čekate zvaničnu podršku, postoji open source projekat koji se zove WeClaw i već je to rešio za vas. Instalacija jednom komandom, skenirate QR kod za prijavu, i vaš Claude Code se može direktno koristiti u WeChat-u.

Ovaj projekat je nedavno otvorenog koda na GitHub-u i već je prikupio preko 300 zvezdica. Razvijen je u Go jeziku, pod MIT licencom, potpuno otvorenog koda.

Njegova svrha je jednostavna: omogućiti WeChat ClawBot-u da se poveže sa bilo kojim AI Agentom.

Claude Code, Codex, Gemini, Cursor, Kimi, OpenCode — povežite koga god želite. Čak i Agent koji ste sami razvili, sve dok podržava standardni HTTP protokol, može se povezati.

Iskreno, kada sam video ovaj projekat bio sam pomalo uzbuđen. Pored jastoga, Claude Code je Agent koji mi se svakodnevno najviše sviđa za korišćenje.

01,Šta je WeClaw

WeClaw je alat-most koji povezuje WeChat ClawBot i lokalnog AI Agenta.

WeClaw deluje kao tranzitni sloj, omogućavajući da se WeChat poruke proslede bilo kom Agentu koji podržava ACP, CLI ili HTTP protokol.

Ovde ću objasniti razliku između tri načina integracije:

  • ACP protokol: Agent Communication Protocol, podržava napredne funkcije kao što su poziv alata i sinhronizacija stanja
  • CLI režim: direktno poziva lokalni komandni alat, npr. komandu claude, najprostije i najdirektnije
  • HTTP režim: povezuje se na udaljeni Agent servis preko HTTP API-ja, pogodno za samostalno razvijene Agente ili interne servise preduzeća

Za većinu korisnika, CLI režim je najpraktičniji. Sve dok vaš Agent može da radi u terminalu, WeClaw ga može povezati sa WeChat-om.

02,Instalacija WeClaw-a

Pre instalacije osigurajte da vaš računar ispunjava sledeće uslove:

  • Instaliran WeChat ClawBot (to jest onaj dodatak kojim WeChat zvanično integriše OpenClaw)
  • Instalirano Node.js 18+ okruženje
  • Na računaru je konfigurisan Agent koji želite da koristite (npr. Claude Code)

Ako ste već pratili prethodni OpenClaw tutorijal, okruženje je sigurno u redu. ClawBot je već instaliran, Node.js postoji, pa možete direktno da krenete sa instalacijom WeClaw-a.

U terminalu izvršite komandu za instalaciju:

curl -fsSL https://raw.githubusercontent.com/fastclaw-ai/weclaw/main/install.sh | bash

Ova skripta automatski detektuje arhitekturu vašeg sistema, preuzima odgovarajuću verziju WeClaw binarne datoteke i stavlja je u direktorijum /usr/local/bin. Nakon instalacije, kada unesete weclaw --version i vidite broj verzije, to znači da je instalacija uspela.

Nakon instalacije, pokrenite:

weclaw start

Tada će se pojavi WeChat interfejs za skeniranje QR koda, skenirajte ga WeChat-om da završite prijavu.

Nakon uspešnog skeniranja, WeClaw će prikazati poruku o uspešnoj prijavi i automatski otkriti Agente koje ste lokalno instalirali.

03,Povezivanje sa Claude Code

Podrazumevano povezani Agent je Claude Code. Način konfiguracije je da u ~/.weclaw/config.json dodate:

{
  "agents": {
    "claude": {
      "type": "cli",
      "command": "claude",
      "default": true
    }
  }
}

Značenje pojedinačnih parametara sam takođe pripremio za vas.

Ova konfiguracija znači: definiše se Agent pod imenom "claude", tip je CLI, komanda koja se izvršava je claude, i postavlja se kao podrazumevani Agent.

Sada otvorite WeChat i pošaljite poruku ClawBot-u, a sadržaj će biti prosleđen Claude Code-u na obradu.

Odgovor Claude Code-a vraća se nepromenjen u WeChat prozor za razgovor. Možete direktno u WeChat-u komunicirati sa Claude Code-om, tražiti od njega da piše kod, ispravlja bagove, čita izvorni kod.

Testirao sam jedan konkretan scenario: tražio sam od Claude Code-a da pogleda koje se sve datoteke nalaze u document direktorijumu, brzo ih je pronašao i nabrojao mi jednu po jednu.

Ovo iskustvo je pravo čudo. Ne morate da otvarate prozor Claude Code-a na računaru, ne morate da menjate aplikacije, sve interakcije završavate u WeChat-u.

04,Prebacivanje između više Agent-a

Najugodnija funkcija WeClaw-a je mogućnost trenutnog prebacivanja između različitih Agent-a.

Na primer, ako sada želite da Gemini odgovara, direktno u WeChat-u pošaljite:

/gm

Da biste se vratili na Claude Code:

/cc

Trenutno podržane podkomande obuhvataju:

  • /cc - prebaci na Claude Code
  • /cd - prebaci na Codex
  • /gm - prebaci na Gemini
  • /cs - prebaci na Cursor
  • /km - prebaci na Kimi
  • /oc - prebaci na OpenCode

Ovaj dizajn je veoma praktičan. Različiti Agent-i su dobri u različitim zadacima, pa možete prebacivati prema trenutnoj potrebi, bez ponovne konfiguracije, bez ponovnog pokretanja servisa.

Na primer, neko pita tehničko pitanje — prebacite na Claude Code; treba analizirati dugačak tekst — prebacite na Kimi; želite brzo da napišete skriptu — prebacite na Codex. Jedan WeChat prozor, više mozgova stalno u pripravnosti.

Otkrio sam i jedan skriveni trik: možete istovremeno konfigurisati više instanci Claude Code-a, pri čemu svaka koristi drugačiji model. Na primer, jedna sa Claude Sonnet za složene zadatke, druga sa Claude Haiku za jednostavna pitanja i odgovore. Prebacivanje komandama poput /cc1, /cc2 omogućava finiju kontrolu.

05,Stvarno iskustvo korišćenja

Testirao sam sat vremena, evo nekoliko stvarnih utisaka.

Brzina odgovora

WeClaw je sam po sebi samo most, brzina odgovora uglavnom zavisi od Agent-a kog ste povezali. Odgovor Claude Code-a obično stiže u roku od nekoliko sekundi, otprilike kao i pri direktnom korišćenju u terminalu.

Osnovne komande:

weclaw start: podrazumevano pokreće servis u pozadini
weclaw status: prikazuje status rada servisa
weclaw stop: zaustavlja servis
weclaw restart: ponovo pokreće servis
weclaw start -f: radi u prvom planu (za debagovanje, možete videti logove u realnom vremenu)

Stabilnost

Kao projekt koji je tek otvorenog koda, stabilnost WeClaw-a je prilično dobra. Koristio sam ga neprekidno nekoliko sati, bez prekida veze ili gubitka poruka.

Deo Agent-a podrazumevano zahteva interaktivno potvrđivanje dozvola, što se u WeChat scenariju ne može izvesti i dovodi do zaglavljivanja. To se može zaobići konfiguracijom args da preskočite bezbednosnu proveru.

{
  "claude": {
    "type": "cli",
    "command": "/usr/local/bin/claude",
    "args": ["--dangerously-skip-permissions"]
  },
  "codex": {
    "type": "cli",
    "command": "/usr/local/bin/codex",
    "args": ["--skip-git-repo-check"]
  }
}

Jedan detalj treba pažnje: WeClaw zavisi od stanja veze WeChat ClawBot-a. Ako WeChat padne ili ClawBot naiđe na anomaliju, WeClaw će takođe biti pogođen. Tada je potrebno ponovo izvršiti weclaw start i skenirati QR kod za prijavu.

Scenariji korišćenja

Scenarij u kojem je WeClaw najpogodniji jeste: već ste navikli na korišćenje nekog Agent-a (npr. Claude Code), ali želite da ga povežete sa WeChat-om i koristite u svakom trenutku.

Na primer, kada sam napolju na ručku, iznenada se setim pitanja o kodu, izvadim telefon, pošaljem komandu ClawBot-u, a Claude Code u pozadini obradi. Ne moram da palim računar, ne moram da otvaram pretraživač, sve rešim direktno u WeChat-u.

Još jedan scenario koji često koristim: u krevetu pre spavanja listam tehničke članke, vidim koncept koji ne razumem, direktno prosledim ClawBot-u i tražim od Claude Code-a da mi objasni. Ne moram da ustajem da palim računar, ne moram da menjam aplikacije, sve završim u WeChat-u.

Zajedničko za ove scenarije je: potrebna vam je moć AI-ja, ali ne želite da vam prekinu trenutni radni tok. Vrednost WeClaw-a je u tome što AI ugurava u aplikaciju koju već najviše koristite.

Ograničenja

WeClaw zahteva da vaš lokalni računar ostane uključen i povezan na internet, jer se Agent izvršava na vašem računaru. Ako se računar ugasi, WeChat neće primiti odgovor. To je isto kao i kod OpenClaw-a, u pitanju je arhitektura lokalnog izvršavanja.

06,Napredne tehnike

Uspešno povezivanje je tek početak, WeClaw ima i još nekoliko naprednih tehnika koje vredi isprobati.

Prilagođeni Agent

Ako imate sopstveni Agent servis, možete ga povezati sa WeClaw-om putem HTTP protokola. Način konfiguracije je da u config.json dodate:

{
  "agents": {
    "mybot": {
      "type": "http",
      "endpoint": "http://localhost:8080/api/chat",
      "headers": {
        "Authorization": "Bearer your-token"
      }
    }
  }
}

Tako možete u WeChat ubaciti sopstvenog Agent-a ili interni AI servis preduzeća.

Aktivno slanje poruka

WeClaw podržava slanje poruka WeChat korisnicima bez čekanja da korisnik pošalje poruku. Ova funkcija je veoma praktična i može se koristiti za obaveštenja o alarmima, podsetnike u zakazano vreme, pretplatničke poruke i sl.

Preko komandne linije:

# Pošalji čist tekst
weclaw send --to "xx@im.wechat" --text "Zdravo, od weclaw-a"

# Pošalji sliku
weclaw send --to "xx.wechat" --media "https://cdn.paicoding.com/paicoding/ea15e607c84a915b4bd268c24cc0e1ff.png"

# Pošalji tekst + sliku
weclaw send --to "xx@im.wechat" --text "Pogledaj Mianzha Nixi, baš ti treba" --media "https://cdn.paicoding.com/paicoding/d072ca217fedc33c0b70085761ea7f40.png"

Ako vas zanima kako da pronađete korisnički ID, možete pogledati kroz logove tail -f ~/.weclaw/weclaw.log.

WeClaw takođe nudi HTTP API koji se može pozvati iz programa. Nakon pokretanja servisa podrazumevano sluša na 127.0.0.1:18011:

curl -X POST http://127.0.0.1:18011/api/send \
  -H "Content-Type: application/json" \
  -d '{"to": "user_id@im.wechat", "text": "Zdravo, od weclaw-a"}'

Ovaj API se može integrisati u vaše automatizacione skripte. Na primer, kada CI/CD izgradnja ne uspe, automatski se šalje obaveštenje, kada završi vremenski zadatak šalje se rezultat, a kada se okine nadzor alarma šalje se informacija o upozorenju.

Utisci iz prakse

WeClaw automatski obrađuje slike i medijske datoteke u AI odgovorima, tako da se one prikazuju direktno u WeChat-u, umesto da se daje samo veza.

On će: 1. izvući vezu slike i preuzeti je; 2. šifrovati i otpremiti na WeChat CDN; 3. direktno poslati poruku sa slikom. Uz to, Markdown se pretvara u čist tekst, uklanjajući ograde blokova koda, URL-ove veza i oznake formatiranja.

07,Rešavanje uobičajenih problema

Tokom povezivanja možete naići na neke probleme, evo nekoliko najčešćih.

Nakon skeniranja prijava ne uspe

Proverite da li je mrežna veza u redu, potvrdite da WeChat može da pristupi internetu, a zatim ponovo pokrenite weclaw login.

Agent ne odgovara, u logovima piše "agent not available"

Proverite da li je putanja Agent-a u konfiguracionoj datoteci ~/.weclaw/config.json ispravna, potvrdite da je Agent ispravno instaliran na vašem sistemu i proverite da li binarni fajl Agent-a ima dozvolu za izvršavanje.

Claude CLI zastane i ne odgovara

Claude CLI podrazumevano zahteva interaktivno potvrđivanje dozvola, pa je potrebno u konfiguraciji dodati parametar --dangerously-skip-permissions. Način konfiguracije je već objašnjen, pa ga nećemo ponavljati.

Codex prijavljuje grešku u direktorijumu koji nije git

Codex podrazumevano zahteva da radi unutar git repozitorijuma, pa je potrebno dodati parametar --skip-git-repo-check.

Suština ovih problema leži u ograničenjima samog Agent-a — WeClaw samo prosleđuje poruke i ne menja ponašanje Agent-a. Kada ovo razumete, naiđete na problem, prvo proverite konfiguraciju Agent-a.

08,Čitanje izvornog koda

Ako vas zanima tehnička realizacija, pogledajte strukturu izvornog koda WeClaw-a.

Projekat je razvijen u Go jeziku, a ukupna struktura je veoma jasna:

weclaw/
├── main.go           # Ulazna datoteka, poziva cmd.Execute()
├── cmd/              # Obrada komandne linije
│   ├── start.go      # Pokretanje servisa
│   ├── login.go      # Prijava na WeChat
│   ├── send.go       # Slanje poruka
│   ├── status.go     # Pregled statusa
│   └── ...
├── agent/            # Sloj za prilagođavanje Agent-a
│   ├── agent.go      # Definicija interfejsa Agent-a
│   ├── acp_agent.go  # Realizacija ACP protokola
│   ├── cli_agent.go  # Realizacija CLI režima
│   └── http_agent.go # Realizacija HTTP režima
├── messaging/        # Obrada poruka
│   ├── handler.go    # Usmeravanje poruka
│   ├── sender.go     # Slanje poruka
│   ├── markdown.go   # Konverzija Markdown-a
│   ├── media.go      # Obrada medija
│   └── cdn.go        # Otpremanje na WeChat CDN
├── config/           # Upravljanje konfiguracijom
├── api/              # HTTP API
└── service/          # Konfiguracija sistemskog servisa

Ulaz i obrada komandi

main.go ima samo 7 linija koda, ulaz je veoma jednostavan. Prava logika se nalazi u cmd/ direktorijumu. start.go je najvažnija datoteka, odgovorna za pokretanje servisa, inicijalizaciju veze i slušanje poruka.

Direktorijum cmd/ koristi Cobra okvir, koji je najpopularniji komandni okvir za Go. Svaka podkomanda u posebnoj datoteci, struktura jasna. Ako želite da učite razvoj Go CLI-ja, ovo je odličan primer.

Sloj za prilagođavanje Agent-a

Direktorijum agent/ je srž celog projekta. On definiše interfejs Agent-a, a zatim za sva tri protokola implementira odgovarajući adapter.

acp_agent.go je najkompleksniji, mora da održava dugovečni podproces, sa stdio komunikacijom preko JSON-RPC-a. Prednost je višestruka upotreba procesa, brz odgovor i održavanje konteksta.

cli_agent.go je najjednostavniji, za svaku poruku pokreće novi proces, koji se nakon upotrebe uništi. Prednost je jednostavna realizacija, mana je što svaki put treba hladan start, pa je brzina nešto sporija.

http_agent.go je standardna realizacija HTTP klijenta, koja poziva udaljeni API. Pogodno za scenarije u kojima je Agent raspoređen na drugim serverima.

Ovaj obrazac dizajna zove se strategija. Isti interfejs, različite realizacije, pozivalac uopšte ne mora da brine o detaljima podloge. Ako želite da učite obrasce dizajna u Go jeziku, ovaj projekat je odlična referenca.

Tok obrade poruka

Glavni tok je sledeći: WeChat poruka → messaging/handler.go raščlanjuje i usmerava → agent/ poziva odgovarajućeg Agent-a → vraća rezultat → messaging/ pretvara format → šalje nazad u WeChat.

handler.go je odgovoran za usmeravanje poruka, procenjuje kom Agentu se šalje, da li je komanda i kako obraditi podkomande.

sender.go je odgovoran za slanje poruka, šalje obrađeni sadržaj nazad u WeChat.

markdown.go je odgovoran za konverziju Markdown-a u čist tekst. Agent obično vraća Markdown format, koji WeChat ne podržava direktno. Ovaj modul uklanja ograde blokova koda, iz veza zadržava samo tekst, uklanja oznake za bold i kurziv itd.

Obrada medija

Obrada medija je prilično zanimljiva. WeChat zahteva da slike moraju biti otpremljene na sopstveni CDN i pritom AES-128-ECB šifrovane. WeClaw u messaging/cdn.go realizuje ovu logiku i automatski preuzima vezu slike koju Agent vrati, šifruje je, otprema i šalje.

media.go je odgovoran za izdvajanje veza slika iz Agentovog odgovora, preuzima datoteke i određuje tip datoteke.

Ovaj tok je potpuno automatizovan, za korisnika nevidljiv. Agent samo treba da vrati standardnu Markdown sintaksu za slike, a WeClaw automatski obradi ostalo.

Ako želite detaljnije da proučite arhitekturu Go projekata ili želite sami da implementirate sličan alat-most, ovaj projekat je odlična referenca. Količina koda nije velika, struktura je jasna, a obuhvata CLI razvoj, komunikaciju procesa, HTTP klijent, algoritme šifrovanja i mnoge druge teme.

09,Pisanje u biografiju

Ako ste WeClaw iskoristili u stvarnom projektu, možete razmisliti o tome da ga ovako upišete u biografiju.

Ime projekta: WeChat AI Agent platforma-most

Kratak opis projekta: Alat-most za WeChat poruke razvijen u Go jeziku, ostvaruje real-time komunikaciju između WeChat-a i više AI Agent-a (Claude Code, Codex, Gemini itd.), podržava ACP/CLI/HTTP tri načina povezivanja.

Tehnološki sklop: Go, JSON-RPC, WeChat ClawBot protokol, AES-128-ECB šifrovanje, Docker

Ključne odgovornosti:

  • Dizajnirao i implementirao sloj apstrakcije Agent-a, podržava objedinjeno povezivanje više AI Agent-a, a preko strategija realizuje neprimetno prebacivanje između tri komunikaciona protokola ACP/CLI/HTTP
  • Implementirao sistem usmeravanja WeChat poruka, podržava podkomande za prebacivanje Agent-a, kontrolu prava, konverziju formata poruka itd., dnevno obradi preko 1000 poruka
  • Dizajnirao tok obrade medija, automatski izdvaja veze slika iz Agentovih odgovora i realizuje AES-128-ECB šifrovanje za otpremanje na WeChat CDN, podržava multimodalne tipove kao što su slike/video/datoteke
  • Pružio API za aktivno slanje, podržava slanje poruka WeChat korisnicima preko komandne linije i HTTP interfejsa, pogodno za obaveštenja o alarmima, podsetnike i sl.
  • Napisao Dockerfile i konfiguraciju systemd servisa, čime je ostvarena implementacija jednim klikom i samopokretanje, uz smanjenje troškova održavanja

Prednost ovakvog zapisa je: prikazuje i tehničke sposobnosti (Go, dizajn protokola, šifrovanje, Docker), i inženjerske sposobnosti (dizajn arhitekture, operativno raspoređivanje), a i kvantifikuje rezultate (dnevno preko 1000 obrađenih poruka).

ending

Za korisnika poput mene, koji želi i da koristi Claude Code i da njime upravlja putem WeChat-a bilo gde i bilo kada, WeClaw nudi savršeno rešenje.

[Prava vrednost AI alata nije u tome koliko je moćan, već u tome da li se može uklopiti u vaš postojeći radni tok. WeChat je taj najprirodniji ulaz, a WeClaw vam pomaže da u njega ubacite sve Agent-e.]

Snaga open source zajednice upravo je u tome. Funkcije koje zvanično ne uradi, radi zajednica. Alate koje zvanično ne podržava, podržava zajednica. WeClaw je upravo jedan takav tipičan projekat inovacije zajednice.

Ako ste i vi teži korisnik Claude Code-a ili želite u jednom prozoru da upravljate sa više Agent-a, probajte WeClaw.

Još jedan podsetnik: WeClaw se i dalje brzo razvija, pa ako naiđete na problem, možete na GitHub-u prijaviti issue, autor brzo odgovara. Pozdravno je i da projektu date zvezdicu, čime podržavate razvoj open source zajednice.

Za pitanja se vidimo u komentarima, vidimo se u sledećem!