使用Python调用channel.history拉取Slack频道消息报KeyError排查

你碰到的KeyError: 'SLACK_TOKEN'和Slack API密钥正确性无关，是代码读取变量的逻辑错误：你在代码中硬编码定义了SLACK_TOKEN变量，但os.environ['SLACK_TOKEN']的作用是读取操作系统环境变量中名为SLACK_TOKEN的值，如果你没有提前在运行环境中配置对应环境变量，直接调用就会抛出KeyError。

两种修复方式选其一即可：

• 测试阶段快速验证：直接使用代码中定义的SLACK_TOKEN变量初始化客户端，替换最后一行代码为

  client = slack_sdk.WebClient(token=SLACK_TOKEN)
  

• 规范开发（避免令牌硬编码泄露）：运行代码前在当前终端配置环境变量
  • Windows命令行执行：set SLACK_TOKEN=你的实际Slack令牌值
  • Mac/Linux终端执行：export SLACK_TOKEN=你的实际Slack令牌值
    如果使用PyCharm、VS Code等IDE运行，也可以直接在IDE的运行配置中添加环境变量项，键名填SLACK_TOKEN，值填你的令牌内容，无需每次手动在终端配置。

你已经配置的channel.history、groups.history、im.history、mpim.history权限范围满足拉取消息的要求，另外注意几个容易踩的坑：

• 你填写的CHANNEL ID是G开头，对应私有频道，必须保证令牌对应的身份（机器人/授权用户）已经被加入该频道，否则会报无权限错误。Slack新接口统一使用conversations.history拉取所有类型会话的消息，无需区分公有频道、私有群、私信的老接口。
• 不要硬编码最大消息数限制，要根据接口返回的分页标识判断是否拉取完成，避免漏数，同时加合理延迟避免触发接口限流。
• 正式拉取前可以先调用client.auth_test()验证令牌有效性，如果接口正常返回身份信息，说明令牌本身没有问题。

可直接运行的完整拉取代码如下：

import slack_sdk
import json
from time import sleep

CHANNEL = "G******"
MESSAGES_PER_PAGE = 200
SLACK_TOKEN = "替换为你自己的有效Slack令牌"

client = slack_sdk.WebClient(token=SLACK_TOKEN)
all_messages = []
next_cursor = None

while True:
    page_resp = client.conversations_history(
        channel=CHANNEL,
        limit=MESSAGES_PER_PAGE,
        cursor=next_cursor
    )
    all_messages.extend(page_resp["messages"])
    if not page_resp["has_more"]:
        break
    next_cursor = page_resp["response_metadata"]["next_cursor"]
    sleep(1.2) # 避开Slack速率限制

# 结果存入本地JSON文件
with open("slack_messages_dump.json", "w", encoding="utf-8") as f:
    json.dump(all_messages, f, ensure_ascii=False, indent=2)

print(f"拉取完成，共获取{len(all_messages)}条频道消息")

内容的提问来源于stack exchange，提问作者ChelseaSupencheck