配置 — 工作区聊天频道
工作场所聊天渠道的 channels.* 配置键:Google Chat、Slack、Mattermost 和 Microsoft Teams。
Google Chat¶
{
channels: {
googlechat: {
enabled: true,
serviceAccountFile: "/path/to/service-account.json",
audienceType: "app-url", // app-url | project-number
audience: "https://gateway.example.com/googlechat",
webhookPath: "/googlechat",
botUser: "users/1234567890",
dmPolicy: "pairing",
allowFrom: ["users/1234567890"],
groupPolicy: "allowlist",
groups: {
"spaces/AAAA": { enabled: true, requireMention: true },
},
typingIndicator: "message",
mediaMaxMb: 20,
},
},
}
- 服务账号 JSON:内联(
serviceAccount)或基于文件(serviceAccountFile)。 serviceAccount可直接接受 SecretRef。- 环境变量回退:
GOOGLE_CHAT_SERVICE_ACCOUNT或GOOGLE_CHAT_SERVICE_ACCOUNT_FILE(仅默认账号)。 - 使用
spaces/<spaceId>或users/<userId>作为投递目标。 channels.googlechat.dangerouslyAllowNameMatching重新启用可变的电子邮件主体匹配(break-glass 应急兼容模式)。
Slack¶
{
channels: {
slack: {
enabled: true,
botToken: "xoxb-...",
appToken: "xapp-...",
dmPolicy: "pairing",
allowFrom: ["U123", "U456", "*"],
dm: { enabled: true, groupEnabled: false, groupChannels: ["G123"] },
channels: {
C123: { enabled: true, requireMention: true },
C456: {
enabled: true,
requireMention: true,
allowBots: false,
users: ["U123"],
skills: ["docs"],
systemPrompt: "Short answers only.",
},
},
historyLimit: 50,
allowBots: true,
reactionNotifications: "own",
reactionAllowlist: ["U123"],
replyToMode: "off", // off | first | all | batched
thread: {
historyScope: "thread", // thread | channel
inheritParent: false,
initialHistoryLimit: 20,
},
actions: {
reactions: true,
messages: true,
pins: true,
memberInfo: true,
emojiList: true,
},
slashCommand: {
enabled: true,
name: "openclaw",
sessionPrefix: "slack:slash",
ephemeral: true,
},
typingReaction: "hourglass_flowing_sand",
unfurlLinks: false,
unfurlMedia: false,
textChunkLimit: 4000,
streaming: {
mode: "partial", // off | partial | block | progress
chunkMode: "length", // length | newline
nativeTransport: true, // use Slack native streaming API when mode=partial
},
mediaMaxMb: 20,
execApprovals: {
enabled: "auto", // true | false | "auto"
approvers: ["U123"],
agentFilter: ["default"],
sessionFilter: ["slack:"],
target: "dm", // dm | channel | both
},
},
},
}
- Socket 模式需要同时提供
botToken和appToken(默认账号的环境变量回退为SLACK_BOT_TOKEN+SLACK_APP_TOKEN)。 - HTTP 模式需要
botToken以及signingSecret(在根级别或按账号设置)。 allowBots默认值为true,用于控制其他机器人是否可以触发对话轮次。显式设置为false仍然是一种退出机制;房间设置会覆盖账号和根级别设置。常规访问、提及、机器人房间授权、自我消息过滤和机器人循环防护仍然适用。机器人编写的历史消息和线程上下文仍然受上下文可见性规则约束,不受此标志影响。参见 Slack 访问控制。channels.slack.joinIntro默认值为true。当机器人加入被允许的频道时,它会使用频道名称、用途或主题以及可用的近期消息发布一条介绍。将此选项设置为false可禁用介绍,或使用channels.slack.accounts.<accountId>.joinIntro进行按账号的覆盖。每个频道最多读取 100 条近期消息,仅读取一次;参见 群组加入介绍。介绍永远不会在私信中运行。- 用户身份(
postAs: "user")以授权用户的身份发布和读取消息。在 Socket 模式下需要userToken和appToken,在 HTTP 模式下需要userToken和signingSecret。无需机器人令牌或机器人用户。有关用户范围和事件订阅的信息,请参见 用户身份。 - Slack 会通过
auth.test从机器人令牌自动检测 Enterprise Grid 组织级安装;无需设置安装模式。企业级私信支持disabled、open、allowlist和工作区范围的pairing。频道策略要求使用team:<team-id>:channel:<channel-id>。用户策略接受组织级稳定用户 ID 或工作区范围的team:<team-id>:user:<user-id>。可变名称和不支持的频道前缀会导致启动失败。提及模式的频道作用域和静态路由绑定对端使用工作区限定的 Slack 目标。支持来自工作区限定轮次的直接 Socket 模式或 HTTP 消息、提及、工作区限定操作、延迟投递、主动发送、受支持的事件监听器和交互、静态路由绑定以及 Slack 原生审批。中继(Relay)、频道 ID 变更事件、App Home、Agent 和 Assistant 生命周期事件、已配置的 ACP 绑定以及运行时当前对话绑定仍不可用。有关最小权限清单、设置工作流和完整限制,请参见 Enterprise Grid 组织级安装。 - 已废弃的
enterpriseOrgInstall键由openclaw doctor --fix在 Slack 根级别和账号级别移除。 botToken、appToken、signingSecret和userToken接受纯文本字符串或 SecretRef 对象。- Slack 账号快照会暴露每个凭据的来源/状态字段,例如
botTokenSource、botTokenStatus、userTokenSource、userTokenStatus、appTokenStatus,以及在 HTTP 模式下的signingSecretStatus。configured_unavailable表示该账号已通过 SecretRef 配置,但当前命令/运行时路径无法解析密钥值。 configWrites: false会阻止 Slack 发起的配置写入。- 可选的
channels.slack.defaultAccount在匹配到已配置的账号 ID 时,会覆盖默认账号的选择。 dm.groupEnabled和dm.groupChannels仅过滤应用已加入的 Slack 群组私信(MPDM)。它们无法让应用看到其从未加入的现有群组私信;请将群组私信转换为私密频道并邀请应用,或让应用通过conversations.open打开新的 MPDM。参见 群组私信(MPDM)和机器人。channels.slack.streaming.mode是 Slack 流模式的规范键(默认值为"progress")。channels.slack.streaming.nativeTransport控制 Slack 的原生流式传输(默认值为true)。旧的streamMode、布尔值streaming、chunkMode、blockStreaming、blockStreamingCoalesce和nativeStreaming值在运行时不再被读取;请运行openclaw doctor --fix将持久化配置迁移到streaming.{mode,chunkMode,block.enabled,block.coalesce,nativeTransport}。unfurlLinks和unfurlMedia会将 Slack 的chat.postMessage链接和媒体展开(unfurl)布尔值透传到机器人回复中。unfurlLinks默认值为false,因此除非启用,否则机器人发出的出站链接不会内联展开;unfurlMedia默认省略,仅在配置后才会传递。可在channels.slack.accounts.<accountId>级别设置这两个值,以覆盖单个账号的顶层值。- 使用
user:<id>(私信)或channel:<id>作为投递目标。
反应通知模式: off、own(默认)、all、allowlist(来自 reactionAllowlist)。
线程会话隔离: thread.historyScope 为按线程(默认)或跨频道共享。thread.inheritParent 将父频道转录复制到新线程。thread.initialHistoryLimit(默认 20)限制新线程会话启动时获取多少条现有线程消息;0 禁用线程历史获取。
- Slack 原生流式传输以及 Slack 助手风格的“正在输入...”线程状态需要一个回复线程目标。对于没有回复线程的默认
progress轮次(包括普通顶层私信),仅发布最终答案。设置streaming.progress.style、设置streaming.progress.toolProgress,或设置streaming.progress.nativeTaskCards: false会选择预览。线程轮次、Agent View、Assistant View 以及显式off/partial/block模式保留其行为。参见 Slack 消息行为。 typingReaction在回复运行期间为传入的 Slack 消息添加临时反应,完成后移除。对于安静的顶层进度轮次,默认为"hourglass_flowing_sand";已配置的快捷代码会覆盖它,""禁用它。channels.slack.execApprovals:Slack 原生审批客户端投递和执行审批人授权。与 Discord 相同的架构:enabled(true/false/"auto")、approvers(Slack 用户 ID)、agentFilter、sessionFilter和target("dm"、"channel"或"both")。当 Slack 插件审批人可解析时,插件审批可使用此原生客户端路径处理来自 Slack 的请求;对于来自 Slack 的会话或 Slack 目标,也可以通过approvals.plugin启用 Slack 原生插件审批投递。插件审批在设置时使用approvals.plugin.slack审阅者列表;当省略默认列表时,回退到 Slack 账户allowFrom和默认路由。它们不使用执行审批人。- 有效的非空
approvals.plugin.slack审阅者列表会独立于channels.slack.execApprovals和插件转发启用 Slack 原生插件审批投递。
| 操作组 | 默认 | 说明 |
|---|---|---|
| reactions | enabled | 添加反应 + 列出反应 |
| messages | enabled | 读取/发送/编辑/删除 |
| pins | enabled | 固定/取消固定/列出 |
| memberInfo | enabled | 成员信息 |
| emojiList | enabled | 列出自定义表情 |
Mattermost¶
Mattermost 作为独立插件安装,方式与 Discord、Slack 和 WhatsApp 相同:
在固定版本之前,请查看 npmjs.com/package/@openclaw/mattermost 的当前 dist-tags。
{
channels: {
mattermost: {
enabled: true,
botToken: "mm-token",
baseUrl: "https://chat.example.com",
dmPolicy: "pairing",
chatmode: "oncall", // oncall | onmessage | onchar
oncharPrefixes: [">", "!"],
groups: {
"*": { requireMention: true },
"team-channel-id": { requireMention: false },
},
commands: {
native: true, // opt-in
nativeSkills: true,
callbackPath: "/api/channels/mattermost/command",
// Optional explicit URL for reverse-proxy/public deployments
callbackUrl: "https://gateway.example.com/api/channels/mattermost/command",
},
textChunkLimit: 4000,
streaming: { chunkMode: "length" },
},
},
}
聊天模式:oncall(在 @提及 时响应,默认)、onmessage(每条消息)、onchar(以触发前缀开头的消息)。
启用 Mattermost 原生命令时:
commands.callbackPath必须是路径(例如/api/channels/mattermost/command),而不是完整 URL。commands.callbackUrl必须解析到 OpenClaw 网关端点,并且可从 Mattermost 服务器访问。- 原生斜杠回调使用 Mattermost 在斜杠命令注册期间返回的每个命令令牌进行身份验证。如果注册失败或未激活
任何命令,OpenClaw 会以
Unauthorized: invalid command token.拒绝回调。 - 对于私有/tailnet/内部回调主机,Mattermost 可能要求
ServiceSettings.AllowedUntrustedInternalConnections包含回调主机/域名。 使用主机/域名值,而不是完整 URL。 channels.mattermost.configWrites:允许或拒绝由 Mattermost 发起的配置写入。channels.mattermost.requireMention:在频道中回复前要求@mention。channels.mattermost.groups.<channelId>.requireMention:按频道的提及门控覆盖("*"表示默认)。- 可选的
channels.mattermost.defaultAccount在匹配已配置的账户 id 时覆盖默认账户选择。
Microsoft Teams¶
Microsoft Teams 由插件支持,并在 channels.msteams 下配置。
{
channels: {
msteams: {
enabled: true,
configWrites: true,
// appId, appPassword, tenantId, webhook, team/channel policies:
// see /channels/msteams
},
},
}
- 此处涵盖的核心键路径:
channels.msteams、channels.msteams.configWrites。 - 完整的 Teams 配置(凭据、webhook、DM/群组策略、按团队/按频道覆盖)记录在 Microsoft Teams 中。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw