← 返回藏宝库

StackChan 进阶指南

给机器人换个大模型脑子，接管你的电脑！

进度只保存在这台设备的浏览器里

Mac 装好网关，手机测通 OTA 接口。

OTA地址是怎么来的

  1. 做到了：终端里能启动 claude

  2. 做到了：Mac 和机器人连的是同一个 Wi-Fi

    提醒：不能用手机热点。

  3. 帮我装 xiaozhi-hub-server（GitHub: justhalfbit/xiaozhi-hub-server），让 StackChan 能用语音指挥本机 Claude Code。先读 scripts/bootstrap.sh 和 hub-docs/guide.md，告诉我它会装什么、装到哪，再执行安装；开机自启选是；装完告诉我 OTA 地址和管理后台地址；不要改 Claude Code 权限，先保持只读。

    做到了：给出 OTA 地址和后台地址

    没反应？

    防火墙弹窗直接点允许。

  4. 做到了：输入框里是以 /ota/ 结尾的地址

  5. 做到了：显示「OTA接口运行正常」

看到「OTA接口运行正常」了吗？

为什么这样做 ›

StackChan 负责在桌上当“耳朵和嘴巴”，真正思考的大脑，直接用你 Mac 电脑上现成的 AI。

192.168.x.x：你的 Mac 在家里 Wi-Fi 里的「门牌号」，每台电脑不一样，所以只能由网关装好时告诉你，不用自己编；

16688：网关在你 Mac 上开的那扇「门」；

/xiaozhi/ota/：机器人敲门时说的那句暗号，固定不变。

通道打通了，赶紧去后台把大门锁好。

打开后台，把权限卡死在只读保安全。

权限三档

  1. 做到了：顺利进到后台

  2. 做到了：大模型选了本地，开关停在只读

    提醒：只能看 ~/xiaozhi-workspace，想看的文件丢进去。

没反应？
  • 后台要在装网关的Mac上打开：127.0.0.1:16688/admin
  • 打不开是网关没跑，回第1关用手机开OTA，或让Claude Code检查。

看到后台打开且权限是只读了吗？

为什么这样做 ›

它能看的只有你电脑里这一个专用文件夹 ~/xiaozhi-workspace，想让它看什么，就把文件丢进去。

注意：此时的权限档位默认是只读。先别改，只读最安全，免得它刚上线你就手滑把它当碎纸机用。

大门锁牢了，现在把它的耳朵嘴巴拉回来。

填好地址，重启亮脸并连上你电脑。

机器人配网

  1. 做到了：官方 App 列表里已看不到这台机器

  2. 做到了：机器人自己重启了

  3. 做到了：屏幕显示热点名 Xiaozhi-xxxx

    没反应？
    • 见二维码是升了 1.6.0：插 Mac 用 M5Burner 刷回 1.5.1，刷完别绑 App。
    • 按住底部 RST 键 3 秒亮绿灯可进入下载模式。

  4. 做到了：浏览器里出现机器人配网网页

  5. 做到了：点完 Save，页面没有报错

    把 OTA 地址粘这里

    提醒：Custom OTA URL 填第1关抄下的OTA地址，不要填/admin。

  6. 做到了：见绿色对勾配置成功，重启亮起小脸

    没反应？

    密码错或连了5G，把连热点、填地址、连Wi-Fi这几步重做一遍。

看到绿勾「配置成功」且重启亮脸了吗？

为什么这样做 ›

我们要把机器人的嘴巴和耳朵，从官方的玩具服务器，拉回到你自家的这台电脑上。

打算跟我换脑子的先看第 08 章坑 1，官方 App 会自动升 1.6.0 固件删掉配网热点，已经升了也不慌，坑 1 里教你怎么刷回 1.5.1。

肉身已就位，喊 Claude 查查本地文件夹！

让它借助 Claude 读出工作文件夹。

点一下它换脸

  1. 做到了：后台显示「设备在线」

    没反应？
    • 连不上或检查失败是 TUN 翻墙导致，让 Claude 把网关 IP 写死成局域网地址。
    • 隔天失联是 IP 变动，去路由器后台给 Mac 绑定固定局域网 IP。

  2. 做到了：机器人当场换脸

  3. 做到了：它把文件夹里的东西读给你听

    没反应？

    说看不了文件就去后台换聪明模型，且说完整文件名。

  4. 做到了：改完后权限开关已切回「只读」

    提醒：别开 Auto 模式，它发起狠来真的会删文件。

看到它读出工作文件夹里的东西了吗？

为什么这样做 ›

接上之后你会发现两个极舒服的小细节：只冲它喊一声「嗨 Claude」，啥也不说，它会先乖乖回一句「我在」；要是派了个写长代码的重活，超过 30 秒没搞定，它会主动安抚你「还在处理，请稍等」，之后隔一阵报一次进度，最长能踏踏实实干满 10 分钟。

回后台把权限从「只读」改成「可编辑」，它立刻变身桌面开发小工。

内脑已经打通，再挂上 Grok 当外脑干活！

接入 Grok，喊新名字约 7 秒开口。

勾选 Bot 再起中文名：在 Grok Bot 页勾选情报 Bot，在呼名页设置哨兵并添加烧饼、少兵等听错写法

  1. 做到了：页面刷出云端 Bot 列表

  2. 做到了：目标 Bot 前面的勾选框已打上勾

  3. 做到了：呼名页填好了中文名和同音词

    提醒：例如起名哨兵，要把烧饼、少兵等容易听错的也加进去。

  4. 做到了：等待约 7 秒后它开口

    没反应？

    必须「嗨」开头；名字千万别带英文和空格。

看到喊「嗨+名字」约7秒后开口了吗？

为什么这样做 ›
对比维度脑子 A：Claude Code（本地大脑）脑子 B：Grok Bot（云端大脑）
它住在哪你身边的 Mac 电脑本地遥远的云端独立电脑
看家本领查你电脑里的文件、帮你改代码、做网页抓全网实时情报、推特热搜、长文本调研
问它“我文件夹有啥”准确念出你 Mac 里专门文件夹里的文件念它自己那台云端虚拟电脑里的东西，完全无关

想动电脑里的东西，喊 Claude；想问天外的大事，喊哨兵。一内一外，各司其职。

全部搞定！收下这张避坑卡，放心玩去吧！