OPEN SOURCE · MIT
给 AI agent 装一双
真实的手。
ClawTouch 采用 open-core 模式：硬件、线协议、技能模板这一层完全开源（MIT）， 任何人都能验证"这枚 USB 设备不是后门、协议不是黑盒"；集成的商业桌面产品（托管、人设知识库、平台适配、视觉模型）保持闭源。 操控本机是常见用法，跨设备是额外能力。
01 — 三件套
三个仓，
全 MIT。
三个仓相互独立、也可单独使用。装好固件的硬件 + 一个 MCP server + 一份字节级公开的协议，外加一组应用操作手册。
MCP Server · 主入口
clawtouch-mcp
把硬件能力暴露成 agent 工具：移动 / 点击 / 拖拽 / 输入 / 组合键 / 滚动；截图为默认关闭的可选项。任何 MCP 客户端或 computer-use 循环都能直接接。自带 mock 模式，无硬件也能跑通整条链路。
- 13 HID + 2 device + 1 可选截图 = 16 工具
- 跨 Windows / macOS / Linux
- --mock 模式：无硬件先试
pip install clawtouch-mcp
github.com/tinqiao-oss/clawtouch-mcp →
固件 + 协议
clawtouch-hid
树莓派 Pico 2 的 CircuitPython 固件 + 线协议规范，公开到每个字节：6 字段帧、15 个命令码，v1.0 基线冻结、后续按 v1.x 累加 opcode。固件只是"帧 → HID 报告"的薄转译层。
- 协议字节级冻结公开
- 15 命令码 · 校验和帧
- 想自己写 host 就单独装
pip install clawtouch-hid-protocol
github.com/tinqiao-oss/clawtouch-hid →
技能模板
clawtouch-skills
给 LLM 看的 Markdown"操作手册"，写清具体软件的真实 UI 路径和已知坑，让 agent 少摸索。clone 下来就能改，自己写的也能上传分享。
- 纯 Markdown，指导性非执行性
- 种子覆盖常见办公软件
- 欢迎贡献新 skill
git clone …/clawtouch-skills
github.com/tinqiao-oss/clawtouch-skills →
02 — 协议
公开到
每个字节。
一条 PING 指令长这样 —— 共 7 字节，每一字节的含义都写在公开规范里。没有黑盒。
| AA | 01 00 | 01 | 00 00 | (空) | AC |
| 帧头 | 序号 | 指令码 | 长度 | 数据 | 校验和 |
| 1 字节 | 2 字节 | PING=01 | 2 字节 | 0-1024 字节 | 1 字节 |
校验和 = 前 6 字节求和取低 8 位（AA+01+00+01+00+00 = AC）。共 15 个命令码。 v1.0 baseline 2026-03-15 字节级冻结，v1.1 累加 drag 原语不破坏 v1.0。 任何语言都能自己实现 host，不限 Python、不限 MCP。完整规范见各仓 docs/protocol-v1.md。
03 — 独特在哪
为什么是
这一套。
不是黑盒、不锁平台、不锁模型、不锁板子 —— 每一层你都能自己验证、自己替换。
- 01开源协议字节级冻结，不是黑盒。每个字节都写在 docs/protocol-v1.md，任何语言都能自己实现 host。不限 Python、不限 MCP、不锁第三方。
- 02真 USB HID 物理输入，跨 OS 协议层一致。和正常键盘鼠标走同一套 USB HID 驱动栈，Windows / macOS / Linux 三平台底层一致 —— 开发者一份代码同时覆盖三个 OS，不必为每个平台单独写桌面输入实现。
- 03任何 LLM + MCP 客户端开箱即用。Claude Desktop / Cursor / Hermes / Cherry Studio / 国产 LLM 客户端等 MCP spec-compliant 都能直接接入，不绑平台、不绑模型。
- 04固件 CircuitPython，自己可改可审计。不是 ASIC 类一次性烧死，整个固件每一行都在 clawtouch-hid/firmware/，改完自己烧、改完自己审。
- 05标准 Pico 2 板子，国内能买。不是定制板，Pico 2 淘宝 / 拼多多 都有现货。
04 — 自主与安全
操控力等同真人键鼠，
安全边界默认内置。
一个自主 agent 拥有与键盘前真人同等的操控范围。我们把刹车默认装上，并把风险讲清楚。
- 01紧急停 + 默认不读屏。hid.release_all 一键释放所有按键和鼠标按钮，拔 USB 物理兜底；截图工具默认关闭（--allow-screenshot 才启用）—— 默认不读你的屏幕。
- 02服务端硬约束，越界发不出去。--screen 把坐标 clamp 在屏幕内 · --ops-per-sec 限速 · 单次输入 4096 字符上限 —— 防误点 / 防洪泛的护栏。
- 03这是 agent 行为风险，不是固件 bug。操控可能在你本意之外发生（提示词注入 / 模型出错 / 过宽授权）。把屏幕内容当作不可信输入。请勿用于违反目标应用用户协议或所在地法律的用途。
- 04部署建议。专用 / 最小权限宿主机 · 人在回路 · 网络隔离 —— 不要在登录态敏感页面运行未知 agent。完整披露见各仓 README 的「安全」节。
获取硬件
两条路，
都能跑起来。
硬件层是开源的——你完全可以自己烧；不想折腾，也能直接买烧好固件的套件。固件与开源仓一字不差。
开源 · 自己烧
任意 Pico 2
买一块标准 Raspberry Pi Pico 2（淘宝 / 拼多多现货），按 clawtouch-hid/docs/flash-guide.zh-CN.md 三步烧录，即得一枚 ClawTouch™ HID 设备。协议、固件全公开，自己审、自己改。
省事 · 烧好即用
ClawTouch™ 开发者套件
烧好固件的 Pico 2 + USB-C 线 + 上手卡，带外壳，开箱即插即用——替你省去选板和烧录。固件与本开源仓完全一致。
海外购买，或企业批量 / OEM 合作：联系我们。
