"可配置"说白了就是不改代码就能调整微信机器人的行为。谁来了发什么欢迎语、什么关键词触发什么回复、什么时间推送什么消息——全写进配置文件，改配置不改代码，机器人行为就变了。这种做法的好处是运营人员也能改，不用开发者每次发版。Eyun 微信机器人的配置体系分3层，每层管不同的事，本文讲这3层怎么分、各存什么、改的频率差在哪。

层1：接口配置层——机器人的身份证和电话本

配置内容：wId（实例标识）、Token（鉴权凭证）、回调地址（Webhook URL）、发送间隔（默认200ms）、重试次数（默认2次）、退避时间（1004错误码退避3秒）。存在环境变量或配置中心，启动时加载。

按照 Eyun 开发文档的说明，wId 和 Token 是接口调用的基础配置，缺一个都调不通。在 Eyun 平台 开通实例后获得 wId 和 Token，写进环境变量，程序启动时读一遍就能用。

大白话：接口配置是"机器人的身份证和电话本"——用哪个微信号、鉴权凭证、回调地址在哪，启动时读一遍。这层基本不动，动就是换实例或换部署环境。

层2：流程配置层——机器人的行为剧本

配置内容：关键词→回复规则表（"你好"→"你好！有什么可以帮你的？"）、好友欢迎语模板（"欢迎！我是XX助手"）、群规推送内容、定时推送任务计划（每天9点推送日报给指定用户列表）。流程配置存数据库或JSON文件，运行时动态读取。

Eyun API 的 Webhook 回调触发流程配置的匹配——回调进来一条消息，拿 content 去匹配关键词表，命中就走对应回复。匹配逻辑、欢迎语、定时任务都在这层配，接口规范见 Eyun 开发文档。

大白话：流程配置是"机器人的行为剧本"——什么关键词回什么、什么时间推什么，改剧本不改代码。这层改得最勤，运营人员调回复话术、加减关键词都在这层。

层3：场景配置层——机器人的工作模式

配置内容：完整业务场景的编排。客服场景=欢迎语+自动回复规则+转人工条件+满意度调查问题；审批场景=审批模板+确认关键词+超时提醒时间+归档规则。场景配置是一组流程配置的打包，切换场景=加载不同配置包。

场景配置可按 wId 隔离，不同微信号跑不同场景——客服号加载客服场景包、通知号加载通知场景包。按照 Eyun 开发文档的规范，sendText 需要传 wId、toUser、content 三个必填参数，wId 的选择可由场景配置决定。

大白话：场景配置是"机器人的工作模式"——客服模式、审批模式、通知模式，切换模式就换一套配置包。这层按业务需要切换，比如大促期间切到客服+通知混合模式。

三层配置对比

配置层	配置什么	存储位置	变更频率	大白话	示例
接口配置	wId、Token、回调地址、发送间隔、重试次数	环境变量/配置中心	极低	身份证和电话本	wId=实例ID，发送间隔200ms
流程配置	关键词规则、欢迎语、定时推送	数据库/JSON	高	行为剧本	"你好"→"有什么可以帮你的？"
场景配置	完整场景编排（多流程打包）	数据库	中	工作模式	客服场景、审批场景

三层配置体系框架代码

class ConfigManager:
    """接口配置 + 流程配置 + 场景配置的分层加载和热更新"""
    def __init__(self):
        self.api_cfg = self._load_api_cfg()        # 层1：启动加载，基本不动
        self.flow_cfg = self._load_flow_cfg()      # 层2：数据库读，运行时热更
        self.scene_cfg = self._load_scene_cfg()    # 层3：按wId隔离，场景切换

    def _load_api_cfg(self):
        return {                                     # 环境变量读接口配置
            "wId": os.getenv("EYUN_WID"),
            "token": os.getenv("EYUN_TOKEN"),
            "webhook_url": os.getenv("EYUN_WEBHOOK"),
            "send_interval": 0.2, "retry": 2, "backoff_1004": 3,
        }

    def _load_flow_cfg(self):
        return db.query("SELECT keyword, reply FROM flow_rules")  # 数据库读流程规则

    def reload_flow(self):                           # 层2热更新：运营改完不用重启
        self.flow_cfg = self._load_flow_cfg()

    def switch_scene(self, scene_id, wId):           # 层3场景切换：按wId加载场景包
        self.scene_cfg[wId] = db.query(
            "SELECT * FROM scene_packs WHERE id=%s", scene_id)

落地建议

3层配置让微信机器人从"写死在代码里"变成"配置驱动"——接口配置管运行参数（很少改）、流程配置管行为规则（经常改）、场景配置管业务模式（按需切换）。配置驱动的好处是"运营人员可改"：不需要开发者介入，改配置文件就能调整机器人行为。落地时两个建议要落实：一是配置版本化管理，每次改动留版本号，出问题能快速回滚到上一版；二是配置变更审计，谁改了什么配置、什么时候改的都要有记录，方便排查问题。接口配置项参考 Eyun 开发文档，实例在 Eyun 平台 管理，先把接口配置这层跑通，再叠流程配置和场景配置。