如何不烧板就开发 ESP32 固件zclaw 本地开发工作流完整指南QEMU模拟 主机测试【免费下载链接】zclawYour personal AI assistant at all-in 888KiB (~35KB in app code). Running on an ESP32. GPIO, cron, custom tools, memory, and more.项目地址: https://gitcode.com/gh_mirrors/zc/zclawzclaw 是一款运行在 ESP32 上的超小型 AI 个人助手固件全部固件仅约 888 KiB支持 GPIO 控制、定时任务、持久记忆和自定义工具。对很多新手来说最大的门槛是改一行 C 代码 → 编译 → 烧录开发板 → 重新配置一轮循环要十分钟起步。好消息是 zclaw 提供了一套不用烧板也能快速 hacking ESP32 固件的本地开发工作流QEMU 模拟器 主机端单元测试让迭代速度从分钟级降到秒级。为什么 ESP32 开发总离不开烧板传统 ESP-IDF 开发循环是这样的修改 C 源码idf.py build编译1~3 分钟烧录到开发板还要占用串口打开串口监视器看日志改错了回到第 1 步对于 zclaw 这种逻辑复杂的固件LLM 请求、工具调度、限流、记忆持久化……每烧一次板验证一个小改动非常痛苦。zclaw 的解法是把测试和运行分两层层级工具需要硬件速度主机单元测试./scripts/test.sh host❌秒级QEMU 模拟运行./scripts/emulate.sh❌秒级真机烧录验证./scripts/flash.sh✅分钟级核心思路大部分时间在前两层干活只在最终验收时才碰开发板。一键准备工作克隆仓库并安装环境git clone https://gitcode.com/gh_mirrors/zc/zclaw cd zclaw ./install.sh -y安装脚本会自动处理依赖Linux 下自动识别 apt/pacman/dnf/zypper包括 ESP-IDF 工具链、QEMU用于模拟运行和 cJSON用于主机测试。如果后面要用到 QEMU 模拟确认系统已安装qemu-system-riscv32macOSbrew install qemuUbuntuapt install qemu-system-misc主机测试改完代码先跑这个scripts/test.sh 是 zclaw 的主要本地安全网。执行host子命令后它会在你的电脑上而非开发板上编译并运行一整套 C 单元测试./scripts/test.sh host这套测试覆盖的内容包括JSON 工具解析与工具调用逻辑—— test/host/test_tools_parse.cAgent 核心循环—— test/host/test_agent.cGPIO / I2C / DHT 工具的策略与安全护栏—— test/host/test_tools_gpio_policy.cLLM 认证与运行时stub 模式下测试真实的 main/llm.c限流器持久化、Telegram 更新解析、内存键、WiFi 凭据等几个值得新手注意的工程细节默认开启AddressSanitizer可用ASAN0关闭内存越界当场报错编译使用-Wall -Wextra -Werror级别的警告策略保证质量不回退ESP32 侧的 APIWiFi、NVS、FreeRTOS 等全部由 test/host/mock_esp.c、test/host/mock_freertos.c 等 mock 实现替代所以在普通 PC 上就能直接跑固件核心逻辑改完代码先跑test.sh host全绿再去模拟或烧板能省掉大量烧板才发现崩了的尴尬。QEMU 模拟运行在 PC 上跑一整块 ESP32-C3这是 zclaw 本地开发工作流中最惊艳的部分。scripts/emulate.sh 会以 QEMU 专用配置编译固件配置来自 sdkconfig.qemu.defaults把 bootloader、分区表和应用合并成一个 4MB 的完整镜像启动qemu-system-riscv32 -M esp32c3在终端里完整运行固件./scripts/emulate.sh # 退出模拟器CtrlA 然后按 XQEMU 配置做了两个关键 stub见 sdkconfig.qemu.defaultsCONFIG_ZCLAW_STUB_LLMyLLM 请求由固件内的 stub 应答不依赖真实网络CONFIG_ZCLAW_STUB_TELEGRAMyCONFIG_ZCLAW_CHANNEL_UARTy聊天通道从 Telegram 换成串口你在 QEMU 终端里直接输入文字就能和AI 助手对话也就是说在你的终端里你就是一个和 AI 设备聊天的人——可以测试命令解析、工具调用、记忆读写、定时任务逻辑全程不碰硬件。 QEMU 中 WiFi/TLS 不工作这是设计预期。需要真实 LLM 对话时可用./scripts/emulate.sh --live-api由 scripts/qemu_live_llm_bridge.py 在宿主机上代理转发请求需要你设置ANTHROPIC_API_KEY或OPENAI_API_KEY环境变量。如果模拟器进程意外残留用 scripts/exit-emulator.sh 一键清理./scripts/exit-emulator.sh有了模拟器真机流程还剩什么QEMU 负责快速迭代真机只负责最终验证。zclaw 的快速循环摘自官方 Local Dev 文档非常简洁./scripts/test.sh host # 1) 主机测试 ./scripts/build.sh # 2) 编译 ./scripts/flash.sh --kill-monitor /dev/cu.usbmodem1101 # 3) 烧录自动处理端口占用 ./scripts/provision-dev.sh --port /dev/cu.usbmodem1101 # 4) 从本地配置注入凭据 ./scripts/monitor.sh /dev/cu.usbmodem1101 # 5) 串口观察日志新手最容易忽略的一个提效技巧凭据配置一次之后不用重打。scripts/provision-dev.sh 支持本地配置文件./scripts/provision-dev.sh --write-template # 生成 ~/.config/zclaw/dev.env 模板 # 编辑模板填入 WiFi / API Key / Telegram token ./scripts/provision-dev.sh # 以后直接运行即可输出自动打码另外两个实用点正常烧录不会擦除 NVSWiFi/API 凭据默认保留改代码后直接flash.sh就行只改了运行时凭据跳过编译和烧录直接跑provision-dev.sh即可遇到问题怎么办实用调试清单症状解决方案串口报端口占用运行 scripts/release-port.sh 释放残留占用Telegram 重复播放旧消息运行./scripts/telegram-clear-backlog.sh --show-config想确认脚本将写入的值./scripts/provision-dev.sh --show-config --dry-run凭据彻底乱了scripts/erase.sh 的--nvs只擦配置保留固件--all全擦有确认护栏板子进安全模式 / 未配置用 USB 串口控制台/wifi scan、/gpio all、/reboot等本地命令救援总结这套工作流好在哪秒级反馈主机测试 QEMU 模拟让 90% 的迭代不需要硬件无硬件门槛没有 ESP32 开发板也能完整参与 zclaw 固件开发配置一次长期有效provision-dev.sh配置文件 NVS 保留省掉每次重配凭据有护栏擦除、安全模式等破坏性操作都有确认机制对想学习嵌入式 AI 项目的同学来说这套 主机测试 → QEMU 模拟 → 真机验收 的三层工作流本身就值得借鉴。快去仓库里试试改一个小工具在 QEMU 终端里看到它被 AI 调用吧 延伸阅读完整本地开发指南见 docs-site/local-dev.html更多脚本说明见 README.md 的 Other Useful Scripts 章节。【免费下载链接】zclawYour personal AI assistant at all-in 888KiB (~35KB in app code). Running on an ESP32. GPIO, cron, custom tools, memory, and more.项目地址: https://gitcode.com/gh_mirrors/zc/zclaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 如何不烧板就开发 ESP32 固件：zclaw 本地开发工作流完整指南（QEMU模拟 + 主机测试）
如何不烧板就开发 ESP32 固件zclaw 本地开发工作流完整指南QEMU模拟 主机测试【免费下载链接】zclawYour personal AI assistant at all-in 888KiB (~35KB in app code). Running on an ESP32. GPIO, cron, custom tools, memory, and more.项目地址: https://gitcode.com/gh_mirrors/zc/zclawzclaw 是一款运行在 ESP32 上的超小型 AI 个人助手固件全部固件仅约 888 KiB支持 GPIO 控制、定时任务、持久记忆和自定义工具。对很多新手来说最大的门槛是改一行 C 代码 → 编译 → 烧录开发板 → 重新配置一轮循环要十分钟起步。好消息是 zclaw 提供了一套不用烧板也能快速 hacking ESP32 固件的本地开发工作流QEMU 模拟器 主机端单元测试让迭代速度从分钟级降到秒级。为什么 ESP32 开发总离不开烧板传统 ESP-IDF 开发循环是这样的修改 C 源码idf.py build编译1~3 分钟烧录到开发板还要占用串口打开串口监视器看日志改错了回到第 1 步对于 zclaw 这种逻辑复杂的固件LLM 请求、工具调度、限流、记忆持久化……每烧一次板验证一个小改动非常痛苦。zclaw 的解法是把测试和运行分两层层级工具需要硬件速度主机单元测试./scripts/test.sh host❌秒级QEMU 模拟运行./scripts/emulate.sh❌秒级真机烧录验证./scripts/flash.sh✅分钟级核心思路大部分时间在前两层干活只在最终验收时才碰开发板。一键准备工作克隆仓库并安装环境git clone https://gitcode.com/gh_mirrors/zc/zclaw cd zclaw ./install.sh -y安装脚本会自动处理依赖Linux 下自动识别 apt/pacman/dnf/zypper包括 ESP-IDF 工具链、QEMU用于模拟运行和 cJSON用于主机测试。如果后面要用到 QEMU 模拟确认系统已安装qemu-system-riscv32macOSbrew install qemuUbuntuapt install qemu-system-misc主机测试改完代码先跑这个scripts/test.sh 是 zclaw 的主要本地安全网。执行host子命令后它会在你的电脑上而非开发板上编译并运行一整套 C 单元测试./scripts/test.sh host这套测试覆盖的内容包括JSON 工具解析与工具调用逻辑—— test/host/test_tools_parse.cAgent 核心循环—— test/host/test_agent.cGPIO / I2C / DHT 工具的策略与安全护栏—— test/host/test_tools_gpio_policy.cLLM 认证与运行时stub 模式下测试真实的 main/llm.c限流器持久化、Telegram 更新解析、内存键、WiFi 凭据等几个值得新手注意的工程细节默认开启AddressSanitizer可用ASAN0关闭内存越界当场报错编译使用-Wall -Wextra -Werror级别的警告策略保证质量不回退ESP32 侧的 APIWiFi、NVS、FreeRTOS 等全部由 test/host/mock_esp.c、test/host/mock_freertos.c 等 mock 实现替代所以在普通 PC 上就能直接跑固件核心逻辑改完代码先跑test.sh host全绿再去模拟或烧板能省掉大量烧板才发现崩了的尴尬。QEMU 模拟运行在 PC 上跑一整块 ESP32-C3这是 zclaw 本地开发工作流中最惊艳的部分。scripts/emulate.sh 会以 QEMU 专用配置编译固件配置来自 sdkconfig.qemu.defaults把 bootloader、分区表和应用合并成一个 4MB 的完整镜像启动qemu-system-riscv32 -M esp32c3在终端里完整运行固件./scripts/emulate.sh # 退出模拟器CtrlA 然后按 XQEMU 配置做了两个关键 stub见 sdkconfig.qemu.defaultsCONFIG_ZCLAW_STUB_LLMyLLM 请求由固件内的 stub 应答不依赖真实网络CONFIG_ZCLAW_STUB_TELEGRAMyCONFIG_ZCLAW_CHANNEL_UARTy聊天通道从 Telegram 换成串口你在 QEMU 终端里直接输入文字就能和AI 助手对话也就是说在你的终端里你就是一个和 AI 设备聊天的人——可以测试命令解析、工具调用、记忆读写、定时任务逻辑全程不碰硬件。 QEMU 中 WiFi/TLS 不工作这是设计预期。需要真实 LLM 对话时可用./scripts/emulate.sh --live-api由 scripts/qemu_live_llm_bridge.py 在宿主机上代理转发请求需要你设置ANTHROPIC_API_KEY或OPENAI_API_KEY环境变量。如果模拟器进程意外残留用 scripts/exit-emulator.sh 一键清理./scripts/exit-emulator.sh有了模拟器真机流程还剩什么QEMU 负责快速迭代真机只负责最终验证。zclaw 的快速循环摘自官方 Local Dev 文档非常简洁./scripts/test.sh host # 1) 主机测试 ./scripts/build.sh # 2) 编译 ./scripts/flash.sh --kill-monitor /dev/cu.usbmodem1101 # 3) 烧录自动处理端口占用 ./scripts/provision-dev.sh --port /dev/cu.usbmodem1101 # 4) 从本地配置注入凭据 ./scripts/monitor.sh /dev/cu.usbmodem1101 # 5) 串口观察日志新手最容易忽略的一个提效技巧凭据配置一次之后不用重打。scripts/provision-dev.sh 支持本地配置文件./scripts/provision-dev.sh --write-template # 生成 ~/.config/zclaw/dev.env 模板 # 编辑模板填入 WiFi / API Key / Telegram token ./scripts/provision-dev.sh # 以后直接运行即可输出自动打码另外两个实用点正常烧录不会擦除 NVSWiFi/API 凭据默认保留改代码后直接flash.sh就行只改了运行时凭据跳过编译和烧录直接跑provision-dev.sh即可遇到问题怎么办实用调试清单症状解决方案串口报端口占用运行 scripts/release-port.sh 释放残留占用Telegram 重复播放旧消息运行./scripts/telegram-clear-backlog.sh --show-config想确认脚本将写入的值./scripts/provision-dev.sh --show-config --dry-run凭据彻底乱了scripts/erase.sh 的--nvs只擦配置保留固件--all全擦有确认护栏板子进安全模式 / 未配置用 USB 串口控制台/wifi scan、/gpio all、/reboot等本地命令救援总结这套工作流好在哪秒级反馈主机测试 QEMU 模拟让 90% 的迭代不需要硬件无硬件门槛没有 ESP32 开发板也能完整参与 zclaw 固件开发配置一次长期有效provision-dev.sh配置文件 NVS 保留省掉每次重配凭据有护栏擦除、安全模式等破坏性操作都有确认机制对想学习嵌入式 AI 项目的同学来说这套 主机测试 → QEMU 模拟 → 真机验收 的三层工作流本身就值得借鉴。快去仓库里试试改一个小工具在 QEMU 终端里看到它被 AI 调用吧 延伸阅读完整本地开发指南见 docs-site/local-dev.html更多脚本说明见 README.md 的 Other Useful Scripts 章节。【免费下载链接】zclawYour personal AI assistant at all-in 888KiB (~35KB in app code). Running on an ESP32. GPIO, cron, custom tools, memory, and more.项目地址: https://gitcode.com/gh_mirrors/zc/zclaw创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考