{"item":{"id":"wf-messaging-gateway","product":"hermes","language":"zh","title":"使用明确白名单接入一个消息渠道","summary":"分别验证发送者权限、会话路由和真实回复送达。先用私人测试会话；gateway 已登记不等于接入成功。","contentType":"guide","category":"integration","revision":2,"canonicalUrl":"https://botclaw.tech/items/wf-messaging-gateway?lang=zh","sourceUrls":["https://hermes-agent.nousresearch.com/docs/user-guide/messaging/"],"sourcePublishedAt":"2026-10-01T13:51:23.773Z","reviewedAt":"2026-10-01T00:00:00.000Z","collectedAt":"2026-10-01T13:51:23.773Z","updatedAt":"2026-10-01T13:51:29.241Z","source":{"id":"botclaw-editorial","name":"BotClaw","origin":"editorial"},"summaryMethod":"editor","applicability":{"version":null,"platforms":["Channel supported by the current Hermes gateway"],"requirements":["本地对话正常、测试机器人或账户，以及私下保存的凭据","明确发送者白名单，试用时不要开启所有用户访问"]},"verification":{"kind":"official_documentation","checkedAt":"2026-10-01T00:00:00.000Z","urls":["https://hermes-agent.nousresearch.com/docs/user-guide/messaging/"],"limitations":["依据所列官方文档编写的 BotClaw 验收方法。未运行产品命令，请核对自己的安装版本。"]},"body":{"introduction":"有用的结果是：一个获准发送者收到一条可追踪回复。从本地对话正常的状态开始，一次只添加一个渠道，便于区分模型故障和消息故障。","sections":[{"heading":"准备和连接","paragraphs":[],"steps":["从当前消息指南选择一个平台，在本地完成凭据配置，不把 token 放进截图或报告。","为测试发送者设置明确白名单，发消息前检查 gateway 实际生效配置。","使用 hermes gateway status 区分服务登记和进程运行，并按系统对应文档启动。","在私人会话发送唯一无害短语，在 gateway 证据中对应收到的消息、会话和回复。"]},{"heading":"验收与拒绝测试","paragraphs":["确认获准发送者在同一渠道收到预期回复。白名单外的第二个测试账户不能获得工具访问。私人路由通过后再测试群聊。分享诊断时隐藏发送者 ID。"]},{"heading":"失败处理","paragraphs":["未收到回复时定位断点：平台接收、gateway 会话、模型响应或向外送达。重试前检查重复 gateway 进程，多进程轮询可能造成间歇故障。结束试用时停止测试 gateway，并只撤销测试凭据。"]}]},"indexable":true,"supersededBy":null,"review":{"state":"current","pendingChanges":0,"policyDays":7}}}