哈基米机 HachimoDock：给AI Agent一个身体
简介
哈基米机通过桌宠形象把Agent（如Codex/CC/龙虾等）后台工作状态呈现出来，让你清晰感知到任务完成情况。 此外还有语音下发指令、自定义桌形象、自定义小组件等玩法，让哈基米陪你工作。
简介：哈基米机通过桌宠形象把Agent（如Codex/CC/龙虾等）后台工作状态呈现出来，让你清晰感知到任务完成情况。 此外还有语音下发指令、自定义桌形象、自定义小组件等玩法，让哈基米陪你工作。开源协议
：GPL 3.0
(未经作者授权，禁止转载)描述
HachimoDock（哈基米机）
一只看得见、摸得着的桌面 AI 搭子 —— 把 CLI Agent 的状态变成桌上小宠物的表情和动作，抬头一眼就知道它在做什么。
这是什么
HachimoDock（哈基米机）是一块放在桌上的 Agent 专属小屏。它把电脑里运行的各类 Agent（Codex、Claude Code、OpenClaw 等）变成工位上的一只小宠物 —— 不是看不见摸不着的「虚拟助理」，而是有状态、有回应、有存在感的 AI 搭子。
Agent 状态跟随
Agent 在思考，它跟着思考；在调工具，它开始干活；任务完成它庆祝，报错它发愁。
抬头可见
状态、进度、要你拍板的事，都变成一眼能懂的表情、动作和短标签。
开口即用
不用切窗口、找聊天框，开口就能安排活儿：办公、写作、开发、查资料、记想法。
核心亮点
01状态实时跟随
桌面端与设备屏实时同步，Agent 在做什么，看屏上的表情、动作、颜色和短标签就知道；状态一变，还会弹出字幕提醒。
02多状态反馈
Agent 闲下来时，它会自己玩耍，时不时换个待机小动作。
03会话框切换和语音输入
主屏幕对话框数量可自由选择，AI Agent 会根据任务自动切换到对应的对话框并展示相关内容；长按按键即可唤醒语音输入，随时向 Agent 下达指令，让多任务沟通更直观、更高效。
05自定义组件
内置包含贪吃蛇游戏，俄罗斯方块，番茄钟等多个组件。想要新的？直接在组件中心用自然语言生成即可
硬件复刻
3.0 三种硬件方案
| 方案 | 定位 | 当前已验证 | 当前未默认启用 |
|---|---|---|---|
| 方案一：Radxa Cubie A7Z（已废弃） | 默认复刻硬件，性能更高，推荐走 Wi-Fi + MQTT/SSH | Debian 11/12、ILI9341 SPI LCD、/dev/fb0 显示、HTTP/MQTT、桌面端状态同步、负一屏 widget | XPT2046/PEN 触摸 overlay、GPIO 旋钮/按钮、板端语音 PTT、USB gadget /dev/ttyGS0 |
| 方案二：Raspberry Pi Zero 2W（已废弃） | 兼容方案，适合完整体验 USB 直连、触摸、旋钮和语音 | Raspberry Pi OS、ILI9341 SPI LCD、XPT2046/ADS7846 触摸、GPIO 旋钮/按钮、VoiceHAT 语音、USB gadget、HTTP/MQTT、负一屏 widget | 音频设备名、网络和供电稳定性取决于实际镜像、声卡与现场配置 |
| 方案三：ESP32 | USB-only 产品方案，聚焦 ESP32-P4 单设备架构，适合低功耗、快速启动和桌面端 USB 直连部署 | 无 | 无 |
3.1 整机物料清单（ESP32-P4 方案）
// 数量为单套用量 · 点击器件名可打开购买链接 · 商品规格与价格根据所提供的商品截图整理
| 类别 | 模块 / 器件 | 接口 / 位号 | 数量 | 单价 | 备注 |
|---|---|---|---|---|---|
| 开发板 | 微雪 ESP32-P4-WIFI6 / ESP32-P4-WIFI6-M ↗ | 主控板 | ×1 | ¥81.15 起 | 可选未焊接排针版（ESP32-P4-WIFI6）或焊接排针版（ESP32-P4-WIFI6-M）。RISC-V MCU，32MB PSRAM，32MB Flash，支持 Wi-Fi 6、USB OTG 2.0 HS、MIPI-CSI/DSI、音频与 RJ45 扩展。 |
| 排母 | 2.54mm 间距 1×20P 单排排母 ↗ | 主控板连接 | ×2 | ¥0.17 起/个 | 选择“2.54mm_1×20P_排座（1只）”，共购买 2 个，用于开发板与定制底板连接。 |
| 屏幕 | 2.8 英寸 480×640 IPS MIPI-DSI 显示屏 ↗ | 15P / 22P DSI | ×1 | ¥65 | 选择“2.8寸 DSI 15/22P 模块不带触摸”；树莓派 / ESP32-P4 可用，480×640 IPS 液晶屏。 |
| 旋钮 | EC11 旋转编码器（薄型 20 脉冲、带按压开关） ↗ | 编码器位 | ×1 | ¥1.17 起 | 360°旋转；选择薄型底座 4.5mm、半轴柄（D 轴）、柄长 L=10mm。 |
| 按键 | 凯华 Kailh BOX 机械键盘轴 ↗ | SW1 / SW2 / SW3 | ×3 | ¥12.7 起/组合 | 白轴、红轴、茶轴、黑轴或青轴均可，外形一致即可；设备实际使用 3 个，按商品最小包装购买。 |
| 扬声器 | 2011 小腔体喇叭 ↗ | 1.25 端子 | ×1 | ¥4.50 | 2011 小腔体喇叭，1.25 端子，带双面胶 |
| 螺钉 | 304 不锈钢十字圆头螺钉 M2.5×6 ↗ | 外壳装配 | ×2 | 见商品页 | 型号：M2.5×6；盘头机螺钉。 |
| 螺母 | 滚花热熔铜螺母 M2.5×4×3.5 ↗ | 外壳热熔嵌件 | ×2 | 见商品页 | 型号：M2.5×4×3.5；注塑用滚花铜螺母嵌件。 |
整机物料展开图
3.2 结构件与装配
完整复刻教程视频已放在本项目附件里（.mp4 文件），下载后即可对照视频一步步装配。下面图文步骤为配套说明。
软件安装
硬件装好后，从源码仓库获取代码，按 README 安装 PC 管理端、烧录板端系统；想二次开发，也从这里开始。
> cd HachimoDock && cat README.md # 按文档安装与运行
使用指南
四步让小搭子上岗。完整的安装、配置与故障排查，请看 GitHub 文档。
烧录到 ESP32
使用 USB 连接 ESP32-P4 开发板，按项目文档将板端固件烧录到设备。
连接设备
重新连接 USB，打开桌宠管理端，完成设备识别与绑定。
检测跟随
管理端自动检测运行中的 Agent，设备屏实时显示它的状态与进度。
抬头互动
看表情和短标签了解进度；触摸屏幕、转旋钮，或直接语音对话。
管理端（PC）
展示端（设备）
常见问题
复刻和使用前最常被问到的问题都在这里；更多讨论欢迎去 GitHub Discussion。
// 主控与选型
Q哪些零部件可以换？
键帽、机械键盘轴可以换，其他都不可以。
// 制作与装配
Q没有 3D 打印机怎么办？
把结构件模型发到嘉立创 3D 打印或第三方打印服务即可，一套外壳几十块。
Q怎么供电？需要电池吗？
USB 供电即可，跟电脑或充电头一起用，不用单独配电池。
// 软件与 Agent
Q软件在哪获取？
全套软件代码已在 GitHub 开源：github.com/YizhengWw/HachimoDock ↗（含 PC 管理端 + 板端运行时 + 文档），可直接 clone 使用。
Q支持哪些 Agent？
面向 CLI Agent 设计，内置适配 Codex、Claude Code、OpenClaw 等；状态协议开放，第三方 Agent 也能接入（欢迎 PR）。
Q设备怎么和电脑通信？需要联网吗？
设备端通过 USB 串口 或 MQTT 接收桌面端下发的状态流。不能联网
Q管理端支持什么系统？
支持 macOS 和 Windows。管理端负责设备绑定、Agent 检测跟随、形象管理、组件中心和语音入口。
// 开源协议与反馈
Q用什么开源协议？能商用吗？
当前仓库软件代码按 GPL-3.0-only 发布；硬件设计、3D 结构件、官方宠物素材和第三方资源请以仓库内 LICENSE、COPYRIGHT、docs/open-source-compliance-prep.md 及对应资源随附声明为准。商用前请按各协议条款执行。
Q怎么反馈问题 / 参与贡献？
GitHub 提 Issue / Discussion / PR：github.com/YizhengWw/HachimoDock ↗。安全问题请先别公开，发邮件到 skyler.wang98@gmail.com。
附录与维护
7.1 参与贡献
欢迎提 Issue、发起讨论或提交 PR，可以从这些方向入手：
- 修复 HachimoDock（哈基米机）或板端运行时问题
- 适配新的硬件屏、主控板、结构件或外壳形态
- 创作宠物资源、动画素材和字幕样式
- 开发新的 .clawpkg 负一屏组件
- 补充装配教程、烧录说明和故障排查
- 改进 Agent 状态协议和第三方 Agent 接入
7.2 开源许可
按内容类型分别声明许可证：
- 软件代码：GPL-3.0-only
- 硬件设计、3D 结构件和官方宠物素材：以仓库内对应资源声明为准
- 第三方资源声明：docs/open-source-compliance-prep.md 或资源随附声明
7.3 安全反馈
发现安全问题，请先不要公开细节，发邮件到下方的安全反馈邮箱，我们会尽快确认并处理。
7.4 联系方式
- 维护者：Skyler Wang（GitHub @YizhengWw）
- GitHub：github.com/YizhengWw/HachimoDock ↗
- 社区 / 交流：GitHub Discussions
- 安全反馈邮箱：skyler.wang98@gmail.com
扫码加入交流群，一起交流复刻与玩法。
交流群扫码加入，交流复刻与玩法设计图
未生成预览图，请在编辑器重新保存一次BOM
暂无BOM
克隆工程
0知识产权声明&复刻说明
本项目为开源硬件项目，其相关的知识产权归创作者所有。创作者在本平台上传该硬件项目仅供平台用户用于学习交流及研究，不包括任何商业性使用，请勿用于商业售卖或其他盈利性的用途；如您认为本项目涉嫌侵犯了您的相关权益，请点击上方“侵权投诉”按钮，我们将按照嘉立创《侵权投诉与申诉规则》进行处理。
请在进行项目复刻时自行验证电路的可行性，并自行辨别该项目是否对您适用。您对复刻项目的任何后果负责，无论何种情况，本平台将不对您在复刻项目时，遇到的任何因开源项目电路设计问题所导致的直接、间接等损害负责。
