OpenClaw从入门到应用——频道:Zalouser
通过OpenClaw实现副业收入《OpenClaw赚钱实录从“养龙虾“到可持续变现的实践指南》插件要求Zalo Personal 以插件形式提供不包含在核心安装包中通过 CLI 安装openclaw plugins install openclaw/zalouser或者从源码检出安装openclaw plugins install ./extensions/zalouser详细信息插件无需外部的zca/openzcaCLI 二进制文件。快速设置新手安装插件见上文。登录在网关机器上使用二维码openclaw channels login --channel zalouser使用 Zalo 手机应用扫描二维码。启用频道theme{theme:{light:min-light,dark:min-dark}} { channels: { zalouser: { enabled: true, dmPolicy: pairing, }, }, }重启网关或完成引导流程。私聊访问默认采用配对模式首次联系时需批准配对码。这是什么完全通过zca-js在进程内运行。使用原生事件监听器接收传入消息。通过 JS API 直接发送回复文本/媒体/链接。专为“个人账号”使用场景设计适用于无法使用 Zalo 官方机器人 API 的情况。命名频道 ID 为zalouser以明确表示这是一个个人 Zalo 用户账号的自动化方案非官方。我们保留zalo供未来可能的官方 Zalo API 集成使用。查找 ID目录使用目录 CLI 发现联系人/群组及其 IDtheme{theme:{light:min-light,dark:min-dark}}openclaw directory self--channelzalouser openclaw directory peers list--channelzalouser--query姓名openclaw directorygroupslist--channelzalouser--query工作限制发送的文本将被分块每块约 2000 字符Zalo 客户端限制。默认阻止流式输出。访问控制私聊channels.zalouser.dmPolicy支持以下值pairing | allowlist | open | disabled默认值pairing。channels.zalouser.allowFrom接受用户 ID 或名称。在引导期间名称会通过插件进程内的联系人查找解析为 ID。通过以下命令批准openclaw pairing list zalouseropenclaw pairing approve zalouser 配对码群组访问可选默认channels.zalouser.groupPolicy open允许群组。使用channels.defaults.groupPolicy可在未设置时覆盖默认值。限制为白名单模式channels.zalouser.groupPolicy allowlistchannels.zalouser.groups键应为稳定的群组 ID启动时会尽可能将名称解析为 IDchannels.zalouser.groupAllowFrom控制允许的群组中哪些发送者可以触发机器人阻止所有群组channels.zalouser.groupPolicy disabled。配置向导可以提示设置群组白名单。启动时OpenClaw 会将白名单中的群组/用户名解析为 ID并记录映射关系。默认情况下群组白名单匹配仅基于 ID。除非启用channels.zalouser.dangerouslyAllowNameMatching: true否则未解析的名称不会用于身份验证。channels.zalouser.dangerouslyAllowNameMatching: true是一种紧急兼容模式会重新启用可变的群组名称匹配。如果未设置groupAllowFrom运行时会回退使用allowFrom进行群组发送者检查。发送者检查同时适用于普通群组消息和控制命令例如/new、/reset。示例theme{theme:{light:min-light,dark:min-dark}} { channels: { zalouser: { groupPolicy: allowlist, groupAllowFrom: [1471383327500481391], groups: { 123456789: { allow: true }, 工作群: { allow: true }, }, }, }, }群组 提及 门控channels.zalouser.groups.群组.requireMention控制群组回复是否需要 提及。解析顺序精确的群组 ID/名称 → 规范化的群组别名 →*→ 默认值true。这既适用于白名单群组也适用于开放群组模式。授权的控制命令例如/new可以绕过 提及 门控。当因为需要 提及 而跳过某条群组消息时OpenClaw 会将其存储为待处理的群组历史记录并在下一条被处理的群组消息中一并包含。群组历史记录限制默认为messages.groupChat.historyLimit回退值为50。你可以通过channels.zalouser.historyLimit为每个账号单独覆盖此限制。示例theme{theme:{light:min-light,dark:min-dark}} { channels: { zalouser: { groupPolicy: allowlist, groups: { *: { allow: true, requireMention: true }, 工作群: { allow: true, requireMention: false }, }, }, }, }多账号账号映射为 OpenClaw 状态中的zalouser配置文件。示例theme{theme:{light:min-light,dark:min-dark}} { channels: { zalouser: { enabled: true, defaultAccount: default, accounts: { work: { enabled: true, profile: work, }, }, }, }, }输入状态、消息反应和送达回执OpenClaw 在发送回复前会先发送一个“正在输入”事件尽力而为。在频道动作中zalouser支持消息反应动作react。使用remove: true可移除消息中的特定反应表情。反应语义消息反应对于包含事件元数据的传入消息OpenClaw 会发送已送达和已读回执尽力而为。故障排除登录状态无法保持openclaw channels status --probe重新登录openclaw channels logout --channel zalouser openclaw channels login --channel zalouser白名单/群组名称无法解析在allowFrom/groupAllowFrom/groups中使用数字 ID或者使用精确的好友/群组名称。从旧的基于 CLI 的设置升级移除任何旧的外部zca进程假设。该频道现在完全在 OpenClaw 内运行无需外部 CLI 二进制文件。