奥托克劳

真正运行在本地端侧 — 0.5W 永不关机

<p align="center"><img src="assets/highlights/local_agent.jpg" width="800"></p>

• USB 供电，纯 C / FreeRTOS，单块 ESP32-S3 即可运行全部功能
• 不依赖云端服务器，记忆、会话、技能全部本地存储
• 24/7 在线，0.5W 功耗，无需维护
• 无 Linux、无 Node.js、无臃肿依赖

快速上手

第二步：进入配置门户

烧录完成后，设备因无 WiFi 配置将自动进入配置门户模式。你也可以随时通过以下方式主动进入配网模式：

• 短按 BOOT 键 — 运行中随时短按一下 BOOT 键即可重新进入配置门户
• 连接失败自动触发 — WiFi 密码错误或大模型密钥无效时，设备自动进入配网模式，并在 LCD 屏幕上显示具体错误原因（如"WiFi密码错误"、"密钥无效"）

连接配置门户

1. 手机打开 WiFi 设置，找到热点 OttoClaw-XXXX（无密码），点击连接
2. 连接成功后浏览器会自动跳转到配置页面（Captive Portal）。如果没有自动跳转，手动打开 http://192.168.4.1
3. 页面顶部显示 5 个标签页：WiFi、大模型、钉钉、其他、动作测试

第三步：配置 WiFi

1. 点击顶部 WiFi 标签页
2. 点击 扫描周边 按钮，等待几秒后下方出现附近 WiFi 列表
3. 点击列表中你的 WiFi 名称（自动填入 SSID），或手动输入 WiFi 名称
4. 在「WiFi密码」输入框填写密码
5. 点击 保存WiFi 按钮

第四步：配置大模型（必配）

OttoClaw 支持两种大模型接口格式，用户只需选择格式并填入自己的 API Key 和 Base URL：

你只需要输入 Base URL（基础路径），系统会自动补全对应的 API 路径。例如：

• OpenAI兼容 + 通义千问：Base URL 填 https://dashscope.aliyuncs.com/compatible-mode/v1 → 系统自动补全 /chat/completions
• Anthropic兼容 + DashScope Anthropic端：Base URL 填 https://dashscope.aliyuncs.com/apps/anthropic → 系统自动补全 /v1/messages
• OpenAI兼容 + DeepSeek：Base URL 填 https://api.deepseek.com/v1 → 系统自动补全 /chat/completions
• Anthropic兼容 + Anthropic官方：Base URL 填 https://api.anthropic.com → 系统自动补全 /v1/messages

Base URL 留空则使用默认地址（Anthropic兼容默认 https://api.anthropic.com，OpenAI兼容默认 https://api.openai.com/v1）

配置步骤：

1. 在配置门户点击 大模型 标签页
2. 「服务商」下拉框选择格式：Anthropic兼容 或 OpenAI兼容
3. 「API Key」输入你从大模型平台获取的 Key
4. 「模型名称」填写具体模型名（如 qwen-max、deepseek-chat、claude-sonnet-4-5）
5. 「Base URL」填写对应平台的基础路径（见上方示例）
6. 点击 保存 按钮

获取 API Key：

• 通义千问（国内推荐，无需代理）：电脑打开 DashScope 控制台 → 开通服务 → API-KEY 管理 → 创建 API Key → 选择 OpenAI兼容格式 → Base URL 填 https://dashscope.aliyuncs.com/compatible-mode/v1
• DeepSeek（国内直连，性价比高）：电脑打开 DeepSeek 开放平台 → API Keys → 创建 → 选择 OpenAI兼容格式 → Base URL 填 https://api.deepseek.com/v1
• Anthropic Claude（需代理）：电脑打开 Anthropic Console → Create API Key → 选择 Anthropic兼容格式 → Base URL 填 https://api.anthropic.com → 还需在「其他」标签页配置 HTTP 代理

第五步：配置钉钉（必配）

钉钉是 OttoClaw 的主要交互通道，不配置钉钉则无法与机器人聊天。

创建钉钉机器人

