手把手教你用 Wechaty 搭建聊天机器人：从安装到实战

nvm install 16
nvm use 16
node -v

mkdir my-wechaty-bot && cd my-wechaty-bot
npm init -y
npm install wechaty

import { WechatyBuilder } from 'wechaty'

const wechaty = WechatyBuilder.build()

wechaty
  .on('scan', (qrcode, status) => {
    const url = `https://wechaty.js.org/qrcode/${encodeURIComponent(qrcode)}`
    console.log(`请扫码登录！状态：${status}\n二维码链接：${url}`)
  })
  .on('login', (user) => console.log(`✅ 登录成功，欢迎回来：${user}`))
  .on('message', (msg) => console.log(`📨 收到消息：${msg}`))

wechaty.start()

node bot.js

import { WechatyBuilder } from 'wechaty'

const FAQ = {
  '价格': '服务分基础版（免费）和专业版（99元/月）。',
  '退款': '支持7天无理由退款，请在订单页面提交申请。',
  '帮助': '回复关键词：价格、退款、联系方式。'
}

const wechaty = WechatyBuilder.build({
  name: 'smart-customer-bot'
})

wechaty.on('scan', (qrcode, status) => {
  const url = `https://wechaty.js.org/qrcode/${encodeURIComponent(qrcode)}`
  console.log(`📱 请扫码登录！\n状态：${status}\n链接：${url}`)
})

wechaty.on('login', async (user) => {
  console.log(`🎉 登录成功！账号：${user.name()}`)
  await user.say('🤖 智能客服已上线！')
})

wechaty.on('message', async (msg) => {
  if (msg.self()) return

  const text = msg.text()
  const from = msg.from()

  // 私聊自动回复
  if (!msg.room() && from) {
    for (const [keyword, reply] of Object.entries(FAQ)) {
      if (text.includes(keyword)) {
        await msg.say(reply)
        return
      }
    }
    await msg.say('🤖 暂无法识别，回复「帮助」查看问题列表。')
  }

  // 群内互动
  if (msg.room()) {
    const room = msg.room()
    const roomName = await room.topic()
    
    if (text.includes('帮助') || text === 'help') {
      const helpMsg = `📋 功能列表：
1. 回复「价格」查看报价
2. 回复「退款」了解流程
3. 回复「联系人工」转客服`
      await room.say(helpMsg)
    }
  }
})

wechaty.on('room-join', async (room, inviteeList, inviter) => {
  const roomName = await room.topic()
  const inviteeNames = inviteeList.map(c => c.name()).join('、')
  const inviterName = inviter?.name() || '未知用户'

  const welcomeMsg = `👋 欢迎 @${inviteeNames} 加入【${roomName}】！\n回复「帮助」查看功能列表。`
  await room.say(welcomeMsg)
})

wechaty.start()

## Linux/macOS
export WECHATY_PUPPET=wechaty-puppet-service

## Windows (PowerShell)
$env:WECHATY_PUPPET="wechaty-puppet-service"

{
  "type": "module"
}

docker run -ti --rm --volume="$(pwd)":/bot wechaty/wechaty smart-bot.js