使用说明

一、开始使用

• 电源与充电口 位于机器人底座后方。
• 电量显示提示：当前电量显示可能不够精准，请及时充电以避免意外断电。

---

二、Wi-Fi 配网

每次进入新的 Wi-Fi 网络环境时，需为 electronBot 重新配置网络。

配网步骤：

1. 打开机器人电源。
2. 等待机器人创建热点，名称为：xiaozhi-XXXX
3. 使用手机连接该热点（无需密码）。
4. 自动跳转网页，输入您家庭 Wi-Fi 的 名称 与 密码，提交完成配网。

---

三、绑定小智后台

首次使用需绑定至小智后台，以启用更多功能。

绑定步骤：

1. 打开浏览器，访问 xiaozhi.me
2. 注册账户并登录。
3. 添加并绑定设备（按页面提示操作）。
4. 可在后台自由配置：
   • 角色设定（如机器人介绍）
   • 大模型类型选择
   • 语音角色声音选择
5. 重启设备

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-50
2	举右手	右手举起	10-50
3	举双手	双手同时举起	10-50
4	放左手	左手放下	10-50
5	放右手	右手放下	10-50
6	放双手	双手同时放下	10-50
7	挥左手	左手挥动	10-50
8	挥右手	右手挥动	10-50
9	挥双手	双手同时挥动	10-50
10	拍打左手	左手拍打动作	10-50
11	拍打右手	右手拍打动作	10-50
12	拍打双手	双手同时拍打	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

添加动作到执行队列，支持动作排队执行

---

常见问题

1. 机器人无法连接 Wi-Fi

   • 检查 Wi-Fi 名称和密码是否正确
   • 确保 Wi-Fi 信号强度足够
   • 尝试重启机器人

2. 语音指令无法识别

   • 确保环境噪音较小
   • 提高说话音量
   • 检查唤醒词是否正确

3. 动作执行异常

   • 检查电量是否充足
   • 确保机器人处于稳定状态
   • 尝试重启机器人

下一步

完成基本设置后，您可以：

1. 尝试更多语音指令
2. 自定义角色设定
3. 开始自定义开发

如果遇到任何问题，请查看我们的常见问题解答或联系技术支持。