# SlackBot 代理一种 TypeScript CLI 工具，使 AI 代理和人类能够使用机器人令牌 (xoxb-) 与 Slack 工作区进行交互。与从桌面应用程序中提取用户令牌的agent-slack不同，agent-slackbot使用标准Slack Bot令牌进行服务器端和CI/CD集成。 ## 快速入门 # 设置你的机器人令牌代理 slackbot 身份验证设置 xoxb-your-bot-token # 或者设置自定义机器人标识符以进行多机器人设置 agent-slackbot auth set xoxb-your-bot-token --bot deploy --name“部署机器人” # 验证身份验证代理 slackbot 身份验证状态 # 发送消息 agent-slackbot 消息发送 C0ACZKTDDC0 “Hello from bot!” # 列出频道代理 slackbot 频道列表 ## 身份验证 ### 机器人令牌设置 agent-slackbot 使用 Slack Bot 令牌 (xoxb-)，您可以从 Slack 应用程序配置中获取该令牌： # 设置机器人令牌（保存前根据 Slack API 进行验证）代理 slackbot 身份验证设置 xoxb-your-bot-token # 设置自定义机器人标识符 agent-slackbot auth set xoxb-your-bot-token --bot deploy --name“部署机器人” # 检查授权状态代理 slackbot 身份验证状态 # 清除存储的凭据代理 slackbot 身份验证清除 ### 多机器人管理存储多个机器人令牌并在它们之间切换： # 添加多个机器人 agent-slackbot auth set xoxb-deploy-token --bot deploy --name“部署机器人” agent-slackbot auth set xoxb-alert-token --bot Alert --name "Alert Bot" # 列出所有存储的机器人代理 slackbot 身份验证列表 # 切换活跃机器人 Agent-slackbot 身份验证使用部署 # 对一个命令使用特定的机器人（无需切换） agent-slackbot 消息发送 C0ACZKTDDC0“警报！” --机器人警报 # 删除已存储的机器人代理 slackbot 身份验证删除部署 # 消除工作区中具有相同 ID 的机器人的歧义代理 slackbot 身份验证使用 T123456/deploy 所有命令都可以使用“--bot ”标志来覆盖单次调用的活动机器人。 ### 获取机器人令牌 1. 前往 [api.slack.com/apps]() 2. 创建新应用程序（或选择现有应用程序） 3. 转到 **OAuth 和权限** 4. 添加所需的机器人令牌范围（见下文） 5. 将应用程序安装到工作区 6. 复制 **机器人用户 OAuth 令牌**（以 `xoxb-` 开头） ### 所需的机器人令牌范围范围 |用于 ---|--- `聊天：写` |发送消息 `渠道：历史` |阅读公共频道消息 `频道：读取` |列出公共频道 `频道：加入` |加入公共频道 `团体：历史` |读取私人频道消息 `组：阅读` |列出私人频道 `用户：阅读` |列出用户 `用户：读取.email` |读取用户电子邮件地址 `反应：写` |添加/删除反应 `反应：阅读` |列出反应 ### 环境变量 (CI/CD) 对于 CI/CD 管道，设置这些环境变量而不是使用“auth set”：导出 E2E_SLACKBOT_TOKEN=xoxb-your-bot-token 导出 E2E_SLACKBOT_WORKSPACE_ID=T123456 导出 E2E_SLACKBOT_WORKSPACE_NAME="我的工作空间" ## 命令 ### 消息命令 # 发送消息 agent-slackbot 消息发送 <通道> <文本> agent-slackbot 消息发送 C0ACZKTDDC0“Hello world” # 发送线程回复 agent-slackbot 消息发送 C0ACZKTDDC0“回复”--thread # 列出消息 agent-slackbot 消息列表 <通道> agent-slackbot 消息列表 C0ACZKTDDC0 --limit 50 # 根据时间戳获取单条消息 agent-slackbot 消息获取 # 获取线程回复（包括父消息） agent-slackbot 消息回复 agent-slackbot 消息回复 C0ACZKTDDC0 1234567890.123456 --limit 50 # 更新消息（仅限机器人自己的消息） agent-slackbot 消息更新

