5浏览
查看: 5|回复: 4

[项目] 【花雕】超全整理:嵌入式 AI 调试MimicLaw命令速查手册

[复制链接]
副题:飞书机器人 + 串口调试 + 系统管理,嵌入式 AI 智能体调试必收藏


{花雕学编程,动手又动脑}

你是否想过——只用一块 30 元的 ESP32-S3 芯片,就能跑一个自带长期记忆、飞书对话、GPIO 控制、定时任务的 AI 智能体?

MimiClaw(曾用名 MimicLaw)正是这样一个轻量级嵌入式 AI 代理框架。它不需要 Linux、不需要树莓派,纯 C 语言实现,功耗仅 0.5W,却能通过串口 CLI 或飞书/Telegram 与你自然交流,并直接操控传感器与执行器。

然而,面对几十条命令,新手常常不知道从哪里开始:如何连 Wi-Fi?怎么配置飞书机器人?怎样让 AI 记住我的偏好?定时任务又该如何设置?

这里为你整理了一份超全、超实用的 MimiClaw 命令速查表,覆盖 14 大模块:系统基础、Wi‑Fi 与 AP 配网、LLM 模型配置、飞书/Telegram 机器人、上下文与长期记忆、文件系统(SPIFFS)、工具系统、网络工具、定时任务、日志调试以及配置管理。每条命令都附有说明和典型示例,让你一看就懂,一用就会。

无论你是刚拿到开发板的创客,还是想深度定制 AI 智能体的极客,这篇“命令全集”都值得收藏备用。文末还附赠了飞书版快速上手指南,10 分钟让你的 ESP32-S3 拥有一个 7×24 小时在线的 AI 助手。

开始你的嵌入式 AI 之旅吧!


【花雕】超全整理:嵌入式 AI 调试MimicLaw命令速查手册图1



驴友花雕  高级技神
 楼主|

发表于 2 小时前

【花雕】超全整理:嵌入式 AI 调试MimicLaw命令速查手册

ESP32S3连接电脑,打开ESP-IDF 5.5 的CMD

【花雕】超全整理:嵌入式 AI 调试MimicLaw命令速查手册图1

输入 cd mimiclaw 命令,进入mimiclaw项目

【花雕】超全整理:嵌入式 AI 调试MimicLaw命令速查手册图2

输入idf.py monitor命令,进入项目串口监视器

【花雕】超全整理:嵌入式 AI 调试MimicLaw命令速查手册图3


【花雕】超全整理:嵌入式 AI 调试MimicLaw命令速查手册图4




回复

使用道具 举报

驴友花雕  高级技神
 楼主|

发表于 1 小时前

【花雕】超全整理:嵌入式 AI 调试MimicLaw命令速查手册

进入后,串口监视器会给出一份长长的 mimiclaw 启动日志

【花雕】超全整理:嵌入式 AI 调试MimicLaw命令速查手册图1


