只知道小龙虾 OpenClaw？其实还有这些迷你龙虾

┌──────────────────────────────────────────┐
│  不可信区域（UNTRUSTED ZONE）             │
│  WhatsApp / Telegram 消息（可能含恶意指令）│
└────────────────────┬─────────────────────┘
                     ↓ 触发词检查 + 输入转义
┌──────────────────────────────────────────┐
│  宿主进程（HOST PROCESS，受信任）         │
│  • 消息路由  • IPC 授权                   │
│  • 挂载点校验  • 容器生命周期管理          │
│  • 凭证过滤（禁止泄露 API Key）           │
└────────────────────┬─────────────────────┘
                     ↓ 仅挂载明确声明的目录
┌──────────────────────────────────────────┐
│  容器（CONTAINER，完全隔离）              │
│  • Agent 执行  • Bash 命令                │
│  • 文件操作（限于挂载目录）               │
│  • 网络访问（不受限）                     │
└──────────────────────────────────────────┘

# 第一步：Fork 并克隆
gh repo fork qwibitai/nanoclaw --clone
cd nanoclaw

# 第二步：启动 Claude Code CLI
claude

# 第三步：在 Claude Code 中执行 /setup 命令
# Claude 会自动完成：
#   - npm install
#   - 构建容器镜像（./container/build.sh）
#   - 引导配置 API Key
#   - 扫描 QR Code 接入 WhatsApp
#   - 注册系统服务（macOS launchd / Linux systemd）

/add-whatsapp        # 接入 WhatsApp（Baileys 库）
/add-telegram        # 接入 Telegram Bot
/add-discord         # 接入 Discord 服务器
/add-slack           # 接入 Slack 工作区
/add-gmail           # 接入 Gmail（Composio OAuth）
/convert-to-docker   # 切换到 Docker 后端
/convert-to-apple-container  # 切换到 Apple Container
/debug               # 诊断当前运行状态
/customize           # 自然语言描述需求，Claude 帮你改代码

npm run dev      # 热重载开发模式
npm run build    # 编译 TypeScript
npm run start    # node dist/index.js（生产启动）
npm run test     # vitest 跑单元测试
npm run typecheck  # tsc --noEmit 类型检查
npm run format   # prettier 格式化

# 容器管理
./container/build.sh       # 重建 Agent 容器镜像

# 服务管理（macOS）
launchctl load ~/Library/LaunchAgents/com.nanoclaw.plist
launchctl unload ~/Library/LaunchAgents/com.nanoclaw.plist

# 服务管理（Linux）
systemctl --user start nanoclaw
systemctl --user enable nanoclaw

Core 0（I/O 核）                    Core 1（AI 核）
─────────────────────────────       ──────────────────────────────
tg_poll_task                        agent_loop_task
  └─ Telegram HTTPS 长轮询           └─ ReAct 循环（最多 10 次迭代）
outbound_dispatch_task                  ├─ 加载会话历史（SPIFFS JSONL）
  └─ 发送响应消息                       ├─ 构建系统提示（SOUL.md + USER.md + MEMORY.md）
ws_server（端口 18789，最多 4 客户端）  ├─ 构建 cJSON 消息数组
serial_cli                              ├─ HTTPS 调用 Claude/OpenAI API
                                        ├─ 解析 tool_use 块 → 执行工具
                                        └─ 写回会话文件（Ring Buffer 20 条）

// 核心消息结构
typedef struct {
    char  channel[16];    // "telegram" / "websocket" / "cli"
    char  chat_id[32];    // Telegram 聊天 ID 或 WebSocket 客户端 ID
    char *content;        // 堆分配文本（所有权随 Push 转移，接收方负责 free()）
} mimi_msg_t;

// 两个队列
QueueHandle_t g_inbound_queue;   // I/O → AI
QueueHandle_t g_outbound_queue;  // AI → I/O

// 伪代码展示 agent_loop 核心逻辑
void agent_loop_task(void *arg) {
    mimi_msg_t msg;
    while (1) {
        xQueueReceive(g_inbound_queue, &msg, portMAX_DELAY);

        // 1. 加载会话历史（SPIFFS JSONL，Ring Buffer 最多 20 条）
        session_load(msg.chat_id, &history);

        // 2. 构建系统提示（从 SPIFFS 文件组装）
        //    SOUL.md + USER.md + MEMORY.md + 当日日记 + 工具描述
        build_system_prompt(ctx_buf, sizeof(ctx_buf));

        // 3. ReAct 循环（最多 10 次）
        for (int iter = 0; iter < 10; iter++) {
            // 调用 Claude/OpenAI HTTPS API（阻塞，非流式）
            llm_call(messages, tools_schema, &response);

            if (response.stop_reason == STOP_TOOL_USE) {
                // 执行所有 tool_use 块，结果追加到消息数组
                for each tool_call in response.tool_calls:
                    tool_execute(tool_call.name, tool_call.input, &tool_result);
                    messages_append_tool_result(&tool_result);
                continue;  // 下一次迭代
            } else {
                // stop_reason == "end_turn"，得到最终响应
                break;
            }
        }

        // 4. 保存会话，推送响应到出站队列
        session_save(msg.chat_id, &messages);
        xQueueSend(g_outbound_queue, &response_msg, portMAX_DELAY);
        free(msg.content);
    }
}

