dialogbrain

DialogBrain for Claude Code

将 WhatsApp、Telegram、电子邮件和网站聊天接入同一个收件箱，并直接在 Claude Code 中构建 AI Agent，为客户提供回复。

DialogBrain 是一个客户消息平台：所有渠道都会汇入同一个共享收件箱，并提供联系人、通话、任务看板和 AI Agent。这个插件通过工具将工作区接入 Claude Code，还提供六项技能，熟悉各项设置任务的操作顺序。

安装

claude plugin marketplace add saloprj/dialogbrain-claude-plugin
claude plugin install dialogbrain@dialogbrain

然后在 Claude Code 中运行 /mcp，并在浏览器中登录 DialogBrain。无需复制 API 密钥；插件在你登录的工作区中能执行的操作，与你的账号本身完全相同。

可以这样提问

连接我的 WhatsApp 和工作邮箱。

在 example.com 上添加聊天小组件。只允许我的域名，
并将回复保留为草稿，由我审核。

创建一个能在 WhatsApp 和网站聊天中回复客户的 Agent。
绝不承诺价格。先测试，再让它回复任何人。

这周我们在哪些环节流失了潜在客户？

技能的作用

用日常语言提问；只有匹配的技能才会自动加载。

• connect-channel — “连接我的 WhatsApp / 电子邮件 / Telegram 机器人”： 无需登录的渠道（IMAP 邮箱、机器人令牌）可直接通过聊天连接；其他渠道则会向你发送一个链接，打开对应的设置页面。
• setup-livechat-widget — “在我的网站上添加聊天小组件”：创建小组件，将其限制为仅在你的域名上使用，提供两段脚本标签，并检查 Agent 是否能回复。
• create-agent — “创建一个能回复客户的 Agent”：根据描述编写 Agent、配置触发条件、发送测试消息并查看执行跟踪。
• voice-agent — “创建一个电话 Agent”：创建 Agent、设置语音，并给你打电话进行测试。
• tasks-board — 工作区任务看板：将任务分配给人员或 Agent，跟踪逾期事项，并附上截图发表评论。
• lead-report — “这周我们在哪些环节流失了潜在客户”：查询分析数据、查看对话，并撰写一份摘要。
• react-to-events — “这个人发消息时告诉我”“监控这个群组”“每有新潜在客户就通知我”：将触发条件缩小到你关心的消息，然后选择后续操作——回复、给你留言、由人工接管，或在看板上创建任务。

让 DialogBrain 联系你（尚未对所有人开放）

此插件还附带一个通道服务，因此 DialogBrain Agent 可以将工作交给当前会话，而不是自行作答——例如一个值得评估的新潜在客户，或一项通过手机分配的任务。

尝试前请先阅读。 向 Claude Code 会话推送消息是一项实验性功能，有两项门槛并非我们能够开放：

• 你的账户必须启用 Channels 功能；
• 通道必须获得批准。批准来自 Claude Code 自带的允许列表，或组织的托管设置。未列入其中的插件会被拒绝，除非启动会话时使用 --dangerously-load-development-channels，但该参数仅用于本地开发。

因此，安装插件并不意味着你就能使用这项功能。安装后你可以使用工具、技能和 Agent，它们完全不需要任何标志。如果按照以下步骤操作后，Claude Code 提示通道「不在已批准的通道允许列表中」，这就是门槛所致，并非你的操作有误，而且插件无法绕过它。

你还需要进行设置，否则不会发生任何事情：没有 API 密钥时，通道会保持关闭，不会影响会话，插件的工具也会照常工作。

需要 PATH 中有 Node.js 20 或更高版本——作为独立二进制文件安装的 Claude Code 不会附带 Node.js。如果没有，通道将永远不会启动，而且唯一的迹象是会话自身的 MCP 日志中出现启动错误，因此请先检查 node --version。

1. 为插件提供 API 密钥（cabinet → Settings → Developer）和这台机器的名称。安装插件时，Claude 会询问这两项信息；密钥的存储方式与客户端存储机密的方式相同——不会写入此代码库或 shell 配置文件。

   如果你是从检出目录安装，同样的两个值也可以写入 ~/.claude/channels/dialogbrain/.env，当插件未提供值时，通道会读取该文件：

   DIALOGBRAIN_TOKEN=<your key>
   DIALOGBRAIN_CHANNEL_NAME=<a name you will recognise>
   