全文启动日志如下

  1. D:\Espressif\frameworks\esp-idf-v5.5.3\mimiclaw>idf.py monitor
  2. Executing action: monitor
  3. Serial port COM7
  4. Connecting...
  5. Detecting chip type... ESP32-S3
  6. Running idf_monitor in directory D:\Espressif\frameworks\esp-idf-v5.5.3\mimiclaw
  7. Executing "D:\Espressif\python_env\idf5.5_py3.11_env\Scripts\python.exe D:\Espressif\frameworks\esp-idf-v5.5.3\tools/idf_monitor.py -p COM7 -b 115200 --toolchain-prefix xtensa-esp32s3-elf- --target esp32s3 --revision 0 D:\Espressif\frameworks\esp-idf-v5.5.3\mimiclaw\build\mimiclaw.elf D:\Espressif\frameworks\esp-idf-v5.5.3\mimiclaw\build\bootloader\bootloader.elf --force-color -m 'D:\Espressif\python_env\idf5.5_py3.11_env\Scripts\python.exe' 'D:\Espressif\frameworks\esp-idf-v5.5.3\tools\idf.py'"...
  8. --- Warning: GDB cannot open serial ports accessed as COMx
  9. --- Using \\.\COM7 instead...
  10. --- esp-idf-monitor 1.9.0 on \\.\COM7 115200
  11. --- Quit: Ctrl+] | Menu: Ctrl+T | Help: Ctrl+T followed by Ctrl+H
  12. ESP-ROM:esp32s3-20210327
  13. Build:Mar 27 2021
  14. rst:0x15 (USB_UART_CHIP_RESET),boot:0x28 (SPI_FAST_FLASH_BOOT)
  15. Saved PC:0x40048e22
  16. --- 0x40048e22: uart_rx_readbuff in ROM
  17. SPIWP:0xee
  18. mode:DIO, clock div:1
  19. load:0x3fce2820,len:0x16a4
  20. load:0x403c8700,len:0xe80
  21. --- 0x403c8700: _stext at ??:?
  22. load:0x403cb700,len:0x3188
  23. entry 0x403c8948
  24. --- 0x403c8948: call_start_cpu0 at D:/Espressif/frameworks/esp-idf-v5.5.3/components/bootloader/subproject/main/bootloader_start.c:27
  25. I (24) boot: ESP-IDF v5.5.3-dirty 2nd stage bootloader
  26. I (24) boot: compile time Mar 31 2026 20:46:13
  27. I (25) boot: Multicore bootloader
  28. I (25) boot: chip revision: v0.2
  29. I (25) boot: efuse block revision: v1.3
  30. I (25) qio_mode: Enabling default flash chip QIO
  31. I (25) boot.esp32s3: Boot SPI Speed : 80MHz
  32. I (26) boot.esp32s3: SPI Mode       : QIO
  33. I (26) boot.esp32s3: SPI Flash Size : 16MB
  34. I (26) boot: Enabling RNG early entropy source...
  35. I (26) boot: Partition Table:
  36. I (26) boot: ## Label            Usage          Type ST Offset   Length
  37. I (27) boot:  0 nvs              WiFi data        01 02 00009000 00006000
  38. I (27) boot:  1 otadata          OTA data         01 00 0000f000 00002000
  39. I (28) boot:  2 phy_init         RF data          01 01 00011000 00001000
  40. I (28) boot:  3 ota_0            OTA app          00 10 00020000 00200000
  41. I (28) boot:  4 ota_1            OTA app          00 11 00220000 00200000
  42. I (29) boot:  5 spiffs           Unknown data     01 82 00420000 00bd0000
  43. I (29) boot:  6 coredump         Unknown data     01 03 00ff0000 00010000
  44. I (30) boot: End of partition table
  45. I (30) esp_image: segment 0: paddr=00020020 vaddr=3c0d0020 size=3c724h (247588) map
  46. I (67) esp_image: segment 1: paddr=0005c74c vaddr=3fc9ce00 size=038cch ( 14540) load
  47. I (70) esp_image: segment 2: paddr=00060020 vaddr=42000020 size=c0ddch (789980) map
  48. I (188) esp_image: segment 3: paddr=00120e04 vaddr=3fca06cc size=01c00h (  7168) load
  49. I (189) esp_image: segment 4: paddr=00122a0c vaddr=40374000 size=18d04h (101636) load
  50. I (209) esp_image: segment 5: paddr=0013b718 vaddr=50000000 size=00020h (    32) load
  51. I (219) boot: Loaded app from partition at offset 0x20000
  52. I (219) boot: Disabling RNG early entropy source...
  53. I (220) octal_psram: vendor id    : 0x0d (AP)
  54. I (220) octal_psram: dev id       : 0x02 (generation 3)
  55. I (220) octal_psram: density      : 0x03 (64 Mbit)
  56. I (221) octal_psram: good-die     : 0x01 (Pass)
  57. I (221) octal_psram: Latency      : 0x01 (Fixed)
  58. I (221) octal_psram: VCC          : 0x01 (3V)
  59. I (221) octal_psram: SRF          : 0x01 (Fast Refresh)
  60. I (222) octal_psram: BurstType    : 0x01 (Hybrid Wrap)
  61. I (222) octal_psram: BurstLen     : 0x01 (32 Byte)
  62. I (222) octal_psram: Readlatency  : 0x02 (10 cycles@Fixed)
  63. I (222) octal_psram: DriveStrength: 0x00 (1/1)
  64. I (222) MSPI Timing: Enter psram timing tuning
  65. I (223) esp_psram: Found 8MB PSRAM device
  66. I (224) esp_psram: Speed: 80MHz
  67. I (224) cpu_start: Multicore app
  68. I (233) cpu_start: Pro cpu start user code
  69. I (233) cpu_start: cpu freq: 240000000 Hz
  70. I (233) app_init: Application information:
  71. I (233) app_init: Project name:     mimiclaw
  72. I (233) app_init: App version:      v0.1.1-dirty
  73. I (233) app_init: Compile time:     Mar 31 2026 20:45:54
  74. I (233) app_init: ELF file SHA256:  fa4448c9c...
  75. I (234) app_init: ESP-IDF:          v5.5.3-dirty
  76. I (234) efuse_init: Min chip rev:     v0.0
  77. I (234) efuse_init: Max chip rev:     v0.99
  78. I (234) efuse_init: Chip rev:         v0.2
  79. I (234) heap_init: Initializing. RAM available for dynamic allocation:
  80. I (235) heap_init: At 3FCA8C58 len 00040AB8 (258 KiB): RAM
  81. I (235) heap_init: At 3FCE9710 len 00005724 (21 KiB): RAM
  82. I (235) heap_init: At 3FCF0000 len 00008000 (32 KiB): DRAM
  83. I (235) heap_init: At 600FE000 len 00001FE8 (7 KiB): RTCRAM
  84. I (235) esp_psram: Adding pool of 8192K of PSRAM memory to heap allocator
  85. I (236) spi_flash: detected chip: boya
  86. I (236) spi_flash: flash io: qio
  87. I (237) sleep_gpio: Configure to isolate all GPIO pins in sleep state
  88. I (237) sleep_gpio: Enable automatic switching of GPIO sleep configuration
  89. I (238) main_task: Started on CPU0
  90. I (248) esp_psram: Reserving pool of 96K of internal memory for DMA/internal allocations
  91. I (248) main_task: Calling app_main()
  92. I (248) mimi: ========================================
  93. I (248) mimi:   MimiClaw - ESP32-S3 AI Agent
  94. I (248) mimi: ========================================
  95. I (248) mimi: Internal free: 303063 bytes
  96. I (248) mimi: PSRAM free:    8386192 bytes
  97. I (858) mimi: SPIFFS: total=11378081, used=7530
  98. I (858) bus: Message bus initialized (queue depth 16)
  99. I (858) memory: Memory store initialized at /spiffs
  100. I (858) skills: Initializing skills system
  101. I (1198) skills: Skills system ready (4 skills on SPIFFS)
  102. I (1198) session: Session manager initialized at /spiffs/sessions
  103. I (1198) pp: pp rom version: e7ae62f
  104. I (1198) net80211: net80211 rom version: e7ae62f
  105. I (1208) wifi:wifi driver task: 3fcee9e0, prio:23, stack:6656, core=0
  106. I (1208) wifi:wifi firmware version: 4df78f2
  107. I (1218) wifi:wifi certification version: v7.0
  108. I (1218) wifi:config NVS flash: enabled
  109. I (1218) wifi:config nano formatting: disabled
  110. I (1218) wifi:Init data frame dynamic rx buffer num: 6
  111. I (1218) wifi:Init static rx mgmt buffer num: 5
  112. I (1218) wifi:Init management short buffer num: 32
  113. I (1218) wifi:Init dynamic tx buffer num: 32
  114. I (1218) wifi:Init static tx FG buffer num: 2
  115. I (1218) wifi:Init static rx buffer size: 1600
  116. I (1218) wifi:Init static rx buffer num: 3
  117. I (1218) wifi:Init dynamic rx buffer num: 6
  118. I (1218) wifi_init: rx ba win: 3
  119. I (1218) wifi_init: accept mbox: 6
  120. I (1218) wifi_init: tcpip mbox: 16
  121. I (1218) wifi_init: udp mbox: 6
  122. I (1218) wifi_init: tcp mbox: 6
  123. I (1218) wifi_init: tcp tx win: 5760
  124. I (1218) wifi_init: tcp rx win: 5760
  125. I (1218) wifi_init: tcp mss: 1440
  126. I (1218) wifi_init: WiFi IRAM OP enabled
  127. I (1218) wifi_init: WiFi RX IRAM OP enabled
  128. I (1218) wifi: WiFi manager initialized
  129. W (1218) telegram: No Telegram bot token. Use CLI: set_tg_token <TOKEN>
  130. W (1218) feishu: No Feishu credentials. Use CLI: set_feishu_creds <APP_ID> <APP_SECRET>
  131. I (1218) llm: LLM proxy initialized (provider: openai, model: deepseek-chat)
  132. W (1218) web_search: No search API key. Use CLI: set_search_key or set_tavily_key
  133. I (1218) tools: Registered tool: web_search
  134. I (1218) tools: Registered tool: get_current_time
  135. I (1218) tools: Registered tool: read_file
  136. I (1218) tools: Registered tool: write_file
  137. I (1218) tools: Registered tool: edit_file
  138. I (1218) tools: Registered tool: list_dir
  139. I (1218) tools: Registered tool: cron_add
  140. I (1218) tools: Registered tool: cron_list
  141. I (1218) tools: Registered tool: cron_remove
  142. I (1218) tool_gpio: GPIO tool initialized (pin range 1-21)
  143. I (1218) tools: Registered tool: gpio_write
  144. I (1218) tools: Registered tool: gpio_read
  145. I (1218) tools: Registered tool: gpio_read_all
  146. I (1228) tools: Tools JSON built (12 tools)
  147. I (1228) tools: Tool registry initialized
  148. I (1628) cron: No cron file found, starting fresh
  149. I (1628) heartbeat: Heartbeat service initialized (file: /spiffs/HEARTBEAT.md, interval: 1800s)
  150. I (1628) agent: Agent loop initialized
  151. Type 'help' to get the list of commands.
  152. Use UP/DOWN arrows to navigate through command history.
  153. Press TAB when typing command name to auto-complete.
  154. Your terminal application does not support escape sequences.
  155. Line editing and history features are disabled.
  156. On Windows, try using Windows Terminal or Putty instead.
  157. mimi>  I (2618) cli: Serial CLI started
  158. I (2618) mimi: Serial CLI started. Type 'help' for commands.
  159. I (2618) wifi: Connecting to SSID: zhz3
  160. W (2628) wifi:Password length matches WPA2 standards, authmode threshold changes from OPEN to WPA2
  161. I (2628) phy_init: phy_version 711,97bcf0a2,Aug 25 2025,19:04:10
  162. I (2658) wifi:mode : sta (cc:ba:97:0e:0d:60)
  163. I (2658) wifi:enable tsf
  164. I (2658) mimi: Scanning nearby APs on boot...
  165. I (2668) wifi: Scanning nearby APs...
  166. W (2668) wifi: Disconnected (reason=36:UNKNOWN)
  167. W (2668) wifi: Disconnected, retry 1/10 in 1000ms
  168. W (3668) wifi: No APs found
  169. E (3668) wifi:sta is connecting, return error
  170. I (3668) mimi: Waiting for WiFi connection...
  171. I (4388) wifi:new:<7,0>, old:<1,0>, ap:<255,255>, sta:<7,0>, prof:1, snd_ch_cfg:0x0
  172. I (4398) wifi:state: init -> auth (0xb0)
  173. I (4458) wifi:state: auth -> assoc (0x0)
  174. I (4478) wifi:state: assoc -> run (0x10)
  175. I (4628) wifi:connected with zhz3, aid = 2, channel 7, BW20, bssid = 3c:cd:57:69:0f:3a
  176. I (4628) wifi:security: WPA2-PSK, phy: bgn, rssi: -37
  177. I (4628) wifi:pm start, type: 1
  178. I (4628) wifi:dp: 1, bi: 102400, li: 3, scale listen interval from 307200 us to 307200 us
  179. I (4628) wifi:set rx beacon pti, rx_bcn_pti: 0, bcn_timeout: 25000, mt_pti: 0, mt_time: 10000
  180. I (4708) wifi:AP's beacon interval = 102400 us, DTIM period = 1
  181. I (5128) wifi:<ba-add>idx:0 (ifx:0, 3c:cd:57:69:0f:3a), tid:0, ssn:2, winSize:64
  182. I (6328) esp_netif_handlers: sta ip: 192.168.28.161, mask: 255.255.255.0, gw: 192.168.28.1
  183. I (6328) wifi: Connected! IP: 192.168.28.161
  184. I (6328) mimi: WiFi connected: 192.168.28.161
  185. I (6328) onboard: ========================================
  186. I (6328) onboard:   Starting WiFi Configuration Portal
  187. I (6328) onboard: ========================================
  188. I (6328) wifi:mode : sta (cc:ba:97:0e:0d:60) + softAP (cc:ba:97:0e:0d:61)
  189. I (6328) wifi:Total power save buffer number: 16
  190. I (6328) wifi:Init max length of beacon: 752/752
  191. I (6328) wifi:Init max length of beacon: 752/752
  192. I (6338) esp_netif_lwip: DHCP server started on interface WIFI_AP_DEF with IP: 192.168.4.1
  193. I (6338) wifi:Total power save buffer number: 16
  194. I (6338) onboard: Soft AP started: MimiClaw-0D61 (open)
  195. I (6338) esp_netif_lwip: DHCP server started on interface WIFI_AP_DEF with IP: 192.168.4.1
  196. I (6338) onboard: HTTP server started on port 80
  197. I (6348) onboard: Connect to MimiClaw-XXXX WiFi, then open http://192.168.4.1
  198. I (6348) onboard: Local admin portal stays available while STA is connected
  199. I (6348) mimi: Outbound dispatch started
  200. I (6348) agent: agent_loop task created with stack=24576 bytes
  201. I (6348) agent: Agent loop started on core 1
  202. I (6348) ws: WebSocket server started on port 18789
  203. I (6348) mimi: All services started!
  204. I (6348) mimi: MimiClaw ready. Type 'help' for CLI commands.
  205. I (6348) main_task: Returned from app_main()
  206. mimi>
