/int-evolution-go

name: int-evolution-go
description: "Manage Evolution Go instances and send WhatsApp messages via the Evolution Go REST API. Use when you need to list/create/connect instances, send messages (text, media, location, contact, link, sticker, poll), react/edit/delete messages, check connection status, or get QR codes. Calls the Evolution Go server directly with no third-party proxy."
metadata:
  openclaw:
    requires:
      env:
        - EVOLUTION_GO_URL
        - EVOLUTION_GO_KEY
      bins:
        - python3
    primaryEnv: EVOLUTION_GO_KEY
    files:
      - "scripts/*"

Evolution Go

Interact with your Evolution Go (WhatsApp) server via the Evolution Go REST API.

Setup (one-time)

1. Get your API key from your Evolution Go instance admin panel. 2. Set environment variables:

   EVOLUTION_GO_URL=https://go.evolution-api.com
   EVOLUTION_GO_KEY=your-api-key-here

Instance Management

List all instances

python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py instances

Create a new instance

python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py create_instance my-instance --token optional-token

Connect to instance

python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py connect --phone 5511999999999 --webhook https://example.com/webhook
python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py connect --phone 5511999999999 --webhook https://example.com/webhook --immediate --subscribe message,message.update

Disconnect from instance

python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py disconnect

Get instance status

python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py status

Get QR code for pairing

python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py qr

Request pairing code

python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py pair --phone 5511999999999

Logout from instance

python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py logout

Delete an instance

python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py delete_instance <instanceId>

Remove proxy from instance

python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py delete_proxy <instanceId>

Overview of all instances with status

python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py summary

Send Messages

Send text message

python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py send_text 5511999999999 "Hello world"
python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py send_text 5511999999999 "Hello" --delay 1000 --quoted '{"messageId":"ABC","participant":"5511..."}'

Send media (image, video, audio, document)

python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py send_media 5511999999999 --url https://example.com/photo.jpg --type image --caption "Check this out"
python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py send_media 5511999999999 --url https://example.com/doc.pdf --type document --filename report.pdf

Send location

python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py send_location 5511999999999 --lat -19.9167 --lng -43.9345 --name "Office" --address "Av. Afonso Pena, 1000"

Send contact (vCard)

python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py send_contact 5511999999999 --fullName "John Doe" --phone 5511888888888 --org "Acme Corp"

Send link preview

python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py send_link 5511999999999 --url https://example.com --text "Check this link" --title "Example" --description "A great site" --imgUrl https://example.com/og.jpg

Send sticker

python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py send_sticker 5511999999999 --sticker https://example.com/sticker.webp

Send poll

python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py send_poll 5511999999999 --question "Favorite color?" --options "Red,Blue,Green" --maxAnswer 1

Message Operations

React to a message

python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py react 5511999999999 --id MSG_ID --reaction "👍"

Edit a sent message

python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py edit_message --chat 5511999999999@s.whatsapp.net --id MSG_ID --message "Updated text"

Delete message for everyone

python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py delete_message --chat 5511999999999@s.whatsapp.net --id MSG_ID

Mark messages as read

python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py mark_read 5511999999999 --ids MSG_ID1,MSG_ID2

Get message delivery status

python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py message_status --id MSG_ID

Set chat presence (composing/recording)

python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py set_presence 5511999999999 --state composing
python3 /mnt/skills/user/int-evolution-go/scripts/evolution_go_client.py set_presence 5511999999999 --state composing --isAudio

Output

JSON to stdout. Use `--json` flag for raw JSON on any command (default for single-object responses).

Notes

• Evolution Go uses instance-scoped auth: the API key identifies a specific instance.
• Phone numbers accept plain format (e.g. `5511999999999`) — the client converts to JID internally.
• The `send_media` endpoint accepts a URL (not file upload).
• The `send_link` endpoint auto-generates link previews.
• All send comma