2. 启动 Claude Code 并启用推送——默认情况下，入站推送处于关闭状态，运行中的会话无法开启此功能。在你自己的计算机上，如果该通道尚未列入 Claude Code 的已批准列表，请使用开发标志（它会接收插件条目）：

   claude --dangerously-load-development-channels plugin:dialogbrain@dialogbrain
   # the same session again, keeping its id:
   claude --resume <session id> --dangerously-load-development-channels plugin:dialogbrain@dialogbrain
   

   如果管理员已在托管设置中批准该插件，使用简写形式即可：claude --channels plugin:dialogbrain@dialogbrain。如果未获批准，简写形式会被拒绝（「不在已批准的通道允许列表中」）。只需在 /etc/claude-code/managed-settings.json 中配置一次批准：

   { "channelsEnabled": true,
     "allowedChannelPlugins": [{ "plugin": "dialogbrain", "marketplace": "dialogbrain" }] }
   

3. 直接用文字提出请求：「有新潜在客户到达时在这里提醒我」。react-to-events 技能会完成其余设置。

通道名称只能放在一个标志中。如果同时在 --channels 和 --dangerously-load-development-channels 中列出该通道，就会注册两次——一次没有开发标记——检查会因未标记的那一项而失败，并拒绝整个配置。

每个会话只使用一个 DialogBrain 通道：如果项目的 .mcp.json 中也配置了手动设置的 dialogbrain-channel，请将其移除。两个通道会分别注册，可能使用不同的键，工作可能会被发送到 Claude Code 未在监听的那个通道。

只有来自对话另一方的消息才会触发推送。已连接账户发给自己的消息属于发出消息，不会触发任何提醒。

如果没有收到消息，请询问 DialogBrain 它能看到哪些会话。会话出现在列表中，只能证明通道服务已连接到服务器：无论 Claude Code 是否愿意传递消息，它都会打开套接字。会话自身的 MCP 日志才是可靠的依据——它会显示「Channel notifications registered」或说明未注册的原因。

频道会向我们发送什么，以及何时发送

频道服务是此插件中唯一会主动与外部通信的部分；在你提供 API 密钥之前，它会保持静默：没有密钥时，它只会输出一行内容，不会连接任何服务。

提供密钥后，它会通过 WebSocket 连接到该密钥所属的 DialogBrain 服务——除非你指定其他地址，否则为 https://api.dialogbrain.com——并介绍当前会话，让其他人可以按名称将工作分配给这台机器。每次重新连接时都会重复发送以下介绍：

• 你为这台机器选择的名称；如果没有选择，则为 hostname:project-folder
• Claude Code 会话 ID、项目目录、工作目录、主机名和进程 ID
• 启动会话的 Claude Code 入口点，以及它使用的子 Agent 模型
• 项目目录当前的 git 分支
• 会话的一行标题：会话摘要，或你输入的第一条内容，最多截取 120 个字符

最后一行可以让你在多个会话列表中识别出对应的桌面，也是唯一会离开你机器的会话内容。不会读取或发送其他任何内容：不会读取你的文件、对话或输出。介绍之后的所有内容都会反向传输——客户发送给你的消息会推送到会话中。

如果你通过目录安装，密钥会由 Claude Code 存储；如果你从代码库检出后安装，密钥会存储在 ~/.claude/channels/dialogbrain/.env 中。密钥只会作为请求头发送给它所属的服务。

可连接的频道

WhatsApp、Telegram、Telegram 机器人、Instagram、Facebook Messenger、通过 IMAP 或 Google 收取的电子邮件、网站上的聊天小组件，以及用于语音通话的电话号码。

它不会做什么

连接 WhatsApp 时，需要用拥有该号码的手机扫描二维码，和使用 WhatsApp Web 一样。助手不应代你完成这一步，因此它不会尝试代办：它会向你发送一个链接，打开 DialogBrain 后即可完成这一步。连接邮箱时，它会要求你提供应用专用密码，而不是主密码；你可以随时撤销该密码。在你决定允许 Agent 自行回复之前，它的回复都会以草稿形式等待。

仅使用服务，不安装技能

claude mcp add --transport http dialogbrain https://api.dialogbrain.com/mcp/

同一地址也适用于 ChatGPT、Claude、Cursor、Codex、Gemini CLI 和任何其他 MCP 客户端，并支持通过 OAuth 登录： https://dialogbrain.com/help/set-up-from-ai-assistant

要求

需要 DialogBrain 账户（dialogbrain.com）和 Claude Code。新工作区可免费试用，因此你可以先连接频道并测试 Agent，再决定是否付费。

采用 MIT 许可证。此代码库在每次发布时都会从 DialogBrain 单体代码库同步发布；更改应在该代码库中进行，而不是在这里。