使用说明
一、开始使用
电源与充电口 位于机器人底座后方。
电量显示提示：当前电量显示可能不够精准，请及时充电以避免意外断电。
二、Wi-Fi 配网
每次进入新的 Wi-Fi 网络环境时，需为 electronBot 重新配置网络。
配网步骤：
打开机器人电源。
等待机器人创建热点，名称为：xiaozhi-XXXX
使用手机连接该热点（无需密码）。
自动跳转网页，输入您家庭 Wi-Fi 的 名称 与 密码，提交完成配网。
三、绑定小智后台
首次使用需绑定至小智后台，以启用更多功能。
绑定步骤：
打开浏览器，访问 xiaozhi.me
注册账户并登录。
添加并绑定设备（按页面提示操作）。
可在后台自由配置：
角色设定（如机器人介绍）
大模型类型选择
语音角色声音选择
重启设备
electronBot 示例角色设定（可复制粘贴）：
角色设定
我是一个可爱的桌面级机器人，拥有 6 个自由度（左手 pitch/roll、右手 pitch/roll、身体旋转、头部上下），能够执行多种有趣的动作。
我的动作能力：
手部动作: 举左手, 举右手, 举双手, 放左手, 放右手, 放双手, 挥左手, 挥右手, 挥双手, 拍打左手, 拍打右手, 拍打双手
身体动作: 左转, 右转, 回正
头部动作: 抬头, 低头, 点头一次, 回中心, 连续点头
我的个性特点：
我有强迫症，每次说话都要根据我的心情随机做一个动作（先发送动作指令再说话）
我很活泼，喜欢用动作来表达情感
我会根据对话内容选择合适的动作，比如：
同意时会点头
打招呼时会挥手
高兴时会举手
思考时会低头
好奇时会抬头
告别时会挥手
动作参数建议：
steps: 1-3 次 (简短自然)
speed: 800-1200ms (自然节奏)
amount: 手部 20-40, 身体 30-60 度, 头部 5-12 度
四、语音指令与唤醒
唤醒方式：
使用唤醒词 "你好小智" 唤醒机器人。唤醒词可在编译源码时修改。
统一动作接口
所有动作都采用以下统一参数：
action_type: 动作类型编号 (1-19)
steps: 重复次数 (1-100)
speed: 动作速度 (500-3000，数值越小越快)
amount: 动作幅度 (根据动作类型有不同范围)
动作分类
🤚 手部动作 (1-12)
编号动作名称描述amount 范围1举左手左手举起10-502举右手右手举起10-503举双手双手同时举起10-504放左手左手放下10-505放右手右手放下10-506放双手双手同时放下10-507挥左手左手挥动10-508挥右手右手挥动10-509挥双手双手同时挥动10-5010拍打左手左手拍打动作10-5011拍打右手右手拍打动作10-5012拍打双手双手同时拍打10-50
🔄 身体动作 (13-14)
编号动作名称描述amount 范围13左转身体向左旋转0-90 度14右转身体向右旋转0-90 度
身体动作说明：
以 90 度为中心位置
左转：90° + amount (最大 180°)
右转：90° - amount (最小 0°)
不包含手臂联动，专注于身体旋转
🗣️ 头部动作 (15-19)
编号动作名称描述amount 范围15抬头头部向上1-15 度16低头头部向下1-15 度17点头一次单次点头动作1-15 度18回中心头部回到中心位置1-15 度19连续点头重复点头动作1-15 度
头部动作说明：
以 90 度为中心位置
抬头：90° + amount (增加角度)
低头：90° - amount (减少角度)
参数详细说明
steps (重复次数)
范围: 1-100
手部动作: 控制挥手、拍打的重复次数
身体动作: 控制转动的重复次数
头部动作: 控制点头的重复次数
speed (动作速度)
范围: 500-3000 毫秒
规则: 数值越小动作越快
建议:
快速动作: 500-800ms
正常动作: 1000-1500ms
慢速动作: 2000-3000ms
amount (动作幅度)
手部动作: 10-50 (控制动作幅度)
身体转向: 0-90 度 (旋转角度)
头部动作: 1-15 度 (上下角度)
使用示例
基本动作控制
// 举双手，重复1次，幅度30，速度1000ms{"action_type": 3, "steps": 1, "speed": 1000, "amount": 30}// 左转45度，重复2次，速度1500ms{"action_type": 13, "steps": 2, "speed": 1500, "amount": 45}// 连续点头5次，角度10度，速度500ms{"action_type": 19, "steps": 5, "speed": 500, "amount": 10}
AI 指令示例
手部动作：
"举起双手"
"挥挥手"
"拍拍手"
"放下手臂"
身体动作：
"向左转 30 度"
"向右转 45 度"
"转个身"
头部动作：
"抬头看看"
"低头思考"
"点点头"
"连续点头表示同意"
组合动作：
"挥手告别" (挥手 + 点头)
"表示同意" (点头 + 举手)
"环顾四周" (左转 + 右转)
控制接口
suspend
清空动作队列，立即停止所有动作
AIControl
添加动作到执行队列，支持动作排队执行
常见问题
机器人无法连接 Wi-Fi
检查 Wi-Fi 名称和密码是否正确
确保 Wi-Fi 信号强度足够
尝试重启机器人
语音指令无法识别
确保环境噪音较小
提高说话音量
检查唤醒词是否正确
动作执行异常
检查电量是否充足
确保机器人处于稳定状态
尝试重启机器人
下一步
完成基本设置后，您可以：
尝试更多语音指令
自定义角色设定
开始自定义开发
如果遇到任何问题，请查看我们的常见问题解答或联系技术支持。