复制代码


回复

使用道具 举报

驴友花雕  高级技神
 楼主|

发表于 1 小时前

【花雕】超全整理:嵌入式 AI 调试MimicLaw命令速查手册


输入 help 命令,系统给出一份帮助文档

【花雕】超全整理:嵌入式 AI 调试MimicLaw命令速查手册图1


帮助文档全文



  1. mimi>  help
  2. help  [<string>] [-v <0|1>]
  3.   Print the summary of all registered commands if no arguments are given,
  4.   otherwise print summary of given command.
  5.       <string>  Name of command
  6.   -v, --verbose=<0|1>  If specified, list console commands with given verbose level
  7. set_wifi  <ssid> <password>
  8.   Set WiFi SSID and password (e.g. set_wifi MySSID MyPass)
  9.         <ssid>  WiFi SSID
  10.     <password>  WiFi password
  11. wifi_status
  12.   Show WiFi connection status
  13. wifi_scan
  14.   Scan and list nearby WiFi APs
  15. set_tg_token  <token>
  16.   Set Telegram bot token
  17.        <token>  Telegram bot token
  18. set_feishu_creds  <app_id> <app_secret>
  19.   Set Feishu app credentials (app_id app_secret)
  20.       <app_id>  Feishu App ID
  21.   <app_secret>  Feishu App Secret
  22. feishu_send  <receive_id> <text>
  23.   Send Feishu text: feishu_send <open_id|chat_id> "hello"
  24.   <receive_id>  Feishu open_id/chat_id
  25.         <text>  Text message (quote if contains spaces)
  26. set_api_key  <key>
  27.   Set LLM API key
  28.          <key>  LLM API key
  29. set_model  <model>
  30.   Set LLM model (default: claude-opus-4-5)
  31.        <model>  Model identifier
  32. set_model_provider  <provider>
  33.   Set LLM model provider (default: anthropic)
  34.     <provider>  Model provider (anthropic|openai)
  35. skill_list
  36.   List installed skills from /spiffs/skills/
  37. skill_show  <name>
  38.   Print full content of one skill file
  39.         <name>  Skill name (e.g. weather or weather.md)
  40. skill_search  <keyword>
  41.   Search skill files by keyword (filename + content)
  42.      <keyword>  Keyword to search in skills
  43. memory_read
  44.   Read MEMORY.md
  45. memory_write  <content>
  46.   Write to MEMORY.md
  47.      <content>  Content to write
  48. session_list
  49.   List all sessions
  50. session_clear  <chat_id>
  51.   Clear a session
  52.      <chat_id>  Chat ID to clear
  53. heap_info
  54.   Show heap memory usage
  55. set_search_key  <key>
  56.   Set Brave Search API key for web_search tool
  57.          <key>  Brave Search API key
  58. set_tavily_key  <key>
  59.   Set Tavily API key for web_search tool
  60.          <key>  Tavily Search API key
  61. set_proxy  <host> <port> [<type>]
  62.   Set proxy (e.g. set_proxy 192.168.1.83 7897 [http|socks5])
  63.         <host>  Proxy host/IP
  64.         <port>  Proxy port
  65.         <type>  Proxy type: http|socks5 (default: http)
  66. clear_proxy
  67.   Remove proxy configuration
  68. config_show
  69.   Show current configuration (build-time + NVS)
  70. config_reset
  71.   Clear all NVS overrides, revert to build-time defaults
  72. heartbeat_trigger
  73.   Manually trigger a heartbeat check
  74. cron_start
  75.   Start cron scheduler timer now
  76. tool_exec
  77.   Execute a registered tool: tool_exec <name> '{...json...}'
  78. web_search  <query>
  79.   Run web search tool directly (e.g. web_search "latest esp-idf")
  80.        <query>  Search query
  81. restart
  82.   Restart the device
  83. mimi>