/spiffs/
├── config/
│   ├── SOUL.md          ← AI 人格定义（可自定义）
│   └── USER.md          ← 用户信息与偏好
├── memory/
│   ├── MEMORY.md        ← 长期持久记忆
│   └── 2026-02-05.md    ← 当日日记（每天一个文件）
├── sessions/
│   └── tg_12345678.jsonl ← 每个 Telegram 会话的对话历史
├── cron.json            ← 持久化的定时任务配置
└── HEARTBEAT.md         ← 自主任务清单

I am MimiClaw, a personal AI assistant running on an ESP32-S3.
Personality: Helpful and friendly. Concise and to the point.

# 1. 克隆项目
git clone https://github.com/memovai/mimiclaw.git
cd mimiclaw

# 2. 设置目标芯片
idf.py set-target esp32s3

# 3. 配置密钥（必须步骤）
cp main/mimi_secrets.h.example main/mimi_secrets.h

#define MIMI_SECRET_WIFI_SSID       "你的WiFi名称"
#define MIMI_SECRET_WIFI_PASS       "你的WiFi密码"
#define MIMI_SECRET_TG_TOKEN        "从 @BotFather 获取的 Bot Token"
#define MIMI_SECRET_API_KEY         "sk-ant-api03-xxxxx"    // Anthropic API Key
#define MIMI_SECRET_MODEL_PROVIDER  "anthropic"             // 或 "openai"
#define MIMI_SECRET_SEARCH_KEY      ""                      // Brave Search API Key
#define MIMI_SECRET_TAVILY_KEY      ""                      // Tavily Key（推荐）
// 国内用户必须配置代理：
#define MIMI_SECRET_PROXY_HOST      "10.0.0.1"              // 局域网代理 IP
#define MIMI_SECRET_PROXY_PORT      "7897"                  // Clash/V2Ray 端口

# 4. 编译并烧录
idf.py fullclean && idf.py build
idf.py -p /dev/ttyUSB0 flash monitor

# 一键脚本（Ubuntu）
./scripts/setup_idf_ubuntu.sh  # 首次安装 ESP-IDF
./scripts/build_ubuntu.sh      # 编译 + 烧录

# 一键脚本（macOS）
./scripts/setup_idf_macos.sh
./scripts/build_macos.sh

# 使用预编译固件（v0.1.0，最快速）
esptool.py --chip esp32s3 -b 460800 write_flash 0x0 mimiclaw-full-v0.1.0.bin

# 打开串口监视器后输入命令：
mimi> wifi_set MySSID MyPassword       # 修改 WiFi
mimi> set_api_key sk-ant-api03-...     # 更新 API Key
mimi> set_model_provider openai        # 切换到 OpenAI
mimi> set_model gpt-4o                 # 更换模型
mimi> set_proxy 127.0.0.1 7897        # 设置代理（国内必备）
mimi> clear_proxy                      # 清除代理
mimi> memory_read                      # 查看 AI 的长期记忆
mimi> memory_write "用户喜欢简短的回答"  # 手动写入记忆
mimi> session_list                     # 列出所有会话
mimi> session_clear 12345678           # 清除某个会话
mimi> heap_info                        # 查看剩余 RAM
mimi> restart                          # 重启设备

# partitions.csv
nvs,      data, nvs,    0x9000,  0x5000,
otadata,  data, ota,    0xe000,  0x2000,
app0,     app,  ota_0,  0x10000, 0x300000,   ← 主分区（~3MB）
app1,     app,  ota_1,  0x310000,0x300000,   ← OTA 分区（~3MB）
spiffs,   data, spiffs, 0x610000,0xBF0000,   ← 数据分区（12MB）

内存分层策略：
  内部 SRAM（~512KB）── 任务栈、WiFi 驱动缓冲区
       ↓ SPIRAM_MALLOC_ALWAYSINTERNAL=2048
  外部 PSRAM（8MB） ── LLM 流缓冲区、TLS 握手、上下文构建
       ↓ MBEDTLS_EXTERNAL_MEM_ALLOC=y
  SPIFFS Flash（12MB）── 会话历史、人格文件、记忆文件

WiFi 优化：
  静态 RX 缓冲区：3（从默认 10 降低）
  动态 RX 缓冲区：6
  BA Window：3

# build.zig 关键配置（影响最终二进制大小）
if (optimize != .Debug) {
    exe.root_module.strip = true;           // 剥离调试符号
    exe.root_module.unwind_tables = .none;  // 移除展开表
    exe.root_module.omit_frame_pointer = true; // 省略帧指针
}
exe.dead_strip_dylibs = true;  // 删除未使用的动态库

# macOS 额外剥离本地符号
# strip -x nullclaw

