HyClaw 客户端 · 详细说明

使用前请阅读以下内容，以便正确安装与连接开发板。

一、产品说明

HyClaw 客户端是在您电脑（Mac 或 Windows）上运行的小程序，用于发现同一局域网内的 HyClaw 开发板并建立连接，随后在浏览器中打开控制界面。您无需记忆 IP 或手动配置，只要开发板与电脑在同一 WiFi 下即可。

二、开发板参数（参考）

客户端所连接的 HyClaw 开发板通常具有以下参考规格（具体以您购买型号为准）：

• 材质：哑黑 PC/ABS，便于工业环境部署与长期运行。
• 运行功耗：约 3–5W。
• 存储占用：核心引擎 < 100MB。
• 外设支持：GPIO / 串口 / USB。
• 数据位置：100% 本地。

三、使用前提

• 已有一台已开机、已连网的 HyClaw 开发板（预装 HyClaw/OpenClaw 系统）。
• 您的电脑与开发板处于同一局域网（同一 WiFi 或同一路由器下）。
• Mac：macOS 10.13 或更高。Windows：Windows 10 或 11。

四、下载与安装

Mac：下载 .dmg 文件，双击打开后将 HyClaw 拖入「应用程序」文件夹即可。

Windows：下载 .zip 文件，解压到任意目录，双击运行其中的启动脚本即可。

五、使用步骤

1. 开发板接电源、插网线，并连接到与电脑相同的 WiFi。
2. 在电脑上安装客户端（Mac 拖入应用程序，Windows 解压）。
3. 双击运行客户端，程序会自动扫描并连接开发板，并在浏览器中打开控制面板。

若网络正常，您会看到浏览器自动打开 HyClaw 的控制界面；若未发现设备，请检查开发板是否已开机、是否与电脑在同一 WiFi。

六、自动连接与手动指定 IP

客户端会按以下顺序自动查找开发板，无需手动配置 IP：

• 192.168.3.38（默认内网 IP）
• hyclaw.local（mDNS，需开发板已设置主机名为 hyclaw）
• 扫描当前 WiFi 网段（如 .2–.50）

若您已知开发板 IP（例如路由器里查到），可手动指定连接：

Mac：在终端进入客户端所在目录后执行 ./connect-jetson.sh 192.168.3.50 ui（将 IP 改为实际地址）。

Windows：用记事本打开 connect-jetson.ps1，修改其中的 IP 后再运行 clickme.bat；或按脚本内说明传入 IP 参数。

七、控制界面中的 Chat 常用命令

打开控制界面后，在 Chat 输入框输入以下命令并发送可快速操作：

命令	说明
/new 或 /reset	新建会话，清空上下文
/model	打开模型选择器
/model qwen	切换到 Qwen（云端，响应快）
/model ollama/模型名	切换到本地 Ollama（省 token）
/model list	列出可用模型
/stop	停止当前回复
/status	显示当前状态（模型、用量等）
/help	显示帮助

使用建议：默认用本地 Ollama 可省 token；需要更流畅的对话时可输入 /model qwen 切换到云端 Qwen。

八、控制界面快捷键

在浏览器打开的控制界面（或终端 TUI）中，常用快捷键如下：

快捷键	说明
Enter	发送消息
Shift + Enter	换行（不发送）
Esc	停止当前回复 / 取消
Ctrl + L	打开模型选择器（TUI）
Ctrl + G	切换 Agent（TUI）
Ctrl + P	切换会话（TUI）
Ctrl + C	清空输入（TUI 中连按两次退出）

Mac 上 Ctrl 可改为 ⌃ Control。浏览器内部分操作以界面按钮为准。

九、Mac 首次打开说明

若 Mac 提示「无法打开」或「来自未识别的开发者」，是因为系统安全限制，并非软件损坏。请按以下任一方式操作：

• 推荐：在「应用程序」或下载目录中，右键点击 HyClaw 应用 → 选择「打开」，在弹窗中再次点击「打开」即可。
• 或进入 系统设置 → 隐私与安全性，在「安全性」中看到该应用被拦截的提示后，点击「仍要打开」。

完成一次「打开」后，之后可直接双击运行，无需重复操作。

十、Windows 使用说明

解压后双击运行包内的 clickme.bat。脚本会自动探测开发板 IP、建立隧道并打开浏览器。

• 首次运行：若提示「无法运行脚本」或执行策略相关错误，请在 PowerShell 中执行 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned 后重试。
• OpenSSH：若提示未检测到 OpenSSH，请到「设置 → 应用 → 可选功能」中安装「OpenSSH 客户端」。
• 免密登录（可选）：首次会提示输入开发板密码（默认 12345678）。若需免密，可在 PowerShell 中配置 SSH 密钥后，将公钥复制到开发板。

按 Enter 或关闭脚本窗口即可断开连接。确保电脑与开发板在同一网络。

十一、支持的开发板与运行要求

客户端可连接已预装 HyClaw/OpenClaw 的各类开发板，常见包括：

• Jetson 系列（Nano / Orin / Xavier）：英伟达方案，有 GPU，适合同机跑本地 Ollama。
• 树莓派 4/5：ARM64，Pi 5 4GB/8GB 体验较好，Pi 4 4GB 性价比高。
• 香橙派、Orange Pi：满足 4GB+ 内存、64 位系统即可。

开发板需满足：Linux 64 位、Node.js ≥ 22.12、建议 2GB+ 内存（同机跑 Ollama 建议 4GB+）。具体以您购买的型号与出厂说明为准。

十二、常见问题

Q：客户端一直找不到设备？
请确认：① 开发板已通电并连上 WiFi；② 电脑与开发板在同一路由器/WiFi 下；③ 路由器未开启「AP 隔离」或「访客网络隔离」。若已知开发板 IP，可使用上文「手动指定 IP」方式连接。

Q：提示「gateway token missing」？
表示开发板端尚未生成网关令牌，需由部署人员在开发板上执行相应命令生成。请联系卖家或技术支持处理。

Q：连接成功但 Chat 无回复？
可尝试在 Chat 里输入 /new 新建会话，或 /model list 查看模型是否正常。若仍无响应，可能是开发板端服务异常，需技术支持在板端排查。

Q：连接后浏览器打不开或报错？
请检查本机防火墙是否拦截了本地端口；可暂时关闭防火墙测试，或将 HyClaw 加入允许列表。

Q：如何获取更多帮助？
可联系客服，报修时请提供设备编号（如有）、系统版本（Mac/Windows 及版本号）和具体现象描述。也可查阅项目 README 与 docs 目录下的技术文档。

十三、联系与支持

如有问题或建议，请通过您购买渠道的客服方式联系我们。报修或咨询时请尽量提供：设备编号（如有）、系统版本（Mac/Windows 及版本号）、以及具体现象描述，便于快速排查。

十四、关于我们

HyClaw 由湖银人工智能科技出品。开发者：肖稼华。我们专注边缘计算与机器人控制，HyClaw 客户端与开发板旨在为开发者与硬件发烧友提供稳定、可扩展的硅基执行与远程控制方案。如有合作或技术交流需求，欢迎通过客服渠道联系，或发送邮件至 lynvi_corp@163.com。