复制代码


回复

使用道具 举报

驴友花雕  高级技神
 楼主|

发表于 1 小时前

【花雕】超全整理:嵌入式 AI 调试MimicLaw命令速查手册

## MimiClaw 嵌入式 AI 智能体命令全集:含飞书配置、串口调试、系统管理与常用指令汇总

提示符:mimi>
说明:本文所有命令均提取自 MimiClaw 内置 help 输出,已按功能重新分类,并补充典型用法。部分高级命令(如 tool_exec、cron_start)需理解 JSON 格式或定时器机制。

## 一、系统基础

命令        说明        示例
help [cmd] [-v]        列出所有命令或查看某命令详情        help set_wifi
restart        重启设备        配置变更后常用
heap_info        显示堆内存使用情况(空闲/最小剩余)        排查内存泄漏
config_show        显示当前所有配置(NVS + 编译期默认值)        检查 API Key、代理等
config_reset        清除所有 NVS 覆盖,恢复出厂编译期默认值        慎用
heartbeat_trigger        手动触发一次心跳检查(用于调试定时任务)        结合 cron 使用

## 二、Wi‑Fi 网络

命令        说明        示例
set_wifi <ssid> <password>        设置并连接 Wi‑Fi        set_wifi MyHome 12345678
wifi_status        查看当前连接状态(IP、信号强度等)        排查网络问题
wifi_scan        扫描周围 2.4G Wi‑Fi 热点        先扫描确认 SSID
ESP32-S3 仅支持 2.4GHz 频段,wifi_scan 不会列出 5G 网络。