# 安装 Zig 0.15.2（Linux x86_64）
curl -L https://ziglang.org/download/0.15.2/zig-linux-x86_64-0.15.2.tar.xz | tar -xJ
sudo mv zig-linux-x86_64-0.15.2 /usr/local/zig
sudo ln -s /usr/local/zig/zig /usr/local/bin/zig

# 克隆并编译（ReleaseSmall = 最小体积）
git clone https://github.com/nullclaw/nullclaw.git
cd nullclaw
zig build -Doptimize=ReleaseSmall
sudo cp zig-out/bin/nullclaw /usr/local/bin/

# 验证
nullclaw --version   # 输出 v2026.3.5（CalVer）

# 交互式初始化向导
nullclaw onboard --interactive
# 或快速初始化
nullclaw onboard --api-key sk-... --provider openrouter

# 单条消息
nullclaw agent -m "帮我查一下明天北京的天气"

# 交互式对话
nullclaw agent

# 启动 HTTP Gateway（默认绑定 127.0.0.1:3000）
nullclaw gateway
nullclaw gateway --port 8080

# 指定模型
nullclaw agent -m "你好" --provider anthropic --model claude-opus-4-5-20251101

# 通道管理
nullclaw channel status
nullclaw channel start telegram
nullclaw channel start discord
nullclaw channel start dingtalk    # 国内常用！

# 一键从 OpenClaw 迁移
nullclaw migrate openclaw --dry-run    # 预览迁移效果
nullclaw migrate openclaw              # 执行迁移

# 系统诊断
nullclaw status
nullclaw doctor

# 注册为系统服务
nullclaw service install
nullclaw service start
nullclaw service status

# 运行全部测试（5100+）
zig build test --summary all

# 查看硬件外设
nullclaw peripherals scan

// 以 Provider（AI 提供商）为例
pub const Provider = struct {
    ptr: *anyopaque,
    vtable: *const VTable,

    pub const VTable = struct {
        complete: *const fn (ptr: *anyopaque, req: Request) Error!Response,
        stream:   *const fn (ptr: *anyopaque, req: Request, cb: StreamCallback) Error!void,
        models:   *const fn (ptr: *anyopaque) Error![]Model,
        deinit:   *const fn (ptr: *anyopaque) void,
    };
};

CLI            - 命令行直接交互
Telegram       - Bot API
Signal         - Signal Private Messenger
Discord        - Gateway
Slack          - Events API
iMessage       - macOS 原生（Apple Script）
Matrix         - 去中心化协议
WhatsApp       - 非官方协议
Email          - IMAP/SMTP
IRC            - 经典协议
Webhook        - 通用 HTTP 回调
Lark/飞书      - ✅ 国内常用
DingTalk/钉钉  - ✅ 国内常用
OneBot         - QQ 协议框架
QQ             - ✅ 国内常用
Line           - 亚太市场
Nostr          - 去中心化社交
MaixCam        - 嵌入式摄像头板
Mattermost     - 开源企业 IM

记忆架构：
┌─────────────────────────────────────────────┐
│                  SQLite DB                   │
├───────────────────┬─────────────────────────┤
│  向量子系统        │  关键词子系统            │
│  ─────────────── │  ──────────────────────  │
│  嵌入向量 BLOB    │  FTS5 全文搜索            │
│  余弦相似度计算    │  BM25 评分               │
│  （进程内计算）    │  精确关键词匹配           │
└───────────────────┴─────────────────────────┘
         ↓ 混合融合（默认 0.7 向量 + 0.3 关键词）
         ↓ 归一化评分 → 最优上下文窗口

{
  "default_temperature": 0.7,
  "models": {
    "providers": {
      "openrouter": {
        "api_key": "sk-or-v1-xxxxxxxx"
      },
      "anthropic": {
        "api_key": "sk-ant-api03-xxxxxxxx",
        "base_url": "https://api.anthropic.com"
      },
      "ollama": {
        "base_url": "http://localhost:11434"
      }
    }
  },
  "channels": {
    "telegram": {
      "accounts": {
        "main": {
          "bot_token": "123456:ABC-DEF1234",
          "allow_from": ["your_username"],
          "proxy": "socks5://127.0.0.1:7897"
        }
      }
    },
    "dingtalk": {
      "accounts": {
        "work": {
          "webhook_token": "xxxxxxxx"
        }
      }
    }
  },
  "memory": {
    "backend": "sqlite",
    "auto_save": true,
    "embedding_provider": "openai",
    "vector_weight": 0.7,
    "keyword_weight": 0.3,
    "hygiene": {
      "enabled": true,
      "max_age_days": 90
    }
  },
  "security": {
    "sandbox": "auto",
    "workspace_only": true,
    "audit_log": true
  }
}

# 扫描可用外设
nullclaw peripherals scan

# 连接 Arduino（JSON 串行协议）
nullclaw peripherals connect arduino --port /dev/ttyACM0

# Raspberry Pi GPIO 直接访问
nullclaw peripherals connect rpi-gpio

# STM32/Nucleo（通过 probe-rs 烧录）
nullclaw peripherals connect stm32 --chip STM32F401RE