尧图网页设计 
1. OpenClaw 邮件收发、日历日程、文件管理为什么总在配置环节卡住OpenClaw 是一个把「邮件收发、日历日程、文件管理」这类日常办公动作封装成可编排任务的自动化框架适合想把重复性事务交给脚本处理、又不想自己从零写调度逻辑的人。它的核心价值在于你只需要写业务函数剩下的异步执行、定时触发、任务编排交给 OpenClaw。但真正上手时绝大多数人卡住的地方不是业务代码而是统一 Key 与 API 通道的配置——邮件模块要 SMTP/IMAP 授权码日历模块要时区与时间格式文件模块要目录权限如果每个模块各自维护一套凭证改一次配置要翻五个文件。我试过把这三类能力拆开单独跑结果是邮件能发但日历事件时区错乱文件归档脚本又因为路径写死在不同机器上跑不通。后来把凭证和模型调用统一收敛到 TaoToken 的 Key 上配置只维护一份问题才收敛。这篇就按「先统一 Key再逐模块接入最后逐项验证」的顺序走一遍交付可复制的config.toml骨架和settings.json片段你照着改路径和 Key 就能跑。需要先明确一点OpenClaw 本身负责任务调度与业务逻辑TaoToken 负责提供统一的 API 通道与 Key 管理。两者是配合关系不是替代关系。你仍然需要自己写send_email、create_calendar_event这些函数TaoToken 解决的是「凭证从哪来、模型调用走哪个入口、多个模块怎么共用一套鉴权」的问题。理解这一点后面的配置才不会拧巴。本篇覆盖的场景很具体邮件自动发送文本附件、邮件接收与关键词自动回复、日历事件创建与提醒、文件按日期归档、清理 N 天前旧文件以及用 cron 把这些串成真正的自动化。每一步都给可复制的配置和验证动作确保你跑完能确认「这个模块真的通了」而不是「看起来配好了」。2. TaoToken 统一 Key 前置准备与 OpenClaw 环境搭建在写任何业务代码之前先把凭证通道打通。TaoToken 的作用是给你一个统一的 API 入口和 KeyOpenClaw 里所有需要调用模型或外部服务的模块都从这里取凭证避免把授权码、Token 散落在各个脚本里。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 这个地址不加 UTM 参数配置里直接写它。第一步是拿到 Key。进入控制台创建 API Key路径是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 在 API Keys 页面生成。生成后立刻复制保存页面刷新后不再完整显示。如果你后续要做长期编码或 Agent 类任务可以顺带看下 Coding Plan 页面 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 它和按量调用是两条不同的计费路径按自己的使用频率选。环境依赖安装这块OpenClaw 加邮件、日历、文件处理需要的库一次装齐pip install openclaw python-dotenv requests icalendar python-dateutil pytzsmtplib、imaplib、email、os、shutil是 Python 标准库不用单独装。装完后建议用pip show openclaw确认版本避免装到过旧的包导致claw.task装饰器行为不一致。凭证管理我强烈建议走.env不要硬编码。在项目根目录建一个.env# .env TAOTOKEN_API_KEYsk-你的TaoToken密钥 TAOTOKEN_BASE_URLhttps://taotoken.net/api MAIL_FROMxxxqq.com MAIL_AUTH_CODE你的邮箱授权码 MAIL_TOxxxxxx.com注意MAIL_AUTH_CODE是邮箱的授权码不是登录密码。QQ 邮箱、163 邮箱都需要在设置里单独开启 SMTP/IMAP 服务并生成授权码端口用 SSL 版SMTP 465、IMAP 993。这一步没做后面所有邮件操作都会在登录环节报错。然后是config.toml骨架把通道和模块开关集中管理# config.toml [taotoken] api_key ${TAOTOKEN_API_KEY} base_url https://taotoken.net/api timeout 30 [mail] smtp_server smtp.qq.com smtp_port 465 imap_server imap.qq.com imap_port 993 from_addr ${MAIL_FROM} auth_code ${MAIL_AUTH_CODE} to_addr ${MAIL_TO} [calendar] timezone Asia/Shanghai default_remind_minutes 15 [files] source_dir data archive_dir archive clean_dirs [tmp, log] clean_days 7${VAR}这种写法需要你在代码里用os.environ做一次替换或者用tomllib读进来后手动展开。这样做的目的是配置结构固定敏感值走环境变量换机器只改.env不改config.toml。对应的settings.json片段用于 OpenClaw 的运行时参数{ openclaw: { task_timeout: 60, max_retries: 3, log_level: INFO }, taotoken: { base_url: https://taotoken.net/api, model_id: claude-sonnet-4-5, api_key_env: TAOTOKEN_API_KEY }, modules: { mail: true, calendar: true, files: true } }这里model_id按你实际在 TaoToken 控制台可用的模型填api_key_env指向环境变量名而不是值本身避免 Key 进版本库。三件套Base URL Key Model ID在邮件、日历、文件三个模块里共用同一份这就是「统一 Key」的实际含义——不是三个模块各配一套而是都从settings.json的taotoken段取。配置写完后先做一次加载验证确认 TOML 和 JSON 都能被正确解析import tomllib, json, os from dotenv import load_dotenv load_dotenv() with open(config.toml, rb) as f: cfg tomllib.load(f) with open(settings.json, r, encodingutf-8) as f: settings json.load(f) print(base_url:, settings[taotoken][base_url]) print(api_key loaded:, bool(os.getenv(settings[taotoken][api_key_env]))) print(modules:, settings[modules])跑出来api_key loaded: True且三个模块都是true前置准备就算过了。如果这里是False先别往下走回去检查.env是否被load_dotenv()正确加载、变量名是否拼错。3. 可复制配置邮件、日历、文件三模块接入 OpenClaw这一节把三个模块的接入代码给全每段都能直接复制进项目跑。核心思路是所有模块共用config.toml和settings.json里的凭证业务函数只关心逻辑不关心凭证从哪来。先写一个统一的配置加载器避免每个文件重复读配置# config_loader.py import tomllib, json, os from dotenv import load_dotenv load_dotenv() def load_config(): with open(config.toml, rb) as f: cfg tomllib.load(f) with open(settings.json, r, encodingutf-8) as f: settings json.load(f) # 展开 ${VAR} def expand(d): if isinstance(d, dict): return {k: expand(v) for k, v in d.items()} if isinstance(d, str) and d.startswith(${) and d.endswith(}): return os.getenv(d[2:-1], ) return d return expand(cfg), settings CFG, SETTINGS load_config()邮件模块的发送函数支持文本和附件# mail_module.py import smtplib from email.mime.text import MIMEText from email.mime.multipart import MIMEMultipart from email.mime.base import MIMEBase from email import encoders from config_loader import CFG def send_email(subject, content, attach_pathNone): m CFG[mail] msg MIMEMultipart() msg[From] m[from_addr] msg[To] m[to_addr] msg[Subject] subject msg.attach(MIMEText(content, plain, utf-8)) if attach_path: with open(attach_path, rb) as f: part MIMEBase(application, octet-stream) part.set_payload(f.read()) encoders.encode_base64(part) part.add_header( Content-Disposition, fattachment; filename{attach_path} ) msg.attach(part) with smtplib.SMTP_SSL(m[smtp_server], m[smtp_port], timeout30) as s: s.login(m[from_addr], m[auth_code]) s.sendmail(m[from_addr], m[to_addr], msg.as_string()) print(f邮件发送成功{subject})邮件接收与关键词自动回复# mail_receive.py import imaplib, email from email.header import decode_header from config_loader import CFG from mail_module import send_email def decode_str(s): value, charset decode_header(s)[0] if charset: value value.decode(charset) return value def receive_email(): m CFG[mail] with imaplib.IMAP4_SSL(m[imap_server], m[imap_port]) as server: server.login(m[from_addr], m[auth_code]) server.select(INBOX) status, messages server.search(None, UNSEEN) for num in messages[0].split(): res, data server.fetch(num, (RFC822)) msg email.message_from_bytes(data[0][1]) subject decode_str(msg[Subject]) from_user decode_str(msg.get(From)) print(f新邮件{subject} 来自 {from_user}) if 报表 in subject: send_email(自动回复, 已收到您的报表将尽快处理) print(邮件接收完成)日历模块创建事件并生成.ics文件再通过邮件把日程提醒发出去# calendar_module.py from icalendar import Calendar, Event from datetime import datetime import pytz from config_loader import CFG from mail_module import send_email def create_calendar_event(title, start_time, end_time, remind_minutesNone): tz pytz.timezone(CFG[calendar][timezone]) remind remind_minutes or CFG[calendar][default_remind_minutes] cal Calendar() ev Event() ev.add(summary, title) ev.add(dtstart, datetime.strptime(start_time, %Y-%m-%d %H:%M).replace(tzinfotz)) ev.add(dtend, datetime.strptime(end_time, %Y-%m-%d %H:%M).replace(tzinfotz)) cal.add_component(ev) with open(meeting.ics, wb) as f: f.write(cal.to_ical()) send_email(f日程提醒{title}, f会议时间{start_time}, meeting.ics) print(f日历事件已创建{title})文件归档与清理# file_module.py import os, shutil, time from datetime import datetime from config_loader import CFG def auto_archive_files(): src CFG[files][source_dir] dst CFG[files][archive_dir] today datetime.now().strftime(%Y-%m-%d) target os.path.join(dst, today) os.makedirs(target, exist_okTrue) for f in os.listdir(src): p os.path.join(src, f) if os.path.isfile(p): shutil.move(p, os.path.join(target, f)) print(文件归档完成) def auto_clean_old_files(): days CFG[files][clean_days] expire time.time() - days * 86400 for d in CFG[files][clean_dirs]: if not os.path.exists(d): continue for f in os.listdir(d): p os.path.join(d, f) if os.path.getmtime(p) expire: os.remove(p) print(f已清理{p}) print(旧文件清理完成)把这三个模块挂到 OpenClaw 的任务系统上用claw.task装饰器包装再用claw.schedule做定时# main.py import openclaw from mail_module import send_email from mail_receive import receive_email from calendar_module import create_calendar_event from file_module import auto_archive_files, auto_clean_old_files claw openclaw.OpenClaw() claw.schedule(cron0 9 * * *) def daily_report(): send_email(每日工作日报, 今日工作已完成...) claw.schedule(cron0 0 * * *) def daily_backup(): auto_archive_files() auto_clean_old_files() claw.schedule(cron0 * * * *) def check_mail(): receive_email() if __name__ __main__: claw.start()到这里三模块的接入骨架就齐了。注意config.toml里的路径data、archive、tmp、log要和你实际项目目录一致否则文件模块会报目录不存在。下一节做逐项验证。4. 逐项验证请求与成功结果确认配置写完不代表通了必须逐项验证。我按「邮件发送 → 邮件接收 → 日历事件 → 文件归档 → 文件清理」的顺序给验证动作每步都有明确的成功标志。邮件发送验证直接调用函数from mail_module import send_email send_email(OpenClaw自动邮件测试, 这是自动发送的测试邮件)成功时终端输出邮件发送成功OpenClaw自动邮件测试同时收件箱能收到邮件。如果卡住不动大概率是 SMTP 端口或授权码问题看下一节排障。带附件的验证send_email(带附件测试, 附件是日历文件, meeting.ics)邮件接收验证先给自己发一封主题含「报表」的邮件然后跑from mail_receive import receive_email receive_email()成功标志是终端打印新邮件...报表... 来自 ...并且触发自动回复你的收件箱会收到一封「自动回复」。这里有个细节server.search(None, UNSEEN)只拉未读邮件如果你之前已经读过需要先标记为未读再测。日历事件验证from calendar_module import create_calendar_event create_calendar_event(项目评审会, 2026-03-10 15:00, 2026-03-10 16:00)成功时生成meeting.ics并且因为函数内部调了send_email你会收到一封带.ics附件的日程提醒邮件。把附件下载下来用日历应用打开确认时间显示为 15:00 而不是 UTC 的 07:00说明时区配置生效。文件归档验证先在data目录放几个测试文件mkdir -p data tmp log echo test1 data/a.txt echo test2 data/b.txt然后跑from file_module import auto_archive_files auto_archive_files()成功标志是data目录清空archive/2026-03-10/当天日期下出现a.txt和b.txt。文件清理验证先造一个旧文件touch -d 10 days ago tmp/old.log再跑from file_module import auto_clean_old_files auto_clean_old_files()成功标志是终端打印已清理tmp/old.log且该文件确实被删除。touch -d在 macOS 和 Linux 上都可用Windows 下可以用 PowerShell 的(Get-Item tmp\old.log).LastWriteTime (Get-Date).AddDays(-10)替代。最后做一次整体验证把main.py跑起来观察 cron 任务是否按预期触发。测试时可以把 cron 改成每分钟触发一次* * * * *方便观察确认无误后再改回正式频率。成功标志是终端按分钟打印邮件检查日志且没有异常堆栈。5. 本篇常见报错排查401、local proxy failed、reading choices、OAuth配置和验证过程中最容易撞上的几类报错我按真实错误信息对照给解法。401 Unauthorized / invalid api key这是 TaoToken Key 没被正确加载。先确认.env里TAOTOKEN_API_KEY的值没有多余空格或引号再确认load_dotenv()在读取配置之前执行。如果用的是settings.json里的api_key_env间接引用检查环境变量名拼写是否和.env一致。还有一种情况是 Key 已过期或在控制台被删除去 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 重新生成一个。local proxy failed / connection refused这类报错通常出现在请求https://taotoken.net/api时网络层不通。先确认base_url写的是https://taotoken.net/api而不是带 UTM 的官网地址——UTM 参数只用于网页跳转API 调用不要带。再检查本机是否有其他网络工具拦截了请求关掉后重试。如果公司网络有出口限制换一个网络环境验证。reading choices / choices 字段为空这个报错说明请求发出去了、鉴权也过了但返回体里没有预期的choices结构。常见原因是model_id填了一个当前 Key 无权访问的模型。去控制台确认可用模型列表把settings.json里的model_id改成实际可用的。另一种可能是请求体格式不对检查你传给 API 的 JSON 是否符合接口文档要求。OAuth / token expired如果你在 OpenClaw 里接了需要 OAuth 的外部服务比如某些日历 APItoken 过期会报这个。解法是重新走一遍授权流程拿新 token并检查刷新逻辑是否生效。纯邮件文件场景一般不会碰到 OAuth遇到时先确认是不是误配了需要 OAuth 的模块。SMTPAuthenticationError / 授权码错误邮件模块专属。确认用的是授权码不是登录密码确认邮箱后台已开启 SMTP 服务。QQ 邮箱的授权码在「设置 → 账户 → POP3/IMAP/SMTP服务」里生成163 类似。UnicodeDecodeError / 邮件内容乱码编码不兼容。接收邮件时用email.message_from_bytes配合decode_header正文解码时加errorsignore兜底。发送时MIMEText(content, plain, utf-8)明确指定 utf-8。FileNotFoundError / 目录不存在文件模块的路径没建。跑之前先os.makedirs(target, exist_okTrue)或者手动mkdir -p data archive tmp log。归档和清理函数里我都加了exist_okTrue和os.path.exists判断但源目录data本身如果不存在os.listdir还是会报错所以源目录要提前建好。PermissionError / 权限不足Windows 下对某些目录写入需要管理员权限Linux 下检查chmod。换一个有写权限的目录或者用os.access(path, os.W_OK)先探测。cron 任务不触发OpenClaw 的claw.schedule依赖claw.start()保持进程运行。如果你用python main.py跑完就退出定时任务不会执行。生产环境建议用nohup或 systemd 常驻测试时确认进程没退出。6. 长期跑自动化任务把 Key 和配置管好才是关键三模块跑通之后真正决定这套东西能不能长期用的是配置管理而不是业务代码。业务函数写一次基本不用动但 Key 会轮换、路径会变、模型会升级如果这些散落在各个脚本里维护成本会指数上升。我的做法是config.toml只放结构和非敏感默认值.env放所有敏感值和环境相关路径settings.json放运行时参数和模块开关。三者职责分明换机器只改.env。TaoToken 的 Key 统一从TAOTOKEN_API_KEY取邮件授权码从MAIL_AUTH_CODE取任何模块都不直接读环境变量而是通过config_loader统一加载。这样加新模块时只要在config.toml加一段、在settings.json的modules里加个开关业务代码复用同一套加载逻辑。如果你后续要把这套东西扩展到更多场景比如接入模型对话做邮件内容摘要、或者用 Coding Plan 跑更复杂的 Agent 任务配置结构不用大改只需要在settings.json的taotoken段里调整model_id业务侧调用方式保持一致。模型对话入口在 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 遇到接口细节问题时对照文档比猜要快。最后提醒一个容易忽略的点.env一定要进.gitignore。我见过太多人把授权码和 Key 提交到仓库后面轮换起来非常麻烦。配置分离做对了这套 OpenClaw 自动化才能真正稳定跑下去而不是每次改点东西都要重新捋一遍凭证在哪。 OpenClaw 超级 AI 实战专栏【实战案例】（五）邮件收发 + 日历日程 + 文件管理一站式搞定：TaoToken 统一 Key 配置与验证
1. OpenClaw 邮件收发、日历日程、文件管理为什么总在配置环节卡住OpenClaw 是一个把「邮件收发、日历日程、文件管理」这类日常办公动作封装成可编排任务的自动化框架适合想把重复性事务交给脚本处理、又不想自己从零写调度逻辑的人。它的核心价值在于你只需要写业务函数剩下的异步执行、定时触发、任务编排交给 OpenClaw。但真正上手时绝大多数人卡住的地方不是业务代码而是统一 Key 与 API 通道的配置——邮件模块要 SMTP/IMAP 授权码日历模块要时区与时间格式文件模块要目录权限如果每个模块各自维护一套凭证改一次配置要翻五个文件。我试过把这三类能力拆开单独跑结果是邮件能发但日历事件时区错乱文件归档脚本又因为路径写死在不同机器上跑不通。后来把凭证和模型调用统一收敛到 TaoToken 的 Key 上配置只维护一份问题才收敛。这篇就按「先统一 Key再逐模块接入最后逐项验证」的顺序走一遍交付可复制的config.toml骨架和settings.json片段你照着改路径和 Key 就能跑。需要先明确一点OpenClaw 本身负责任务调度与业务逻辑TaoToken 负责提供统一的 API 通道与 Key 管理。两者是配合关系不是替代关系。你仍然需要自己写send_email、create_calendar_event这些函数TaoToken 解决的是「凭证从哪来、模型调用走哪个入口、多个模块怎么共用一套鉴权」的问题。理解这一点后面的配置才不会拧巴。本篇覆盖的场景很具体邮件自动发送文本附件、邮件接收与关键词自动回复、日历事件创建与提醒、文件按日期归档、清理 N 天前旧文件以及用 cron 把这些串成真正的自动化。每一步都给可复制的配置和验证动作确保你跑完能确认「这个模块真的通了」而不是「看起来配好了」。2. TaoToken 统一 Key 前置准备与 OpenClaw 环境搭建在写任何业务代码之前先把凭证通道打通。TaoToken 的作用是给你一个统一的 API 入口和 KeyOpenClaw 里所有需要调用模型或外部服务的模块都从这里取凭证避免把授权码、Token 散落在各个脚本里。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 这个地址不加 UTM 参数配置里直接写它。第一步是拿到 Key。进入控制台创建 API Key路径是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 在 API Keys 页面生成。生成后立刻复制保存页面刷新后不再完整显示。如果你后续要做长期编码或 Agent 类任务可以顺带看下 Coding Plan 页面 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 它和按量调用是两条不同的计费路径按自己的使用频率选。环境依赖安装这块OpenClaw 加邮件、日历、文件处理需要的库一次装齐pip install openclaw python-dotenv requests icalendar python-dateutil pytzsmtplib、imaplib、email、os、shutil是 Python 标准库不用单独装。装完后建议用pip show openclaw确认版本避免装到过旧的包导致claw.task装饰器行为不一致。凭证管理我强烈建议走.env不要硬编码。在项目根目录建一个.env# .env TAOTOKEN_API_KEYsk-你的TaoToken密钥 TAOTOKEN_BASE_URLhttps://taotoken.net/api MAIL_FROMxxxqq.com MAIL_AUTH_CODE你的邮箱授权码 MAIL_TOxxxxxx.com注意MAIL_AUTH_CODE是邮箱的授权码不是登录密码。QQ 邮箱、163 邮箱都需要在设置里单独开启 SMTP/IMAP 服务并生成授权码端口用 SSL 版SMTP 465、IMAP 993。这一步没做后面所有邮件操作都会在登录环节报错。然后是config.toml骨架把通道和模块开关集中管理# config.toml [taotoken] api_key ${TAOTOKEN_API_KEY} base_url https://taotoken.net/api timeout 30 [mail] smtp_server smtp.qq.com smtp_port 465 imap_server imap.qq.com imap_port 993 from_addr ${MAIL_FROM} auth_code ${MAIL_AUTH_CODE} to_addr ${MAIL_TO} [calendar] timezone Asia/Shanghai default_remind_minutes 15 [files] source_dir data archive_dir archive clean_dirs [tmp, log] clean_days 7${VAR}这种写法需要你在代码里用os.environ做一次替换或者用tomllib读进来后手动展开。这样做的目的是配置结构固定敏感值走环境变量换机器只改.env不改config.toml。对应的settings.json片段用于 OpenClaw 的运行时参数{ openclaw: { task_timeout: 60, max_retries: 3, log_level: INFO }, taotoken: { base_url: https://taotoken.net/api, model_id: claude-sonnet-4-5, api_key_env: TAOTOKEN_API_KEY }, modules: { mail: true, calendar: true, files: true } }这里model_id按你实际在 TaoToken 控制台可用的模型填api_key_env指向环境变量名而不是值本身避免 Key 进版本库。三件套Base URL Key Model ID在邮件、日历、文件三个模块里共用同一份这就是「统一 Key」的实际含义——不是三个模块各配一套而是都从settings.json的taotoken段取。配置写完后先做一次加载验证确认 TOML 和 JSON 都能被正确解析import tomllib, json, os from dotenv import load_dotenv load_dotenv() with open(config.toml, rb) as f: cfg tomllib.load(f) with open(settings.json, r, encodingutf-8) as f: settings json.load(f) print(base_url:, settings[taotoken][base_url]) print(api_key loaded:, bool(os.getenv(settings[taotoken][api_key_env]))) print(modules:, settings[modules])跑出来api_key loaded: True且三个模块都是true前置准备就算过了。如果这里是False先别往下走回去检查.env是否被load_dotenv()正确加载、变量名是否拼错。3. 可复制配置邮件、日历、文件三模块接入 OpenClaw这一节把三个模块的接入代码给全每段都能直接复制进项目跑。核心思路是所有模块共用config.toml和settings.json里的凭证业务函数只关心逻辑不关心凭证从哪来。先写一个统一的配置加载器避免每个文件重复读配置# config_loader.py import tomllib, json, os from dotenv import load_dotenv load_dotenv() def load_config(): with open(config.toml, rb) as f: cfg tomllib.load(f) with open(settings.json, r, encodingutf-8) as f: settings json.load(f) # 展开 ${VAR} def expand(d): if isinstance(d, dict): return {k: expand(v) for k, v in d.items()} if isinstance(d, str) and d.startswith(${) and d.endswith(}): return os.getenv(d[2:-1], ) return d return expand(cfg), settings CFG, SETTINGS load_config()邮件模块的发送函数支持文本和附件# mail_module.py import smtplib from email.mime.text import MIMEText from email.mime.multipart import MIMEMultipart from email.mime.base import MIMEBase from email import encoders from config_loader import CFG def send_email(subject, content, attach_pathNone): m CFG[mail] msg MIMEMultipart() msg[From] m[from_addr] msg[To] m[to_addr] msg[Subject] subject msg.attach(MIMEText(content, plain, utf-8)) if attach_path: with open(attach_path, rb) as f: part MIMEBase(application, octet-stream) part.set_payload(f.read()) encoders.encode_base64(part) part.add_header( Content-Disposition, fattachment; filename{attach_path} ) msg.attach(part) with smtplib.SMTP_SSL(m[smtp_server], m[smtp_port], timeout30) as s: s.login(m[from_addr], m[auth_code]) s.sendmail(m[from_addr], m[to_addr], msg.as_string()) print(f邮件发送成功{subject})邮件接收与关键词自动回复# mail_receive.py import imaplib, email from email.header import decode_header from config_loader import CFG from mail_module import send_email def decode_str(s): value, charset decode_header(s)[0] if charset: value value.decode(charset) return value def receive_email(): m CFG[mail] with imaplib.IMAP4_SSL(m[imap_server], m[imap_port]) as server: server.login(m[from_addr], m[auth_code]) server.select(INBOX) status, messages server.search(None, UNSEEN) for num in messages[0].split(): res, data server.fetch(num, (RFC822)) msg email.message_from_bytes(data[0][1]) subject decode_str(msg[Subject]) from_user decode_str(msg.get(From)) print(f新邮件{subject} 来自 {from_user}) if 报表 in subject: send_email(自动回复, 已收到您的报表将尽快处理) print(邮件接收完成)日历模块创建事件并生成.ics文件再通过邮件把日程提醒发出去# calendar_module.py from icalendar import Calendar, Event from datetime import datetime import pytz from config_loader import CFG from mail_module import send_email def create_calendar_event(title, start_time, end_time, remind_minutesNone): tz pytz.timezone(CFG[calendar][timezone]) remind remind_minutes or CFG[calendar][default_remind_minutes] cal Calendar() ev Event() ev.add(summary, title) ev.add(dtstart, datetime.strptime(start_time, %Y-%m-%d %H:%M).replace(tzinfotz)) ev.add(dtend, datetime.strptime(end_time, %Y-%m-%d %H:%M).replace(tzinfotz)) cal.add_component(ev) with open(meeting.ics, wb) as f: f.write(cal.to_ical()) send_email(f日程提醒{title}, f会议时间{start_time}, meeting.ics) print(f日历事件已创建{title})文件归档与清理# file_module.py import os, shutil, time from datetime import datetime from config_loader import CFG def auto_archive_files(): src CFG[files][source_dir] dst CFG[files][archive_dir] today datetime.now().strftime(%Y-%m-%d) target os.path.join(dst, today) os.makedirs(target, exist_okTrue) for f in os.listdir(src): p os.path.join(src, f) if os.path.isfile(p): shutil.move(p, os.path.join(target, f)) print(文件归档完成) def auto_clean_old_files(): days CFG[files][clean_days] expire time.time() - days * 86400 for d in CFG[files][clean_dirs]: if not os.path.exists(d): continue for f in os.listdir(d): p os.path.join(d, f) if os.path.getmtime(p) expire: os.remove(p) print(f已清理{p}) print(旧文件清理完成)把这三个模块挂到 OpenClaw 的任务系统上用claw.task装饰器包装再用claw.schedule做定时# main.py import openclaw from mail_module import send_email from mail_receive import receive_email from calendar_module import create_calendar_event from file_module import auto_archive_files, auto_clean_old_files claw openclaw.OpenClaw() claw.schedule(cron0 9 * * *) def daily_report(): send_email(每日工作日报, 今日工作已完成...) claw.schedule(cron0 0 * * *) def daily_backup(): auto_archive_files() auto_clean_old_files() claw.schedule(cron0 * * * *) def check_mail(): receive_email() if __name__ __main__: claw.start()到这里三模块的接入骨架就齐了。注意config.toml里的路径data、archive、tmp、log要和你实际项目目录一致否则文件模块会报目录不存在。下一节做逐项验证。4. 逐项验证请求与成功结果确认配置写完不代表通了必须逐项验证。我按「邮件发送 → 邮件接收 → 日历事件 → 文件归档 → 文件清理」的顺序给验证动作每步都有明确的成功标志。邮件发送验证直接调用函数from mail_module import send_email send_email(OpenClaw自动邮件测试, 这是自动发送的测试邮件)成功时终端输出邮件发送成功OpenClaw自动邮件测试同时收件箱能收到邮件。如果卡住不动大概率是 SMTP 端口或授权码问题看下一节排障。带附件的验证send_email(带附件测试, 附件是日历文件, meeting.ics)邮件接收验证先给自己发一封主题含「报表」的邮件然后跑from mail_receive import receive_email receive_email()成功标志是终端打印新邮件...报表... 来自 ...并且触发自动回复你的收件箱会收到一封「自动回复」。这里有个细节server.search(None, UNSEEN)只拉未读邮件如果你之前已经读过需要先标记为未读再测。日历事件验证from calendar_module import create_calendar_event create_calendar_event(项目评审会, 2026-03-10 15:00, 2026-03-10 16:00)成功时生成meeting.ics并且因为函数内部调了send_email你会收到一封带.ics附件的日程提醒邮件。把附件下载下来用日历应用打开确认时间显示为 15:00 而不是 UTC 的 07:00说明时区配置生效。文件归档验证先在data目录放几个测试文件mkdir -p data tmp log echo test1 data/a.txt echo test2 data/b.txt然后跑from file_module import auto_archive_files auto_archive_files()成功标志是data目录清空archive/2026-03-10/当天日期下出现a.txt和b.txt。文件清理验证先造一个旧文件touch -d 10 days ago tmp/old.log再跑from file_module import auto_clean_old_files auto_clean_old_files()成功标志是终端打印已清理tmp/old.log且该文件确实被删除。touch -d在 macOS 和 Linux 上都可用Windows 下可以用 PowerShell 的(Get-Item tmp\old.log).LastWriteTime (Get-Date).AddDays(-10)替代。最后做一次整体验证把main.py跑起来观察 cron 任务是否按预期触发。测试时可以把 cron 改成每分钟触发一次* * * * *方便观察确认无误后再改回正式频率。成功标志是终端按分钟打印邮件检查日志且没有异常堆栈。5. 本篇常见报错排查401、local proxy failed、reading choices、OAuth配置和验证过程中最容易撞上的几类报错我按真实错误信息对照给解法。401 Unauthorized / invalid api key这是 TaoToken Key 没被正确加载。先确认.env里TAOTOKEN_API_KEY的值没有多余空格或引号再确认load_dotenv()在读取配置之前执行。如果用的是settings.json里的api_key_env间接引用检查环境变量名拼写是否和.env一致。还有一种情况是 Key 已过期或在控制台被删除去 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 重新生成一个。local proxy failed / connection refused这类报错通常出现在请求https://taotoken.net/api时网络层不通。先确认base_url写的是https://taotoken.net/api而不是带 UTM 的官网地址——UTM 参数只用于网页跳转API 调用不要带。再检查本机是否有其他网络工具拦截了请求关掉后重试。如果公司网络有出口限制换一个网络环境验证。reading choices / choices 字段为空这个报错说明请求发出去了、鉴权也过了但返回体里没有预期的choices结构。常见原因是model_id填了一个当前 Key 无权访问的模型。去控制台确认可用模型列表把settings.json里的model_id改成实际可用的。另一种可能是请求体格式不对检查你传给 API 的 JSON 是否符合接口文档要求。OAuth / token expired如果你在 OpenClaw 里接了需要 OAuth 的外部服务比如某些日历 APItoken 过期会报这个。解法是重新走一遍授权流程拿新 token并检查刷新逻辑是否生效。纯邮件文件场景一般不会碰到 OAuth遇到时先确认是不是误配了需要 OAuth 的模块。SMTPAuthenticationError / 授权码错误邮件模块专属。确认用的是授权码不是登录密码确认邮箱后台已开启 SMTP 服务。QQ 邮箱的授权码在「设置 → 账户 → POP3/IMAP/SMTP服务」里生成163 类似。UnicodeDecodeError / 邮件内容乱码编码不兼容。接收邮件时用email.message_from_bytes配合decode_header正文解码时加errorsignore兜底。发送时MIMEText(content, plain, utf-8)明确指定 utf-8。FileNotFoundError / 目录不存在文件模块的路径没建。跑之前先os.makedirs(target, exist_okTrue)或者手动mkdir -p data archive tmp log。归档和清理函数里我都加了exist_okTrue和os.path.exists判断但源目录data本身如果不存在os.listdir还是会报错所以源目录要提前建好。PermissionError / 权限不足Windows 下对某些目录写入需要管理员权限Linux 下检查chmod。换一个有写权限的目录或者用os.access(path, os.W_OK)先探测。cron 任务不触发OpenClaw 的claw.schedule依赖claw.start()保持进程运行。如果你用python main.py跑完就退出定时任务不会执行。生产环境建议用nohup或 systemd 常驻测试时确认进程没退出。6. 长期跑自动化任务把 Key 和配置管好才是关键三模块跑通之后真正决定这套东西能不能长期用的是配置管理而不是业务代码。业务函数写一次基本不用动但 Key 会轮换、路径会变、模型会升级如果这些散落在各个脚本里维护成本会指数上升。我的做法是config.toml只放结构和非敏感默认值.env放所有敏感值和环境相关路径settings.json放运行时参数和模块开关。三者职责分明换机器只改.env。TaoToken 的 Key 统一从TAOTOKEN_API_KEY取邮件授权码从MAIL_AUTH_CODE取任何模块都不直接读环境变量而是通过config_loader统一加载。这样加新模块时只要在config.toml加一段、在settings.json的modules里加个开关业务代码复用同一套加载逻辑。如果你后续要把这套东西扩展到更多场景比如接入模型对话做邮件内容摘要、或者用 Coding Plan 跑更复杂的 Agent 任务配置结构不用大改只需要在settings.json的taotoken段里调整model_id业务侧调用方式保持一致。模型对话入口在 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 遇到接口细节问题时对照文档比猜要快。最后提醒一个容易忽略的点.env一定要进.gitignore。我见过太多人把授权码和 Key 提交到仓库后面轮换起来非常麻烦。配置分离做对了这套 OpenClaw 自动化才能真正稳定跑下去而不是每次改点东西都要重新捋一遍凭证在哪。