更新时间：2026-08-05 GMT+08:00
按键配置
自定义按键映射
runtime:
keyboard_control:
enabled: true
keymap:
"j": go_home # j → go_home
"s": state # s → get_state
"r": home_ready # r → 另一个命令实例 禁用默认按键
keymap: "h": "" # 禁用默认的 h → go_home
保留键（空格和q）不可禁用或重映射，配置中尝试操作会报错
ValueError: key 'q' is reserved (graceful_stop) and cannot be remapped or disabled.
Merge语义
自定义keymap合并到默认键之上，未提到的键保持默认行为。
例如：
keymap: "j": go_home
空格、h、q仍然有效，只有j被新增。
大小写规则
单字母按键先精确匹配，失败后对调大小写再试：
| 配置 | 按键 | 结果 |
|---|---|---|
"j": go_home | j | 触发 |
"j": go_home | J（Shift+J） | 触发（fallback） |
"J": go_home | j | 触发（fallback） |
| 多字符键 | — | 不适用fallback |
父主题： R2C SDK通过键盘控制机器人