1. 电脑浏览器打开 钉钉开放平台，登录钉钉账号 2. 点击「应用开发」→「创建应用」 3. 应用类型选择「机器人」（不要选其他类型） 4. 填写应用名称（如"OttoClaw"）和描述 → 点击创建 5. 创建成功后进入应用详情页，在左侧菜单找到「凭证与基础信息」→ 复制 App Key 和 App Secret 6. 关键步骤 — 开通消息接收权限： - 在左侧菜单找到「事件订阅」或「消息接收」 - 消息接收模式必须选择「Stream 模式」（切勿选择 HTTP 回调，否则 OttoClaw 无法收到消息） - 确认已开通以下权限： - chatbot.message.read — 机器人读取消息 - chatbot.message.send — 机器人发送消息 - im.message.send — 发送单聊消息 - 如果权限列表中有「申请权限」按钮，点击申请全部相关权限 7. 机器人发布：点击「版本管理与发布」→「发布」→ 选择发布范围（建议先选自己可见测试）

在配置门户填入钉钉信息

1. 回到手机配置门户，点击 钉钉 标签页
2. 「App Key」粘贴刚才复制的 App Key
3. 「App Secret」粘贴 App Secret
4. 点击 保存 按钮

配置完成后，在钉钉中找到你的机器人，发送一条消息测试是否正常响应。

第六步：配置搜索与百炼（可选）

如需让 OttoClaw 联网搜索信息：

1. 电脑打开 百炼平台 → 登录阿里云账号
2. 点击「创建应用」→ 编辑应用 → 配置联网搜索功能 → 上线应用
3. 复制 App ID（格式如 758d9af4xxxx）
4. 在「API-KEY 管理」创建或复制 API Key（与 DashScope 共用同一个 Key）
5. 回到手机配置门户，点击 其他 标签页
6. 「搜索 API Key」填写 DashScope API Key
7. 「百炼搜索 App ID」填写刚才的 App ID
8. 点击 保存搜索配置

第七步：配置 HTTP 代理（可选）

国内用户访问 Anthropic Claude 等海外 API 时可能需要代理：

1. 在配置门户点击 其他 标签页
2. 「代理 Host」填写代理服务器 IP（如 192.168.1.83）
3. 「代理 Port」填写代理端口（如 7897，即 Clash/V2Ray 的 HTTP 端口）
4. 点击 保存代理

CLI 命令（高级用户参考）

配置门户可完成所有日常配置。以下 CLI 命令供高级用户通过 USB 串口调试使用（波特率 115200）：

oc> wifi_set <ssid> <pass>        设置 WiFi
oc> set_dingtalk <key> <secret>   设置钉钉凭据
oc> set_api_key <key>             设置大模型 API Key
oc> set_model <model>             设置模型名称
oc> set_model_provider <provider> 设置提供商（anthropic / openai_compat）
oc> set_base_url <url>            设置 Base URL
oc> set_search_key <key>          设置搜索 API Key
oc> set_bailian_app_id <id>       设置百炼 App ID
oc> set_proxy <host> <port>       设置 HTTP 代理
oc> clear_proxy                   移除代理设置
oc> config_show                   显示当前配置
oc> config_reset                  清除运行时配置
oc> restart                       重启设备
oc> wifi_status                   显示 WiFi 状态与 IP
oc> wifi_scan                     扫描附近 WiFi
oc> memory_read                   显示长期记忆内容
oc> memory_write "内容"           写入长期记忆
oc> heap_info                     显示可用堆内存
oc> session_list                  列出聊天会话

---

全栈开源 + 全开放架构 — 自选模型、自选通道

<p align="center"><img src="assets/highlights/open_source.jpg" width="800"></p>

OttoClaw 不锁定任何平台，所有配置完全开放：

• 2 种 LLM 格式 — Anthropic兼容 + OpenAI兼容，用户自定义 Base URL 即可接入任意模型
• 钉钉 Stream 直连 — 无需公网服务器，安静陪聊
• 阿里云百炼一键接入 — 搜索增强、Agent 应用、MCP 服务、Skill 技能包
• HTTP 代理支持 — Clash/V2Ray/Shadowsocks 兼容
• 配置门户 + 串口 CLI 双入口 — 手机浏览器配网，命令行运维
• 硬件、软件、3D 模型全部开源