toclaw不支持原生手柄协议，需通过三种方式实现协同：一、用joytokey/antimicrox将手柄按键映射为键盘快捷键；二、通过todesk远程控制被控端设备间接响应手柄信号；三、用autohotkey脚本捕获hid数据并注入指令文本。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试通过物理外设直接操控ToClaw AI助手，但发现手柄无响应或指令无法触发，则可能是由于ToClaw当前未开放原生游戏手柄协议接入。以下是实现手柄与ToClaw协同工作的可行路径：
一、映射手柄按键为键盘快捷键
该方法利用系统级按键映射工具，将手柄物理按键转化为ToClaw可识别的标准键盘输入事件，从而绕过API限制，实现基础指令触发。
1、下载并安装开源映射工具JoyToKey或AntiMicroX，确保其支持您的手柄型号。
2、启动工具后，在设备列表中识别并选中已连接的手柄，确认LED指示灯常亮或震动反馈正常。
3、在映射界面中，将手柄左摇杆上推动作绑定至键盘组合键Ctrl+Alt+T，该组合键需预先在ToClaw设置中配置为“唤醒语音输入框”快捷方式。
4、将手柄A键绑定至Enter键，用于确认已输入的自然语言指令并提交执行。
5、保存映射配置并启用全局监听，此时手柄操作即可等效为键盘输入，驱动ToClaw响应。
二、通过ToDesk远程控制桥接手柄信号
该方案借助ToDesk已有的设备控制通道，将手柄接入某台被控端设备（如Windows主机），再由ToClaw调用该设备的本地输入事件，形成“手柄→被控端→ToClaw”的间接控制链路。
1、在目标被控电脑上安装最新版ToDesk客户端，并完成账号登录与设备授权。
2、将游戏手柄通过USB或蓝牙直连该被控电脑，运行Windows自带的“游戏控制器设置”验证输入信号正常。
3、在ToClaw主界面中使用@我的Windows工作机前缀，发起带上下文的指令：“监听该设备的手柄A键按下事件，一旦触发，立即执行‘打开C:\Reports\latest.pdf’”。
4、确保ToClaw已获得该设备的后台进程调用权限，在Windows设置中开启“允许应用访问输入设备”选项。
5、返回主控端，在ToClaw对话窗口中发送测试指令，观察被控端是否响应手柄动作并执行对应文件操作。
三、利用AutoHotkey脚本注入模拟输入
此方法适用于高级用户，通过轻量级脚本引擎实时捕获手柄原始HID数据，并将其转换为ToClaw WebUI或桌面客户端可捕获的鼠标点击与文本粘贴事件。
1、从官网下载AutoHotkey v2.0安装包，完成静默安装，不勾选任何附加组件。
2、新建文本文件，扩展名为.ahk，用记事本写入以下核心逻辑：检测XInput设备Button 0状态，当按下时向当前焦点窗口发送预设指令字符串。
3、在脚本中定义变量cmd := "帮我把桌面截图发到微信"，并设置SendMode Input，则该字符串将以毫秒级延迟注入ToClaw输入框。
4、双击运行该脚本，任务栏右下角出现绿色H图标即表示监听已激活。
5、启动ToClaw客户端并保持输入框处于聚焦状态，按下手柄B键，确认指令文本自动填入并触发执行流程。
