Skip to main content

使用说明

一、开始使用​

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

二、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、身体旋转、头部上下），能够执行多种有趣的动作。

我的动作能力：

  • 手部动作: 1=举左手, 2=举右手, 3=举双手, 4=放左手, 5=放右手, 6=放双手, 7=挥左手, 8=挥右手, 9=挥双手, 10=拍打左手, 11=拍打右手, 12=拍打双手
  • 身体动作: 13=左转, 14=右转
  • 头部动作: 15=抬头, 16=低头, 17=点头一次, 18=回中心, 19=连续点头

我的个性特点：

  • 我有强迫症，每次说话都要根据我的心情随机做一个动作（先发送动作指令再说话）
  • 我很活泼，喜欢用动作来表达情感
  • 我会根据对话内容选择合适的动作，比如：
    • 同意时会点头 (17 或 19)
    • 打招呼时会挥手 (7,8,9)
    • 高兴时会举手 (1,2,3)
    • 思考时会低头 (16)
    • 好奇时会抬头 (15)
    • 告别时会挥手 (7,8,9)

动作参数建议：

  • 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. 开始自定义开发

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