卤虫机器人
你的AI代理需要一个电话号码。就是不和谐。
](https://www.npmjs.com/package/@anthony-maio/halobot)   
一个开源的MCP服务器,为任何AI代理提供Discord通信通道。 客服人员会问问题,等待您的回复,并继续工作——无论是在您的手机、桌面还是其他任何地方。
H人类-A.根特 L面向对象编程 哦版本 B过载
______________________________________________________________________
问题
你的代理已经花了三个小时完成重构任务。它满足了一个模糊的要求。它猜测。它选择了错误的解释。它基于一个错误的假设构建了400条线。你回来,看到混乱,然后重新开始。
克劳德代码有调度。Cursor有自己的通知系统。每一个人工智能工具都重塑了“与人类对话”
halobot是MCP的答案: 一个Discord服务器,任何代理,零供应商锁定。
| 没有halobot | 有halobot |
|---|---|
| 代理猜测不明确的要求 | 代理问,你回答,工作继续 |
| 几小时后你发现了错误 | 从你的手机、桌面或任何地方回复 |
| 在IDE之外无法联系到您 | 适用于任何MCP客户端 |
| 每个工具都构建自己的通知系统 | 一个协议,每个代理 |
| 3个您未批准的AM部署 | 关键操作的明确批准门 |
快速开始
# Install globally
npm install -g @anthony-maio/halobot
# Interactive setup -- walks you through everything
halobot setup就是这样。安装向导将您链接到Discord开发人员门户,生成邀请URL,收集您的ID,验证所有内容,并可选择自动配置Claude Code。
# Check your setup
halobot doctor
# Check setup and send a test message
halobot doctor --test运作原理
+--------------+ STDIO/MCP +------------------+ Discord API +--------------+
| Any Agent || halobot || Discord |
| (Claude Code,| | MCP Server | create thread | Server |
| Cursor, | 11 MCP | | post message | |
| Codex, | tools | Discord Bot | wait for reply| You |
| custom) | | | | |
+--------------+ +------------------+ +--------------+- 客服电话
send_and_wait--bot创建了一个Discord线程,向您发送ping消息 - 您在帖子中回复(电话、桌面、任何地方)
- 代理收到您的回复并继续工作
- 长消息自动分块超过Discord的2000个字符限制
MCP工具
高层对话
| 工具 | 它做什么 |
|---|---|
send_thread_message | 通过Discord线程发送消息。创建新的或继续存在。 |
wait_for_reply | 轮询线程以获取人工回复(可配置超时)。 |
send_and_wait | 发送+等待一个电话。最适合简单的问答 |
list_conversations | 列出所有活动线程对话。 |
get_thread_messages | 从线程中获取完整的消息历史记录。 |
低级--原始Discord访问
| 工具 | 它做什么 |
|---|---|
list_guilds | 列出机器人所在的所有服务器 |
list_channels | 列出公会中的文本频道。 |
send_message | 向任何频道发送消息。 |
read_messages | 从内存缓存中读取最近的消息。 |
get_channel_history | 通过API获取分页消息历史记录。 |
wait_for_message | 轮询,直到匹配的消息到达(关键字过滤器)。 |
用例
决策点 --代理遇到一个不明确的要求,询问采用哪种方法。您通过手机回复“选项2”。
审批门 --代理到达部署步骤,等待您明确的“开始”后再继续。不再部署凌晨3点。
进度更新 --代理在线程工作时向其发布状态。您可以在方便的时候办理入住手续。
多智能体协调 --多个代理,每个代理都有自己的线程,都到达同一个人。你是中心。
协同调试 --代理发布它尝试过的内容,询问你的直觉,然后再试一次。异步配对编程。
配置
克劳德代码(CLI)
claude mcp add halobot \
-e DISCORD_BOT_TOKEN=your-token \
-e DISCORD_CHANNEL_ID=your-channel-id \
-e DISCORD_ALLOWED_USERS=your-user-id \
-- halobot克劳德桌面(claude_desktop_config.json)
{
"mcpServers": {
"halobot": {
"command": "halobot",
"env": {
"DISCORD_BOT_TOKEN": "your-token",
"DISCORD_CHANNEL_ID": "your-channel-id",
"DISCORD_ALLOWED_USERS": "your-user-id"
}
}
}
}任何MCP客户端
halobot通过STDIO使用标准MCP。如果您的客户端支持MCP,则它支持halobot。
查找ID: 在Discord设置中启用开发人员模式->右键单击通道/用户->复制ID。
安全
- 执行白名单。 基于线程的工具仅对以下用户做出响应
DISCORD_ALLOWED_USERS. - 螺纹隔离。 每个代理对话都有自己的线索。没有相声。
- 没有入站命令。 机器人不接受Discord的任意命令。
- 低级工具不受限制 --他们可以访问机器人可以看到的任何频道。使用基于线程的工具来控制流。
发展
# Run tests (no live Discord connection required)
npm test
# Dev mode with hot-reload
npm run dev
# TypeScript watch
npx tsc --watch路线图
- \[\]用于远程/多代理访问的SSE传输
- \[\]通过线程支持文件/图像附件
- \[\]基于反应的快速响应
- \[\]服务器重启后的持续对话状态
- \[\]每个代理人的费率限制
- \[\]用于基于推送的回复的Webhook模式(无轮询)
许可证
ISC
______________________________________________________________________
由...建造 安东尼 梅奥
