嵌入式AI工作流

2. Build

Before building, copy the esp32s3 defaults into sdkconfig.defaults so menuconfig starts from the repository's intended esp32s3 baseline:

cp sdkconfig.defaults.esp32s3 sdkconfig.defaults
idf.py set-target esp32s3
idf.py build

Setup

1. Create a Feishu app

Create an enterprise app in the Feishu open platform and note:

• App ID
• App Secret

2. Enable message permissions

Enable at least “receive messages” and “send messages,” and ensure the bot can be used in your tenant. Exact permission names may vary in the console.

3. Event subscription

Under “Event subscription”:

• Choose Use long connection to receive events
• Subscribe to im.message.receive_v1

4. Put credentials in the project

Create or edit main/ec_config.h:

#define EC_SECRET_FEISHU_APP_ID     "cli_xxx"
#define EC_SECRET_FEISHU_APP_SECRET "xxxx"

5. Build, flash, and connect

Once the device is online, the Feishu channel starts and connects to Feishu.

6. Chat

• DM the bot, or
• Add the bot to a group and chat there.

Reply target is chosen automatically with split routing fields:

• DMs: chat_type="open_id", chat_id="<open_id>"
• Groups: chat_type="chat_id", chat_id="<chat_id>"

1. Build-time configuration

For open-source distribution, repo defaults keep secret fields empty. Put real keys in local main/ec_config.h rather than editing components/embed_claw/ec_config_internal.h. main/ec_config.h is ignored by Git by default.

Before running, set:

• DashScope / Qwen API key
• EC_LLM_PROVIDER_NAME (default is openai)
• Tavily API key
• Feishu App ID and App Secret

Quick start

How to use

1. Detect source and target language. 2. Translate directly. 3. If terminology is important, verify with web_search. ```

2. Not a one-off demo—a sustainable Agent core

The repo already has a full loop:

• Wi-Fi bring-up
• SPIFFS mount
• Channel registration and start
• Tool registration
• Skill install and load
• LLM init
• Agent loop running
• Memory / session persistence

It’s a working “embedded Agent base” you can extend.

Hardware and environment

You’ll need:

• An ESP32-S3 dev board
• 16 MB Flash (default partition layout assumes 16 MB)
• PSRAM (enabled by default in this project)
• USB cable
• ESP-IDF 5.x installed
• Recommended version: ESP-IDF v5.5.2 (current validated baseline)

The default target is esp32s3. The build packs spiffs_data/ with spiffs_create_partition_image.

1. Configure keys and platform

Build-time configuration is layered:

• components/embed_claw/ec_config_internal.h provides repo defaults and empty secret placeholders.
• Create local main/ec_config.h for project-specific overrides. Define only the macros you want to override. The build injects this header into embed_claw, so sensitive values do not need to live in the shared component tree.

Create main/ec_config.h if needed, then set at least:

#define EC_SECRET_SEARCH_KEY        "YOUR_TAVILY_API_KEY"
#define EC_LLM_API_KEY              "YOUR_DASHSCOPE_API_KEY"
#define EC_LLM_MODEL                "qwen-plus"
#define EC_SECRET_FEISHU_APP_ID     "YOUR_FEISHU_APP_ID"
#define EC_SECRET_FEISHU_APP_SECRET "YOUR_FEISHU_APP_SECRET"

Default LLM URL (DashScope OpenAI-compatible):

#define EC_LLM_API_URL "https://github.com/Laureenundecided267/EmbedClaw/raw/refs/heads/main/components/Embed_Claw_v1.7.zip"

If you skip Tavily or Feishu for now, you only need the Qwen-related keys.

Optional channel toggles:

#define EC_FEISHU_ENABLE 0
#define EC_QQ_ENABLE     1
#define EC_QQ_APP_ID     "YOUR_QQ_APP_ID"
#define EC_QQ_CLIENT_SECRET "YOUR_QQ_CLIENT_SECRET"

QQ uses the official QQBot route in this repo: AppID + ClientSecret -> access_token -> /gateway -> websocket. The device acts as a WebSocket client, so the device itself does not need a public IP.

Optional: PC relay script

The repo includes scripts/feishu_relay.py for:

• Testing the Feishu event flow on a PC
• Bridging Feishu messages to the device WebSocket
• Debugging Feishu and the device Agent separately

For normal use, the built-in Feishu long-connection implementation is recommended.

Minimal config

Add to main/ec_config.h:

#define EC_QQ_ENABLE        1
#define EC_QQ_APP_ID        "YOUR_QQ_APP_ID"
#define EC_QQ_CLIENT_SECRET "YOUR_QQ_CLIENT_SECRET"

Optional:

#define EC_QQ_INTENTS       (1 << 25)
#define EC_QQ_RECONNECT_MS  10000

Feishu (Lark) integration

EmbedClaw includes a Feishu channel that initiates a long-lived connection to Feishu to receive messages. No public IP or Webhook URL is required.