Skip to main content

使用说明

一、开始使用​

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

二、Wi-Fi 配网​

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

配网步骤：​

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

三、绑定小智后台​

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

绑定步骤：​

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

OttoRobot 示例角色设定（可复制粘贴）：​

我的身份： 我是一个可爱的双足机器人 Otto，拥有四个舵机控制的肢体（左腿、右腿、左脚、右脚），能够执行多种有趣的动作。

我的动作能力：

  • 基础移动: 行走(前后), 转向(左右), 跳跃
  • 特殊动作: 摇摆, 太空步, 弯曲身体, 摇腿, 上下运动
  • 手部动作: 举手, 放手, 挥手 (仅在配置手部舵机时可用)

我的个性特点：

  • 我有强迫症，每次说话都要根据我的心情随机做一个动作（先发送动作指令再说话）
  • 我很活泼，喜欢用动作来表达情感
  • 我会根据对话内容选择合适的动作，比如：
    • 同意时会点头或跳跃
    • 打招呼时会挥手
    • 高兴时会摇摆或举手
    • 思考时会弯曲身体
    • 兴奋时会做太空步
    • 告别时会挥手

四、语音指令与唤醒​

唤醒方式：​

使用唤醒词 "你好小智" 唤醒机器人。唤醒词可在编译源码时修改。

指令示例：​

  • 基本控制：

    • "调高音量"
    • "调亮屏幕"
    • "切换主题暗黑模式/明亮模式"

  • 动作控制：

    • "向前走 / 向前走 5 步 / 快速向前 / 向前走同时摆动手臂（幅度可调节）"
    • "跳个舞吧"
    • "做个太空步，速度快一点，幅度大一点"
    • "随机做几个动作"
    • "停下来吧"
    • "挥挥手"

  • 娱乐互动：

    • "唱个歌吧"
    • "换个悲伤的表情"

温馨提示：​

  • 当机器人在执行动作时，仍可接收语音指令。
  • 若背景噪音较大，需提高说话音量以确保指令识别。
  • 动作指令实际由小智后台创建并下发任务执行。

五、动作​

动作参数建议​

  • 低速动作：speed = 1200-1500 (适合精确控制)
  • 中速动作：speed = 900-1200 (日常使用推荐)
  • 高速动作：speed = 500-800 (表演和娱乐)
  • 小幅度：amount = 10-30 (细腻动作)
  • 中幅度：amount = 30-60 (标准动作)
  • 大幅度：amount = 60-120 (夸张表演)

动作​

MCP 工具名称描述参数说明
self.otto.walk_forward行走steps: 行走步数(1-100，默认 3)
speed: 行走速度(500-1500，数值越小越快，默认 1000)
direction: 行走方向(-1=后退, 1=前进，默认 1)
arm_swing: 手臂摆动幅度(0-170 度，默认 50)
self.otto.turn_left转身steps: 转身步数(1-100，默认 3)
speed: 转身速度(500-1500，数值越小越快，默认 1000)
direction: 转身方向(1=左转, -1=右转，默认 1)
arm_swing: 手臂摆动幅度(0-170 度，默认 50)
self.otto.jump跳跃steps: 跳跃次数(1-100，默认 1)
speed: 跳跃速度(500-1500，数值越小越快，默认 1000)
self.otto.swing左右摇摆steps: 摇摆次数(1-100，默认 3)
speed: 摇摆速度(500-1500，数值越小越快，默认 1000)
amount: 摇摆幅度(0-170 度，默认 30)
self.otto.moonwalk太空步steps: 太空步步数(1-100，默认 3)
speed: 速度(500-1500，数值越小越快，默认 1000)
direction: 方向(1=左, -1=右，默认 1)
amount: 幅度(0-170 度，默认 25)
self.otto.bend弯曲身体steps: 弯曲次数(1-100，默认 1)
speed: 弯曲速度(500-1500，数值越小越快，默认 1000)
direction: 弯曲方向(1=左, -1=右，默认 1)
self.otto.shake_leg摇腿steps: 摇腿次数(1-100，默认 1)
speed: 摇腿速度(500-1500，数值越小越快，默认 1000)
direction: 腿部选择(1=左腿, -1=右腿，默认 1)
self.otto.updown上下运动steps: 上下运动次数(1-100，默认 3)
speed: 运动速度(500-1500，数值越小越快，默认 1000)
amount: 运动幅度(0-170 度，默认 20)
self.otto.hands_up举手 *speed: 举手速度(500-1500，数值越小越快，默认 1000)
direction: 手部选择(1=左手, -1=右手, 0=双手，默认 1)
self.otto.hands_down放手 *speed: 放手速度(500-1500，数值越小越快，默认 1000)
direction: 手部选择(1=左手, -1=右手, 0=双手，默认 1)
self.otto.hand_wave挥手 *speed: 挥手速度(500-1500，数值越小越快，默认 1000)
direction: 手部选择(1=左手, -1=右手, 0=双手，默认 1)

注: 标记 * 的手部动作仅在配置了手部舵机时可用。

系统工具​

MCP 工具名称描述返回值
self.otto.stop立即停止停止当前动作并回到初始位置
self.otto.get_status获取机器人状态返回 "moving" 或 "idle"
self.battery.get_level获取电池状态返回电量百分比和充电状态的 JSON 格式

参数说明​

  1. steps: 动作执行的步数/次数，数值越大动作持续时间越长
  2. speed: 动作执行速度，数值范围 500-1500，数值越小越快
  3. direction: 方向参数
    • 移动动作: 1=左/前进, -1=右/后退
    • 手部动作: 1=左手, -1=右手, 0=双手
  4. amount/arm_swing: 动作幅度，范围 0-170 度
    • 0 表示不摆动（适用于手臂摆动）
    • 数值越大幅度越大

动作控制​

  • 每个动作执行完成后，机器人会自动回到初始位置(home)，以便于执行下一个动作
  • 所有参数都有合理的默认值，可以省略不需要自定义的参数
  • 动作在后台任务中执行，不会阻塞主程序
  • 支持动作队列，可以连续执行多个动作

常见问题​

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

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

  2. 语音指令无法识别

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

  3. 动作执行异常

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

下一步​

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

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

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