ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

群聊高级配置实战:openclaw-lark 按群白名单、技能绑定与自定义系统提示词设置指南

群聊高级配置实战:openclaw-lark 按群白名单、技能绑定与自定义系统提示词设置指南 群聊高级配置实战openclaw-lark 按群白名单、技能绑定与自定义系统提示词设置指南【免费下载链接】openclaw-lark飞书官方出品的 OpenClaw 飞书/Lark Channel 插件项目地址: https://gitcode.com/gh_mirrors/op/openclaw-larkopenclaw-lark 是飞书/Lark 官方出品的 OpenClaw 渠道插件可把你的 AI Agent 接入飞书工作区读写消息、文档、多维表格、日历与任务。当你把机器人拉进群聊后是否遇到这些问题谁都能 它、所有群的机器人一模一样通过 openclaw-lark 的按群白名单、技能绑定与自定义系统提示词配置你可以精细控制谁能和机器人说话、每个群允许它用哪些技能、机器人在不同群里的行为方式。本文带你用 3 步完成群聊高级配置。先了解配置在哪里、优先级如何所有群聊配置都写在 OpenClaw 的飞书渠道配置里按账号级全局 →*默认群 → 具体群 ID逐层覆盖。优先级规则为具体群配置 *默认群配置 账号全局配置 内置默认值这套查找逻辑的实现在 src/messaging/inbound/gate.ts 与 src/messaging/inbound/policy.ts群配置按群 ID 不区分大小写匹配。每个群支持的完整字段定义在 src/core/config-schema.ts 的FeishuGroupSchema中。 建议习惯把所有群通用的设置放在*条目里只对个别群做差异覆盖配置最省。第一步设置按群白名单控制谁能和机器人说话群聊访问控制由groupPolicy字段驱动共 3 种模式判定逻辑见 src/messaging/inbound/policy.ts 的isFeishuGroupAllowed取值效果适用场景open所有群/所有发送者放行内部小群、完全信任的环境allowlist仅白名单中的发送者可触发团队群、需要管控的共享群disabled完全屏蔽群聊临时关闭群聊能力白名单的两种写法账号级groupAllowFrom列出允许的发送者 ID以oc_开头的旧式群会话 ID 会被自动识别为允许的群实现兼容拆分见 src/messaging/inbound/policy.ts。群级在groups.群ID.allowFrom中列出该群内允许触发的发送者可与群内其他限制叠加。典型配置示例{ groupPolicy: allowlist, groupAllowFrom: [ou_xxxxxxxx, ou_yyyyyyyy], groups: { *: { requireMention: true }, oc_11112222: { allowFrom: [ou_zzzzzzzz] } } }⚠️ 白名单按**发送者 open_idou_开头**匹配且为空时默认全部拒绝想对所有人放行请用open模式而不是留空列表。另外两个常用配合项requireMention群内必须 机器人才响应默认开启可按群覆盖判定在 src/messaging/inbound/gate.tsrespondToMentionAll所有人时是否也触发机器人。第二步按群绑定技能让不同群拥有不同能力skills字段是一个技能名数组用于限定这个群里的机器人可以调用哪些技能。解析发生在消息分发阶段src/messaging/inbound/dispatch.ts并与 Agent 级技能白名单取交集——两边都配置时技能必须同时出现在两个列表才生效合并规则见 src/core/agent-config.ts 的mergeSkillFilters{ groups: { oc_88889999: { skills: [feishu-calendar, feishu-task] }, oc_77778888: { skills: [feishu-bitable] } } }场景举例项目管理群只开放日历与任务技能数据群只开放多维表格技能。这样即使机器人被拉进多个群每个群的能力边界都清晰可控。 群内工具Tools还可以用tools.allow/tools.deny做更细粒度的开关支持feishu_calendar_*这类前缀通配符匹配逻辑见 src/core/agent-config.ts提取链路在 src/messaging/inbound/policy.ts。第三步为每个群写自定义系统提示词systemPrompt字段可以为群注入一段专属人设说明。机器人收到群消息时插件会把这段提示词与内置的群聊协作指引合并后一起注入src/messaging/inbound/dispatch.ts合并函数在 src/messaging/inbound/dispatch-builders.ts从而改变模型在该群的回答风格与行为约束{ groups: { oc_66667777: { systemPrompt: 你是在客服群里的助手回答简洁先给结论再给步骤不确定的信息请明确说明不要调用写文档类技能。 }, oc_55556666: { systemPrompt: 你是在开发群里的助手输出面向工程师多给命令与代码位置可直接引用仓库路径。 } } }写提示词的小技巧说清角色定位 输出风格 能力边界三件事即可无需长篇大论未配置systemPrompt的群会自动回落到*默认群的提示词。群配置字段速查表字段作用备注groupPolicy群聊访问总开关open/allowlist/disabled可全局或按群设置allowFrom/groupAllowFrom发送者白名单ou_ID空列表 全部拒绝requireMention群内是否必须 机器人默认开启skills该群可用的技能白名单与 Agent 级取交集tools.allow/tools.deny群内工具级开关支持*前缀通配systemPrompt群级自定义系统提示词与内置群聊指引合并注入enabled按群启用/停用快速下线单个群allowBots是否响应其他机器人消息true/mentions/falsereplyInThread机器人回复是否留在话题内按群覆盖账号级默认值常见排查机器人为什么在群里不响应模式不对确认groupPolicy是否为disabled或allowlist模式下发送者 ID 不在白名单中匹配是精确的 ID 匹配见 src/messaging/inbound/policy.ts。没 机器人群内默认要求触发且所有人默认不触发。技能消失检查群skills与 Agent 级技能配置是否取交集后为空。群 ID 写错groups的 key 是飞书群会话 IDoc_开头支持不区分大小写匹配但拼错前缀就不会命中。 安全提示官方建议将接入 OpenClaw 的飞书机器人作为私聊助手使用。把机器人放进群聊并放开白名单意味着更多用户可间接驱动 AI 执行操作请只对你信任的群和成员开放。小结openclaw-lark 的群聊高级配置只有三件事用groupPolicyallowFrom管住谁能说话用skills管住每个群能用哪些技能用systemPrompt管住机器人在每个群怎么说话。借助具体群 *默认群 全局的优先级模型几行配置就能让同一个机器人在不同群里表现出完全不同的行为。完整字段定义可参考 src/core/config-schema.ts。【免费下载链接】openclaw-lark飞书官方出品的 OpenClaw 飞书/Lark Channel 插件项目地址: https://gitcode.com/gh_mirrors/op/openclaw-lark创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表