ClawBot自动问候与欢迎语设置教程

新成员加入后没收到自动问候？别急着怀疑机器人“罢工”，问题往往出在配置环节。ClawBot的自动欢迎功能看似简单，背后其实需要几个关键模块协同工作：从Discord网关的事件监听，到内置技能模块的激活，再到微信端的插件绑定，任何一个环节缺失都会导致欢迎语“静默”。下面咱们就按顺序，把可能出问题的地方逐一排查。

如果你的ClawBot已经部署，但新人入群后毫无反应，大概率是事件监听没开、技能模块没激活、模板没配，或者Webhook没注册。跟着下面这些具体步骤走一遍，基本就能解决问题。

一、启用Discord网关特权意图与频道权限

想让ClawBot知道“有人来了”，首先得让它能“听”到Discord网关发送的GUILD_MEMBER_ADD这类事件。这就必须显式开启两项特权意图（Privileged Intents），同时确保机器人拥有读取成员列表、发送消息等最基本的频道权限。这两项配置缺一不可，否则整个欢迎逻辑链在第一步就断了。

1. 登录Discord开发者门户（Developer Portal），找到你的ClawBot应用。

2. 在左侧菜单点击「Bot」，向下滚动到「Privileged Gateway Intents」区域。

3. 确保「SERVER MEMBERS INTENT」和「MESSAGE CONTENT INTENT」这两项意图都已启用。

4. 回到应用首页，点击「OAuth2」→「URL Generator」。在「Scopes」里勾选「bot」；在「Bot Permissions」里至少勾选：查看频道、发送消息、读取消息历史、嵌入链接这几项权限。

5. 复制生成的邀请链接，用浏览器打开，把机器人添加到你的目标服务器。

二、启用并配置ClawBot内置Welcome Skill

事件能收到了，接下来得有个“处理器”来响应。Welcome Skill就是ClawBot最新提供的标准响应模块，专门用来捕获成员加入事件并推送结构化的欢迎消息。它依赖内存缓存来记录首次加入时间戳，支持变量替换和富文本渲染，不用写代码就能启用。

1. 确认ClawBot服务正在运行，执行命令：clawbot skill list，看看输出里welcome技能的状态是不是“enabled”。

2. 如果没启用，执行：clawbot skill enable welcome。

3. 编辑模板文件：~/.clawbot/skills/welcome/templates/zh.json。

4. 修改里面的"message"字段，比如改成：“欢迎{member.name}加入{guild.name}！请先阅读#规则频道，然后点击✅完成身份验证。”

5. 保存文件后，执行：clawbot skill reload welcome让更改生效。

三、注册成员首消息Hook规则并绑定AutoMod Webhook

光有欢迎技能可能还不够。如果想拦截敏感行为，或者触发更复杂的多阶段响应（比如“欢迎+审核+引导”闭环），就必须注册GUILD_MEMBER_ADD事件Hook，并联动Discord的AutoMod Webhook。

1. 进入ClawBot的管理后台，找到「事件规则」→「新增Hook」。

2. 事件类型选择GUILD_MEMBER_ADD，触发动作可以设为“执行Welcome Skill + 启动审核流程”。

3. 在AutoMod设置页面，启用“预设规则组：新人行为监控”，并把Webhook地址填成：https://your-clawbot-domain/api/v1/automod/webhook。

4. 点击「测试Webhook」按钮，确认返回HTTP 200状态码，并且日志里出现了“Webhook registered for member join”的记录。

5. 最后，用一个新注册的Discord账号加入服务器，看看是否同时收到了欢迎消息和身份验证弹窗。

四、配置微信群欢迎语与自我介绍引导

说完了Discord，微信这边是另一套逻辑。ClawBot通过监听微信群成员变动事件来实现入群即发，需要启用群事件订阅、定义带变量的模板，并且可以嵌入快捷指令来引导新人做标准化自我介绍。

1. 登录ClawBot管理后台，进入「微信设置」→「事件订阅」，把群成员加入和群消息接收这两项都勾上。

2. 进入「消息模板」页面，新增一个模板，类型选“群成员加入欢迎语”，名称可以叫“微信标准欢迎”。

3. 内容可以这样填：“欢迎{nickname}入群！⏰{time} ?请按格式做个自我介绍吧：城市+行业+来意 ⬇️”。

4. 在模板末尾，插入一段快捷指令代码：[self_intro:城市+行业+来意]，这样新成员点击就能快速填写。

5. 保存后，重启ClawBot的微信网关进程，然后用一个测试微信号加群，验证响应是否及时。

五、启用微信ClawBot插件并完成首次私聊绑定

微信端的自动问候还有一个隐藏前提：ClawBot插件需要和用户建立一次真实的私聊会话。只有完成首次私聊并触发元数据生成，ClawBot才能识别联系人身份，进而投送个性化的问候。

1. 确保微信版本足够新：iPhone用户需升级到8.0.70及以上，安卓用户请更新到最新正式版。

2. 在微信内进入「我 → 设置 → 插件」，查找并点击「微信ClawBot」插件卡片。

3. 在电脑终端执行命令：npx -y @tencent-weixin/openclaw-weixin-cli@latest install。

4. 扫描终端弹出的二维码，在微信端点击「继续连接」，完成通道绑定。

5. 绑定成功后，你的通讯录里会出现「微信ClawBot」这个联系人。给它发送任意文字（比如“你好”），激活这第一次会话，后续的自动问候功能就准备就绪了。