跳到主要内容

💬 微信接入

将 YingClaw 接入微信，让它成为一个随时可聊的私人助手。

接入概览​

YingClaw 支持通过微信消息通道接收和发送消息，让用户在微信中直接与 AI 对话，获得无缝的交互体验。

场景说明
🤖 个人助手微信私聊中随时提问、执行任务
👥 群聊协作在群聊中按需响应，不喧宾夺主
📢 通知推送定时任务结果自动推送到微信

接入方式​

方式一：微信个人号接入（推荐）​

通过 WeChaty 等协议兼容方案（如 WeChat4U、PadLocal 等 Puppet）实现个人号接入。

优势：

  • 使用个人微信账号，无需认证
  • 支持私聊和群聊
  • 消息格式丰富（文本、文件、图片）

限制：

  • 需遵守微信使用规范
  • 建议使用专用账号，避免影响日常使用

方式二：企业微信接入​

通过企业微信应用，接入门槛更高但稳定性更好。

优势：

  • 官方 API 支持，稳定性好
  • 可绑定多个成员
  • 支持 Webhook 消息推送

配置步骤​

1. 准备微信账号​

建议使用一个独立的微信号（非主号），避免频繁操作影响日常使用。

2. 安装接入插件​

yingclaw plugin install wechat

3. 配置通道参数​

在 YingClaw 配置文件中设置微信通道：

channels:
  wechat:
    enabled: true
    puppet: 'wechat4u'       # 或 'padlocal'
    auto_reply: true
    groups:
      - name: '工作群'
        auto_join: false
        respond_only_mentioned: true
参数说明
puppet接入协议类型
auto_reply是否自动回复私聊消息
groups群聊配置列表
respond_only_mentioned群聊中是否仅在 @ 时回应

4. 扫码登录​

配置完成后启动，终端会显示二维码，使用微信扫码即可登录。

yingclaw channel start wechat

消息交互​

私聊场景​

用户在微信中直接发送消息，YingClaw 实时响应，支持：

  • 💬 自然语言对话
  • 📄 文件读写和编辑
  • 🔍 Web 搜索和信息查询
  • ⏰ 任务安排和提醒

群聊场景​

YingClaw 在群聊中遵循默默观察、按需发言的原则：

  • 被 @ 提及时主动回应
  • 群内有明确问题时提供帮助
  • 日常闲聊保持静默，不打扰

文件发送​

通过微信通道，YingClaw 可以将生成的文件（文档、表格、图片等）直接发送给用户。

通知推送​

将定时任务结果推送到微信：

# 定时任务配置示例
jobs:
  - name: '每日站会提醒'
    schedule: '0 9 * * 1-5'
    type: agent
    delivery:
      channel: weixin
      to: '个人微信'

安全提醒​

  • 使用独立微信账号接入
  • 不要在群聊中暴露私人记忆
  • 定期检查接入状态和消息记录
  • 敏感操作（如删除文件、执行外部请求）需要确认

下一步​

最后于 更新