# 删除一条消息（仅限机器人自己的消息） agent-slackbot 消息删除 --force ### 通道命令 # 列出机器人可以看到的频道代理 slackbot 频道列表 agent-slackbot 频道列表 --limit 50 # 获取频道信息 agent-slackbot 频道信息代理 slackbot 频道信息 C0ACZKTDDC0 ### 用户命令 # 列出用户代理 slackbot 用户列表 agent-slackbot 用户列表 --limit 50 # 获取用户信息 agent-slackbot 用户信息 ### 反应命令 # 添加反应 agent-slackbot 反应添加代理-slackbot 反应添加 C0ACZKTDDC0 1234567890.123456 点赞 # 删除反应 agent-slackbot 反应删除 ## 输出格式 ### JSON（默认）所有命令默认输出 JSON 以供 AI 使用： { "ts": "1234567890.123456", “频道”：“C0ACZKTDDC0”， “文本”：“你好世界” } ### 漂亮（人类可读）使用“--pretty”标志进行格式化输出： agent-slackbot 频道列表 --pretty ## 常见模式请参阅“references/common-patterns.md”了解典型的 AI 代理工作流程。 ## 模板请参阅“templates/”目录以获取可运行的示例： * `post-message.sh` \- 发送带有错误处理的消息 * `monitor-channel.sh` \- 监视新消息的通道 * `workspace-summary.sh` \- 生成工作区摘要 ## 错误处理所有命令返回一致的错误格式： { “错误”：“没有凭据。首先运行“auth set”。” } 常见错误： * `missing_token`: 没有配置凭证 * `invalid_token_type`：令牌不是机器人令牌（必须以 xoxb- 开头） * `not_in_channel`: Bot需要先加入频道 * `slack_webapi_rate_limited_error`：命中率限制（带退避功能的自动重试） ## 配置凭证存储在：`~/.config/agent-messenger/slackbot-credentials.json` 格式： { “当前”：{ "workspace_id": "T123456", "bot_id": "部署" }, “工作空间”：{ “T123456”：{ "workspace_id": "T123456", "workspace_name": "我的工作空间", “机器人”：{ “部署”：{ "bot_id": "部署", "bot_name": "部署机器人", "token": "xoxb-..." }, “警报”：{ “bot_id”：“警报”， "bot_name": "警报机器人", "token": "xoxb-..." } } } } } **安全**：文件权限设置为 0600（所有者只读/写） ## 与 agent-slack 的主要区别特色|代理松弛 |代理 Slackbot ---|---|--- 代币类型 |用户令牌（xoxc-）|机器人令牌 (xoxb-) 代币来源 |从桌面应用程序自动提取 | Slack 应用程序配置手册留言搜索 |是的 |否（需要用户令牌）文件操作 |是的 |否快照 |是的 |否编辑/删除消息 |任何留言 |仅机器人自己的消息工作空间管理 |多工作空间 |多机器人、多工作空间 CI/CD 友好 |需要桌面应用程序 |是（只需设置令牌） ## 限制 * 无实时事件/套接字模式 * 无消息搜索（需要用户令牌范围） * 没有文件上传/下载 * 没有工作区快照 * 机器人只能编辑/删除自己的消息 * 机器人必须被邀请进入私人频道 * 没有预定消息 * 仅纯文本消息（无块/格式） ## 故障排除 ### `agent-slackbot：找不到命令` **`agent-slackbot` 不是 npm 包名称。** npm 包是 `agent-messenger`。如果全局安装包，则直接使用“agent-slackbot”： agent-slackbot 消息发送一般“Hello” 如果未安装该软件包，请使用“bunx agent-messenger slackbot”： Bunx agent-messenger slackbot 消息发送一般“Hello” **永远不要运行 `bunx agent-slackbot`** — 它会失败或安装错误的包，因为 `agent-slackbot` 不是 npm 包名称。 ## 参考文献 * [认证指南]() * [常见模式]()

特工 Slackbot

包含技能