在過去的幾個月中,由于在新生群中回答問題費時費力,同時又有許多重復而又有固定答案的回答,我受到一些知乎文章的啟發(fā),維護了一個基于itchat的群聊機器人。從剛開始接入圖靈機器人時只會尬聊的機器人,之后又加入了api.ai的按照消息內(nèi)容自動回復,而后再加入了回復表情功能,使得機器人變得越來越有趣。
現(xiàn)在,由于itchat的更新和被wxpy一些更有趣的功能所吸引,我計劃將這個機器人分步重寫,并將完整的機器人構(gòu)建步驟展現(xiàn)給大家。這是我第一次做這樣的事,有諸多不足之處,也希望多多諒解和指正。
本文很大程度上面向僅對python入門或是了解較少的開發(fā)者因此較為詳細,希望最大程度上幫助大家從零開始構(gòu)建一個屬于自己的微信機器人,哪怕僅有很少的編程基礎(chǔ)。每一篇會將長度控制在較短、能夠快速閱讀完的范圍內(nèi)。
本文基于python 2.7,與python 3.5可能有語法上區(qū)別。
安裝wxpy
安裝wxpy非常簡單,如果你擁有pip,請直接按照Github中的方法安裝:
從 PYPI 官方源下載安裝 (在國內(nèi)可能比較慢或不穩(wěn)定):
pip install -U wxpy
從豆瓣 PYPI 鏡像源下載安裝 (推薦國內(nèi)用戶選用):
pip install -U wxpy -i "https://pypi.doubanio.com/simple/"
登錄微信
(這里吐槽一下wxpy文檔中登錄錯寫為登陸)
Github上和文檔中給出了最簡單的登錄機器人的方式,在程序中寫上這兩行并運行,會通過圖片掃描二維碼并登錄微信。
# 導入模塊
from wxpy import *
# 初始化機器人,掃碼登陸
bot = Bot()
有些情況下,可能不能通過終端打開圖片(例如部署在服務器上時),我們可以通過參數(shù)選擇在終端內(nèi)顯示二維碼,這樣代碼會變?yōu)椋?/p>
from wxpy import *
bot = Bot(console_qr=True)
如果你發(fā)現(xiàn)這樣設置終端中的二維碼變形了,可以嘗試傳入console_qr=1
(或其他倍數(shù))來進行調(diào)整字幅寬度。如果需要反色顯示,可以使用負數(shù)來進行反色操作。
如果你認為每次都需要掃描二維碼很麻煩,可以啟用緩存,來保存自己的登錄狀態(tài):
bot = Bot(console_qr=True, cache_path=True)
發(fā)送消息
首先我們嘗試給自己和文件傳輸助手發(fā)消息:
# 給機器人自己發(fā)送消息
bot.self.send('Hello World!')
# 給文件傳輸助手發(fā)送消息
bot.file_helper.send('Hello World!')
如果無法給機器人自身發(fā)送消息,請參考http://wxpy.readthedocs.io/zh/latest/bot.html#wxpy.Bot.self
# 查找昵稱為'乙醚。'的好友
my_friend = bot.friends().search(u'乙醚。')[0]
# <Friend: 乙醚。>
wxpy同時也包括了發(fā)送不同類型消息的方法,通過這些方法我們可以發(fā)送各種不同類型的消息。以下是文檔給出的樣例使用方式:
# 發(fā)送文本
my_friend.send('Hello, WeChat!')
# 發(fā)送圖片
my_friend.send_image('my_picture.png')
# 發(fā)送視頻
my_friend.send_video('my_video.mov')
# 發(fā)送文件
my_friend.send_file('my_file.zip')
# 以動態(tài)的方式發(fā)送圖片
my_friend.send('@img@my_picture.png')
通過使用這些方法,我們就可以自定義一個在合適的時候做合適的事情的機器人了!
由于群聊機器人設計暫時需要好友相關(guān)內(nèi)容不多,此處不再作過過多贅述,如果有需要搜索好友的可以參考http://wxpy.readthedocs.io/zh/latest/chats.html#module-wxpy
自動處理消息
wxpy提供了注冊消息的方法,可以簡單將各種類型的消息注冊并自定義處理方式。
注冊消息使用簡單的@bot.register()
方法,
# 獲取所有類型的消息(好友消息、群聊、公眾號,不包括任何自己發(fā)送的消息)
# 并將獲得的消息打印到控制臺
@bot.register()
def print_others(msg):
print(msg)
同時wxpy也可以給注冊消息的類型加上限制,
# 回復 my_friend 發(fā)送的消息
@bot.register(my_friend)
def reply_my_friend(msg):
return 'received: {} ({})'.format(msg.text, msg.type)
# 回復發(fā)送給自己的消息,可以使用這個方法來進行測試機器人而不影響到他人
@bot.register(bot.self, except_self=False)
def reply_self(msg):
return 'received: {} ({})'.format(msg.text, msg.type)
# 打印出所有群聊中@自己的文本消息,并自動回復相同內(nèi)容
# 這條注冊消息是我們構(gòu)建群聊機器人的基礎(chǔ)
@bot.register(Group, TEXT)
def print_group_msg(msg):
if msg.is_at:
print(msg)
msg.reply(meg.text)
當然僅僅寫以上內(nèi)容,會導致你的程序主程序運行結(jié)束自然退出。wxpy給出了embed()
方法,在程序末尾(或其他你想要暫停調(diào)試的地方)加上embed()
方法就可以讓程序保持運行,同時進入Python命令行。
# 進入 Python 命令行、讓程序保持運行
# 推薦使用
embed()
# 或者僅僅堵塞線程
# bot.join()
關(guān)于消息注冊的文檔,更多內(nèi)容可以參考http://wxpy.readthedocs.io/zh/latest/messages.html#id11
現(xiàn)在,你已經(jīng)可以用這個微信機器人和自動回復消息玩了!刺不刺激呢!
下一篇中,我將就如何將API接入機器人進行闡述。
你可能會遇到的一些問題
報錯[SSL: CERTIFICATE_VERIFY_FAILED]
可能的解決方案一:
pip install -U requests[security]
可能的解決方案二:
進如python后運行:
import certifi
print(certifi.old_where())
把打印出的路徑(例如我的是/usr/local/lib/python2.7/site-packages/certifi/weak.pem
)放入環(huán)境變量REQUESTS_CA_BUNDLE
中。具體而言是在*nix環(huán)境下運行:
export REQUESTS_CA_BUNDLE='What you get'
或是在Windows中使用系統(tǒng)面板進行修改。
機器人代碼
我的微信機器人的代碼在GitHub托管,歡迎查看(づ ̄3 ̄)づ╭?~