## 三、代理配置

适用于需要通过代理访问 LLM API 或飞书的环境。

命令        说明        示例
set_proxy <host> <port> [type]        设置 HTTP 或 SOCKS5 代理        set_proxy 192.168.1.100 7890 http
clear_proxy        清除代理配置        恢复直连
代理类型默认为 http,可选 socks5。

## 四、LLM / AI 模型配置

命令        说明        示例
set_api_key <key>        设置 LLM API 密钥        set_api_key sk-xxxx
set_model <model>        设置模型名称(默认 claude-opus-4-5)        set_model deepseek-chat
set_model_provider <provider>        设置提供商(默认 anthropic)        set_model_provider openai

实际 LLM 连通性测试需通过飞书/TG 或 tool_exec 触发对话,无独立 llm test 命令。

## 五、飞书机器人

命令        说明        示例
set_feishu_creds <app_id> <app_secret>        设置飞书应用凭证        从飞书开放平台获取
feishu_send <receive_id> <text>        主动发送文本消息        feishu_send oc_xxxx "Hello"
重要:
receive_id 可以是 open_id(用户)或 chat_id(群聊),需通过飞书开放平台调试或接收事件获得。

飞书机器人启动是自动的(配置凭证后即生效),无需手动 start/stop。消息接收通过长连接,无需公网 IP。

