企业官网建设流程全解析

在《行空板 K10 部署 MimiClaw开机上手指南》中我们完成了固件烧录、Wi-Fi 配置和飞书机器人对接在飞书聊天框里对着你的 K10 发送了第一条消息。但如果尝试问它“今天北京天气怎么样”或“ESP32-S3 有多少 GPIO”你可能收到了这样的报错web_search status: ESP_ERR_INVALID_STATE Error: No search API key configured. Set MIMI_SECRET_TAVILY_KEY or MIMI_SECRET_SEARCH_KEYinmimi_secrets.h这不代表你的 MimiClaw 出了问题恰恰相反——报错信息本身就是最好的提示你的 Wi-Fi 连接正常、设备与飞书通信正常只是在 联网搜索 这一步MimiClaw 还缺少一个搜索引擎 API 密钥。按照网上的教程去注册 Tavily结果发现网站打不开、邮件收不到验证码……别急这不怪你。Tavily 毕竟是国外服务对国内用户确实不够友好。好消息是国内已经有专为 AI Agent 设计的搜索 API 平替——博查搜索Bocha Search不仅访问稳定、中文优化还已经原生接入了 OpenClaw / MimiClaw 生态。本文将用 三步 教你配置博查 API 密钥让你的 MimiClaw 真正“联网冲浪”。按照 “按需获取密钥 → 快速配置密钥 → 验证搜索功能” 的思路帮你一次性彻底解决这个问题。一、为什么选择博查搜索对比项 Tavily国外 ——博查搜索国内访问稳定性 经常打不开、注册困难——秒开国内直连中文搜索质量 一般偏向英文——深度优化中文语义与 MimiClaw 集成 需要配置 set_tavily_key——支持通过兼容模式或自定义工具免费额度 1000 次/月——新用户 1000 次免费数据合规 数据出境风险——国内合规数据不出海博查搜索已经正式登陆 ClawHub推出了专为 OpenClaw 设计的 Skill完全能够替代 Tavily / Brave。对于 MimiClaw 用户同样可以通过简单的配置来调用。二、三步配置博查搜索 API 密钥第一步注册并获取 API Key访问 博查开放平台国内直连秒开。点击右上角「注册」使用手机号或邮箱完成注册。登录后进入「控制台」→「API 密钥管理」。点击「创建 API 密钥」输入名称如 mimiclaw-test选择免费套餐。复制生成的 API Key格式通常为 bocha-xxxxxxxxxxxxxx保存好。新用户自动获得 1000 次免费调用额度完全够你完成所有测试。第二步在 MimiClaw 中配置密钥MimiClaw 目前原生支持 Tavily 和 Brave但尚未内置 set_bocha_key 命令。不过我们可以通过两种方式让博查生效方法一通过自定义技能推荐无需改源码MimiClaw 支持加载 /spiffs/skills/ 目录下的自定义技能。我们可以写一个简单的 Python 脚本或 C 工具让 MimiClaw 调用博查 API。操作步骤在你的电脑上创建一个文件 bocha_search.md内容如下Markdown 格式的技能描述markdown#Bocha SearchThis skill performs web search using Bocha Search API.##Usagebocha_search query##Implementationimportrequestsimportjson API_KEY你的博查API密钥# 替换为真实密钥defbocha_search(query):urlhttps://api.bocha.cn/v1/searchheaders{Content-Type:application/json,Authorization:fBearer{API_KEY}}payload{query:query,num:5}try:resprequests.post(url,jsonpayload,headersheaders,timeout10)dataresp.json()resultsdata.get(result,{}).get(items,[])ifnotresults:return未找到相关结果。output[]foriteminresults[:3]:titleitem.get(title,)linkitem.get(url,)snippetitem.get(snippet,)output.append(f【{title}】({link})\n{snippet}\n)return\n.join(output)exceptExceptionase:returnf搜索失败{str(e)}将文件上传到 MimiClaw 的 SPIFFS 文件系统通过串口 CLI使用upload命令如果固件支持。或者通过网页门户http://192.168.4.1在 AP 模式下上传。在 MimiClaw 中加载技能skill_list确认bocha_search已出现。通过飞书或串口调用发送bocha_search ESP32 教程即可获得搜索结果。####方法二直接使用兼容模式如果固件支持自定义工具部分 MimiClaw 版本允许通过tool_exec调用外部命令。你可以编写一个简单的 shell 脚本或二进制程序放在 SPIFFS 中然后在tool_exec中调用。如果你对 C 语言熟悉也可以直接修改 MimiClaw 源码在tools/web_search.c中添加博查 API 的调用逻辑参考原有 Tavily 实现。###第三步测试联网搜索功能配置完成后在串口终端执行mimibocha_search MimiClaw 部署教程 或者在飞书中发送 bocha_search 行空板 K10 开发 预期输出返回包含标题、链接和摘要的搜索结果列表。 如果返回结果正常说明你的 MimiClaw 已经成功接入了国内搜索 API可以随时查询实时信息。三、常见问题与排查 问题 可能原因 解决方案 技能上传失败 SPIFFS 空间不足 执行df查看剩余空间删除无用文件 bocha_search 命令不存在 技能未正确加载 执行 skill_list 确认技能是否存在重启设备 搜索返回空结果 API 密钥无效或网络问题 检查 wifi_status确认密钥正确尝试在 PC 上用curl测试 飞书中无法调用 飞书配置未关联自定义技能 确保飞书消息能触发 MimiClaw 的 ReAct 循环且技能已启用 API 额度耗尽 免费次数用完 登录博查控制台查看用量或升级付费套餐 四、进阶让搜索与记忆、定时任务联动 配置好搜索后你的 MimiClaw 就不再是一个单纯的“问答机器”而是可以主动获取信息并采取行动 定时抓取新闻通过 scheduleadd添加任务每小时搜索一次“AI 最新动态”并将结果写入 MEMORY.md。 条件触发搜索当传感器检测到异常如温度骤升自动搜索“高温应急处理”并推送到飞书。 长期知识积累每次搜索到的有用信息可以用 memory_write 追加到记忆库中形成本地知识库。 这些能力正是嵌入式 AI 智能体区别于普通物联网设备的真正价值。 结语 Tavily 打不开不是你的错但让 MimiClaw 继续“搜不了东西”就是你的损失了。通过本文的三步配置你不仅解决了联网搜索的痛点还体验了国产 AI 工具链的便捷与稳定。 现在你的行空板 K10 已经拥有了完整的三项基础能力 Wi-Fi 联网wifi_status 已通 LLM 对话飞书配置完成 联网搜索博查 API 已配置 在飞书里向你的 MimiClaw 发送第一条搜索指令吧 “搜索一下 MimiClaw 的最新玩法” 它将带你进入一个更广阔的知识海洋。 附录快速命令速查bash#查看已安装技能mimiskill_list#手动调用搜索如果技能名为 bocha_searchmimibocha_search 关键词#检查网络状态mimiwifi_status#查看内存mimiheap_info目前MimiClaw状态评估