使用说明

编译

idf.py fullclean
idf.py set-target esp32s3

MimiClaw 启动顺序图

┌─────────────────────────────────────────────────────────┐ │ app_main() 开始 │ └─────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────┐ │ 1. 核心基础设施初始化 │ │ ┌───────────────────────────────────────────────┐ │ │ │ • 初始化NVS (非易失性存储) │ │ │ │ • NVS安全检查 │ │ │ │ • 创建默认事件循环 │ │ │ │ • 初始化SPIFFS (文件系统) │ │ │ └───────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────┐ │ 2. 子系统初始化 │ │ ┌───────────────────────────────────────────────┐ │ │ │ • 消息总线 (message_bus_init) │ │ │ │ • 内存存储 (memory_store_init) │ │ │ │ • 技能加载器 (skill_loader_init) │ │ │ │ • 会话管理器 (session_mgr_init) │ │ │ │ • WiFi管理器 (wifi_manager_init) │ │ │ │ • HTTP代理 (http_proxy_init) │ │ │ │ • Telegram机器人 (telegram_bot_init) │ │ │ │ • 飞书机器人 (feishu_bot_init) │ │ │ │ • LLM代理 (llm_proxy_init) │ │ │ │ • 工具注册表 (tool_registry_init) │ │ │ │ • 定时服务 (cron_service_init) │ │ │ │ • 心跳服务 (heartbeat_init) │ │ │ │ • 代理循环 (agent_loop_init) │ │ │ └───────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────┐ │ 3. 串口CLI启动 (无WiFi依赖) │ │ ┌───────────────────────────────────────────────┐ │ │ │ • 串口CLI初始化 (serial_cli_init) │ │ │ └───────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────┐ │ 4. WiFi连接阶段 │ │ ┌───────────────────────────────────────────────┐ │ │ │ • 启动WiFi管理器 (wifi_manager_start) │ │ │ │ • 扫描附近AP并打印 │ │ │ │ • 等待WiFi连接 (30秒超时) │ │ │ └───────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────┘ │ ▼ ┌───────────────┐ │ WiFi连接成功? │ └───────────────┘ │ ┌───────────────────┼───────────────────┐ │ │ │ ▼ │ ▼ ┌─────────────────────┐ │ ┌─────────────────────┐ │ 5a. 连接成功路径 │ │ │ 5b. 连接失败路径 │ │ • 获取IP地址 │ │ │ • 进入WiFi配置门户│ │ • 初始化时间同步 │ │ │ (wifi_onboard_start)│ │ (time_sync_init) │ │ │ • 重启设备 │ └─────────────────────┘ │ └─────────────────────┘ │ ▼ ┌─────────────────────┐ │ 启动管理门户(可选) │ │ (wifi_onboard_start)│ └─────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────┐ │ 6. 网络服务启动 │ │ ┌───────────────────────────────────────────────┐ │ │ │ • 创建出站调度任务 (outbound_dispatch_task) │ │ │ │ • 启动代理循环 (agent_loop_start) │ │ │ │ • 启动Telegram机器人 (telegram_bot_start) │ │ │ │ • 启动飞书机器人 (feishu_bot_start) │ │ │ │ • 启动定时服务 (cron_service_start) │ │ │ │ • 启动心跳服务 (heartbeat_start) │ │ │ │ • 启动WebSocket服务器 (ws_server_start) │ │ │ └───────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────┐ │ MimiClaw 启动完成 │ │ "Type 'help' for CLI commands" │ └─────────────────────────────────────────────────────────┘

关键启动点和依赖关系

时间依赖

时间同步 (time_sync_init)：只在WiFi连接成功后初始化
网络服务：所有网络服务（Telegram、飞书、WebSocket等）都在WiFi连接成功后启动

无依赖启动

串口CLI：最早启动，即使没有WiFi也能工作
核心基础设施：NVS、SPIFFS等必须首先初始化

条件分支

WiFi连接失败：进入配置门户模式，阻塞直到配置成功并重启
WiFi连接成功：继续启动所有网络服务

并行启动

多个子系统初始化是顺序执行的，但一旦启动，它们会在各自的FreeRTOS任务中并行运行
出站调度任务在启动网络服务前创建，以避免丢失早期响应这个启动顺序确保了核心功能在没有网络时也能部分工作（如CLI命令），同时网络相关服务在连接建立后按顺序启动。

9.5 KiB Raw Blame History Unescape Escape