## 六、Telegram 机器人

命令        说明        示例
set_tg_token <token>        设置 Telegram Bot Token        从 @BotFather 获取
机器人同样自动运行,无需额外 start/stop。

## 七、长期记忆(MEMORY.md)

记忆存储于 /spiffs/MEMORY.md,直接读写。

命令        说明        示例
memory_read        打印 MEMORY.md 的全部内容        查看当前记忆
memory_write <content>        覆盖写入 MEMORY.md        memory_write "用户喜欢25°C室温"
memory_write 会覆盖原有内容,如需追加,需先 memory_read 后手动拼接。

## 八、技能管理(Skills)

技能文件存放在 /spiffs/skills/ 下(Markdown 格式),定义 AI 可调用的工具。

命令        说明        示例
skill_list        列出所有已安装的技能文件        确认技能是否就绪
skill_show <name>        显示某个技能的完整内容        skill_show weather.md
skill_search <keyword>        在技能文件名和内容中搜索关键词        skill_search temperature

##九、会话管理(Session)

每个对话(飞书/TG 用户或群)有独立会话上下文。

命令        说明        示例
session_list        列出所有活跃会话及其 chat_id        查看哪些用户在对话
session_clear <chat_id>        清除指定会话的上下文(历史记忆)        session_clear oc_xxxx

