Friends

Friends (friend)

Command	Description
friend list [--no-cache]	List all friends (cache-first; --no-cache forces live fetch)
friend search <name> [--no-cache]	Search by name — cache-first; --no-cache forces live
friend online	List online friends
friend find <query>	Find by phone or ID (always live)
friend info <userId>	Get user profile
friend add <userId> [-m msg]	Send friend request
friend accept <userId>	Accept request
friend remove <userId>	Remove friend
friend block <userId>	Block user
friend unblock <userId>	Unblock user
friend last-online <userId>	Check last seen
friend find-username <username>	Find by Zalo username
friend alias <friendId> <alias>	Set nickname
friend alias-list [-c count] [-p page]	List all aliases
friend alias-remove <friendId>	Remove alias
friend reject <userId>	Reject friend request
friend undo-request <userId>	Cancel sent request
friend sent-requests	List sent requests
friend request-status <userId>	Check request status
friend close	List close friends
friend recommendations	Friend recommendations & received requests
friend find-phones <phones..>	Find users by phone numbers

Local Cache (v1.1.0)

friend list and friend search read from a local cache seeded by listen or mcp start. Use --no-cache to bypass and fetch fresh data directly from Zalo.

zalo-agent friend list                # Cache-first (instant if seeded)
zalo-agent friend list --no-cache     # Force live Zalo fetch + re-seed cache

zalo-agent friend search "Phuc"           # Searches local contacts cache
zalo-agent friend search "Phuc" --no-cache  # Force live fetch then filter

Examples

# Find someone by phone
zalo-agent friend find 0901234567

# Set a nickname
zalo-agent friend alias <friendId> "Boss"

# Check who sent you requests
zalo-agent friend recommendations