如何将 HappyCapy 接入 Slack：让 AI Agent 赋能每个频道
Socket Mode、完整工具访问权限、按线程记忆——HappyCapy 化身团队在 Slack 中的 AI Agent。
Slack 拥有 3200 万日活跃用户。大多数 Slack 机器人只能回答问题。HappyCapy 的 Slack 集成做的是本质上不同的事情：它能执行任务。当你 @提及它时，它可以编写并运行代码、生成图像、搜索网络、创建文件，并在 Slack 线程内交付完成的结果。无需切换标签页，无需复制粘贴输出结果。只需在此发一条消息，即可得到结果。
架构上的区别
大多数 Slack 集成要求你暴露一个公开的 webhook URL、配置 SSL 证书，并运行一个 Slack 能从互联网访问到的服务器。在你写下第一行业务逻辑代码之前，这就已经是三个基础设施问题。
HappyCapy 使用 Socket Mode。机器人不是让 Slack 主动连接到你的服务器，而是由机器人向 Slack 的基础设施发起出站 WebSocket 连接。无需配置公开 URL，无需管理 SSL 证书，无需开放防火墙规则。你运行这个 skill，它就会连接上，并保持连接状态。
第二个区别在于机器人运行的位置。HappyCapy 运行在一个持久化的 Fly.io Linux 沙箱中——拥有 root 权限、Python 3.11、Node.js v24，始终在线。当你的机器人收到一条消息时，它并不是在启动一个 10 秒就会超时的无服务器函数，而是拥有一个完整可用的环境：持久化文件系统、网络访问、长时间运行的进程。
第三个区别在于它回复的方式。HappyCapy 的每一条回复都会返回到消息发出的同一个 Slack 线程中。频道保持整洁，团队不会被机器人的噪音淹没。每个线程的对话历史都会被存储，并随每条新消息一起转发，因此机器人能在整个会话期间保持上下文——它知道 20 条消息之前讨论过什么。
| 能力 | 典型的 Slack 机器人 | HappyCapy Slack 机器人 |
|---|---|---|
| 需要公开 URL | 是 | 否（Socket Mode） |
| 执行环境 | 无服务器 / 有限 | 始终在线的 Linux 沙箱 |
| 线程上下文 | 通常没有 | 按线程保留历史记录 |
| 能否运行代码 | 否 | 是，完整的 Bash |
| 可用工具 | 固定集成 | 300,000+ Skills |
| AI 模型访问 | 单一模型 | 所有主流模型 |
你能做什么
告诉别人一个 Slack 机器人"拥有完整的工具访问权限"很容易。以下是这在实际中究竟意味着什么。
编写并运行代码，返回结果。 让机器人处理你在频道中放入的一个 CSV 文件，运行一个 Python 分析脚本，并以格式化表格的形式将结果回帖。它会编写代码，在沙箱中运行，并回复输出结果。
在线程中生成图像。 直接从一条 Slack 消息请求一个 AI 生成的产品效果图。机器人调用图像生成功能、上传文件，并将其发布在该线程中——无需离开 Slack 去使用另一个工具。
搜索网络并总结。 让它抓取竞争对手页面上的最新定价，并总结与你自己定价的差异。它会抓取该页面、阅读内容，并以结构化对比的形式回复。
触发 300,000+ Skills 中的任意一个。 HappyCapy 内置了超过 300,000+ 个 Skills——涵盖代码审查、内容生成、数据分析、SEO、市场调研以及数百种其他工作流的专业能力。每一个都可以通过 Slack 消息调用。
使用私信进行私密的 agent 会话。 机器人在私信中的工作方式与在频道中完全相同。与机器人的一次私密 DM 会成为 Slack 内的一个个人 AI 工作空间——拥有对话历史、完整的工具访问权限，且没有旁观者。
从任意频道调用。 无需按频道逐一配置。同时将机器人添加到 #engineering、#marketing 和 #data。每个团队都获得同样完整的能力。
优点
- 无需公开 URL 或基础设施——Socket Mode 负责处理连接
- 在 HappyCapy 沙箱内拥有完整的 Bash 和文件系统访问权限
- 按线程保留的记忆使多轮对话保持连贯
- 可访问所有主流 AI 模型，而不仅仅是一个
- 通过任意 @提及即可使用 300,000+ Skills
- 可在频道、群组私信和一对一私信中使用
- 回复会发送到线程中，保持频道可读性
- 回复没有消息长度限制——结果会完整返回
真实使用场景
工程团队——在 #dev 中进行代码审查和 CI 调试。 一个工程团队将失败的 CI 日志粘贴到线程中并 @提及 HappyCapy。它会读取堆栈跟踪、找出失败的测试、提出修复建议，并写出修正后的代码块。团队在提出问题的同一线程中就能得到一个可供审阅的答案，无需打开另一个标签页或切换上下文。
市场团队——从 Slack 生成内容。 一位市场经理将产品功能列表放入线程中，并要求 HappyCapy 撰写五篇 LinkedIn 帖子草稿。它会在同一线程中返回这些草稿，并按角度打上标签（教育型、挑动型、故事驱动型）。经理挑选其中一篇，要求进行修改，最终得到一篇可以安排发布的成品帖子——全部在 Slack 线程中完成。
独立创始人——在私信中作为个人助理。 一位创始人将 HappyCapy 的私信当作自己的操作系统来使用。早间简报：让它总结关于某竞争对手的隔夜新闻。通话前准备：让它拉取该公司近期的融资历史。会后：粘贴笔记并要求生成结构化的行动清单。按线程保留的历史记录意味着上周对话中的上下文在本周的线程中被引用时依然可用。
数据团队——在 #data 中快速编写分析脚本。 一位数据分析师描述他们需要对某个数据集执行的转换操作，并 @提及机器人。HappyCapy 编写 pandas 脚本，在回复中确认逻辑，分析师直接复制使用。对于希望机器人针对他们上传的文件运行脚本的团队，它同样能胜任——全程在线程内端到端完成。
如何设置
设置大约需要五分钟。完整的 skill 可在 github.com/ndpvt-web/happycapy-slack 获取。
高层步骤如下：
1. 创建一个 Slack app。 前往 api.slack.com/apps 并创建一个新 app。选择 "From scratch"。为其命名并选择你的工作区。
2. 启用 Socket Mode。 在 "Settings → Socket Mode" 下，打开该开关。Slack 会生成一个具有 connections:write 权限范围的 App-Level Token。复制它——你需要将其作为 SLACK_APP_TOKEN 使用。
3. 添加 bot 权限范围。 在 "OAuth & Permissions → Bot Token Scopes" 下，添加：app_mentions:read、chat:write、channels:history、groups:history、im:history、mpim:history、channels:read、groups:read、im:read、files:write。
4. 启用事件订阅。 在 "Event Subscriptions" 下，启用它并订阅以下 bot 事件：app_mention、message.im。
5. 安装该 app。 在 "OAuth & Permissions" 下，将该 app 安装到你的工作区。复制 Bot User OAuth Token 作为 SLACK_BOT_TOKEN。
6. 运行该 skill。 在你的 HappyCapy 沙箱中，将 SLACK_BOT_TOKEN 和 SLACK_APP_TOKEN 设置为环境变量，并运行 Slack skill。机器人会通过 Socket Mode 建立连接，并立即开始监听。
无需服务器部署，无需域名，无需 SSL。HappyCapy 沙箱会处理好一切——如果你想改为在自己的机器上运行，在 Mac Mini 上作为持久化服务器的设置方式也完全相同（关于持久化本地设置的完整背景，请参见 Mac Mini as an AI Server in 2026）。
常见问题
我需要付费的 Slack 套餐吗？ 不需要。Socket Mode 以及所需的 bot 权限范围在 Slack 的免费套餐中即可使用。你可以在一个免费工作区中设置并运行 HappyCapy Slack 机器人，没有任何限制。
它在私信和频道中都能用吗？ 是的。机器人会响应公开频道、私有频道、群组私信以及一对一私信中的 @提及。在所有场景下行为都完全相同——拥有完整的工具访问权限和按线程保留的历史记录。
在一个频道中多个用户之间，对话上下文是如何运作的？ 上下文是按线程划分的。如果多名团队成员在同一线程中与机器人对话，完整的线程历史会随每条消息一起发送，因此机器人能看到全部内容。如果同一个频道中同时运行着两个独立的线程，each 各自拥有独立隔离的历史记录。用户无法看到或影响彼此各自独立的线程。
我可以限制哪些频道或用户可以调用该机器人吗？ 可以。该 skill 支持频道 ID 和用户 ID 的白名单。不在名单上的频道或用户发出的消息会被静默忽略。默认情况下，机器人会响应它能看到的所有内容，因此添加限制只是一步配置更改。
该机器人需要公开 URL 吗？ 不需要。这正是其核心架构优势所在。Socket Mode 意味着机器人向 Slack 发起出站 WebSocket 连接——Slack 永远不需要连接到你的服务器。不需要公开 URL，不需要 SSL 证书，也不需要任何防火墙配置。
如果我在一个线程中 @提及它——它能看到之前的消息吗？ 是的。当你在一个线程中 @提及 HappyCapy 时，该 skill 会从 Slack 的 API 获取完整的线程历史，并将其包含在发送给机器人的上下文中。它能看到该线程从头开始的每一条消息，因此对你的请求拥有完整的上下文。
我的整个团队可以共用一个 HappyCapy 机器人吗？ 可以。一个机器人 token 可在你工作区的每个频道和私信中通用。你的整个团队可以同时 @提及同一个机器人。每个线程都维护自己的上下文，因此多名团队成员的并发使用不会导致上下文混淆。
结语
大多数 Slack 集成止步于检索——它们能查找信息，但无法采取行动。HappyCapy 的 Slack skill 跨越了这条界限。它将完整的执行环境——文件系统、Bash、所有主流 AI 模型、300,000+ Skills——直接带入你团队现有的沟通层。其结果是一个生活在团队日常工作场所中的 AI agent，无需任何人切换到另一个独立工具。