## 十、工具执行(Tool Execution)

MimiClaw 内置或技能定义的工具,可通过 JSON 参数直接调用。

命令        说明        示例
tool_exec <name> '<json>'        执行指定工具,传入 JSON 参数        tool_exec web_search '{"query":"ESP32-S3"}'
常用内置工具(需先配置相应 API Key):

web_search – 网络搜索(需 set_search_key 或 set_tavily_key)

其他工具可通过 skill_list 发现

## 十一、网络搜索配置

为 web_search 工具提供 API 密钥(二选一)。

命令        说明        示例
set_search_key <key>        设置 Brave Search API 密钥        set_search_key BS_xxxx
set_tavily_key <key>        设置 Tavily API 密钥        set_tavily_key tvly-xxxx
配置后即可通过 tool_exec web_search '{"query":"..."}' 或直接使用 web_search 命令(见下节)。

## 十二、快捷搜索命令

命令        说明        示例
web_search <query>        直接执行网络搜索(需已配置搜索 API 密钥)        web_search "ESP32-S3 AI agent"

## 十三、定时任务(Cron)

MimiClaw 内置 cron 调度器,需手动启动。

命令        说明        示例
cron_start        启动 cron 调度器(定时任务生效)        配置好 cron 规则后执行
注意:当前版本未提供 cron_add/cron_list 等命令,定时规则可能需要通过配置文件(如 /spiffs/cron.json)预设。建议查阅固件文档。

## 十四、调试与信息

命令        说明        示例
heap_info        显示堆内存统计(总大小、当前空闲、最小剩余)        监控内存碎片
附:完整命令一览(按字母排序)

  1. clear_proxy
  2. config_reset
  3. config_show
  4. cron_start
  5. feishu_send
  6. heap_info
  7. help
  8. heartbeat_trigger
  9. memory_read
  10. memory_write
  11. restart
  12. session_clear
  13. session_list
  14. set_api_key
  15. set_feishu_creds
  16. set_model
  17. set_model_provider
  18. set_proxy
  19. set_search_key
  20. set_tavily_key
  21. set_tg_token
  22. set_wifi
  23. skill_list
  24. skill_search
  25. skill_show
  26. tool_exec
  27. web_search
  28. wifi_scan
  29. wifi_status
复制代码

共计 28 条 命令(不含 help 内部变体)。



快速上手示例(飞书 + DeepSeek)

  1. #1. 连接 Wi‑Fi
  2. mimi> set_wifi MySSID MyPassword
  3. mimi> wifi_status          # 应显示 IP
  4. #2. 配置 LLM(DeepSeek 兼容 OpenAI 格式)
  5. mimi> set_model_provider openai
  6. mimi> set_api_key sk-xxxx
  7. mimi> set_model deepseek-chat
  8. #3. 配置飞书
  9. mimi> set_feishu_creds cli_xxx secret_xxx
  10. #此时机器人已自动上线,可接收飞书消息
  11. #4. (可选)配置网络搜索
  12. mimi> set_tavily_key tvly-xxxx
  13. #5. 查看当前配置
  14. mimi> config_show
  15. #6. 测试记忆
  16. mimi> memory_write "用户昵称:花雕"
  17. mimi> memory_read
复制代码


## 结语

本速查表完全基于 MimiClaw 官方 help 输出整理,不添加未出现的命令,确保每一条都可直接在 mimi> 提示符下执行。建议收藏本文,或在串口终端中输入 help 随时查阅。随着固件更新,命令集可能变化,请以设备实际 help 为准。

Happy Clawing!

回复

使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

为本项目制作心愿单
购买心愿单
心愿单 编辑
[[wsData.name]]

硬件清单

  • [[d.name]]
btnicon
我也要做!
点击进入购买页面
上海智位机器人股份有限公司 沪ICP备09038501号-4 备案 沪公网安备31011502402448

© 2013-2026 Comsenz Inc. Powered by Discuz! X3.4 Licensed

mail