使用说明
一、开始使用
- 电源与充电口 位于机器人身体下方。
- 电量显示提示：当前电量显示可能不够精准，请及时充电以避免意外断电。
二、Wi-Fi 配网
每次进入新的 Wi-Fi 网络环境时，需为 OttoRobot 重新配置网络。
配网步骤：
- 打开机器人电源。
- 等待机器人创建热点，名称为：
xiaozhi-XXXX - 使用手机连接该热点（无需密码）。
- 自动跳转网页，输入您家庭 Wi-Fi 的 名称 与 密码，提交完成配网。
三、绑定小智后台
首次使用需绑定至小智后台，以启用更多功能。
绑定步骤：
- 打开浏览器，访问 xiaozhi.me
- 注册账户并登录。
- 添加并绑定设备（按页面提示操作）。
- 可在后台自由配置：
- 角色设定（如机器人介绍）
- 大模型类型选择
- 语音角色声音选择
- 重启设备
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) |
特殊动作
| MCP 工具名称 | 描述 | 参数说明 |
|---|---|---|
| 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.whirlwind_leg | 旋风腿 | steps: 动作次数(3-100，默认 3) speed: 动作速度(100-1000，数值越小越快，建议 300，默认 300) amplitude: 踢腿幅度(20-40 度，默认 30) |
手部动作 *
| MCP 工具名称 | 描述 | 参数说明 |
|---|---|---|
| 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 | 挥手 | direction: 手部选择(1=左手, -1=右手, 0=双手，默认 1) |
| self.otto.windmill | 大风车 | steps: 动作次数(3-100，默认 6) speed: 动作周期(300-2000 毫秒，数值越小越快，默认 500) amplitude: 振荡幅度(50-90 度，默认 70) |
| self.otto.takeoff | 起飞 | steps: 动作次数(5-100，默认 5) speed: 动作周期(200-600 毫秒，数值越小越快，建议 300，默认 300) amplitude: 振荡幅度(20-60 度，默认 40) |
| self.otto.fitness | 健身 | steps: 动作次数(3-100，默认 5) speed: 动作速度(500-2000 毫秒，数值越小越快，默认 1000) amplitude: 振荡幅度(10-50 度，默认 25) |
| self.otto.greeting | 打招呼 | direction: 手部选择(1=左手, -1=右手，默认 1) steps: 动作次数(3-100，默认 5) |
| self.otto.shy | 害羞 | direction: 方向(1=左, -1=右，默认 1) steps: 动作次数(3-100，默认 5) |
| self.otto.radio_calisthenics | 广播体操 | 不需要参数 |
| self.otto.magic_circle | 爱的魔力转圈圈 | 不需要参数 |
注: 标记 * 的手部动作仅在配置了手部舵机时可用。
系统动作
| MCP 工具名称 | 描述 | 参数说明 |
|---|---|---|
| self.otto.sit | 坐下 | 不需要参数 |
| self.otto.showcase | 展示动作（组合动作） | 不需要参数 |
| self.otto.home | 复位到初始位置 | 不需要参数 |
高级功能
| MCP 工具名称 | 描述 | 参数说明 |
|---|---|---|
| self.otto.servo_sequences | 舵机序列自编程（支持普通移动和振荡器两种模式，支持分段发送自动排队） | sequence: JSON 格式的序列对象，支持短键名格式，详见代码注释 |
系统工具
| MCP 工具名称 | 描述 | 参数说明 |
|---|---|---|
| self.otto.stop | 立即停止所有动作 | 不需要参数 |
| self.otto.home | 复位到初始位置 | 不需要参数 |
| self.otto.get_status | 获取机器人状态 | 不需要参数 返回值: "moving" 或 "idle" |
| self.otto.get_trims | 获取舵机微调 设置 | 不需要参数 返回值: JSON 格式的微调值 |
| self.otto.set_trim | 设置单个舵机微调 | servo_type: 舵机类型(left_leg/right_leg/left_foot/right_foot/left_hand/right_hand) trim_value: 微调值(-50 到 50 度) |
| self.battery.get_level | 获取电池状态 | 不需要参数 返回值: JSON 格式的电量百分比和充电状态 |
参数说明
- steps: 动作执行的步数/次数，数值越大动作持续时间越长
- speed: 动作执行速度，数值范围 500-1500，数值越小越快
- direction: 方向参数
- 移动动作: 1=左/前进, -1=右/后退
- 手部动作: 1=左手, -1=右手, 0=双手
- amount/arm_swing: 动作幅度，范围 0-170 度
- 0 表示不摆动（适用于手臂摆动）
- 数值越大幅度越大
动作控制
- 每个动作执行完成后，机器人会自动回到初始位置(home)，以便于执行下一个动作
- 所有参数都有合理的默认值，可以省略不需要自定义的参数
- 动作在后台任务中执行，不会阻塞主程序
- 支持动作队列，可以连续执行多个动作
常见问题
-
机器人无法连接 Wi-Fi
- 检查 Wi-Fi 名称和密码是否正确
- 确保 Wi-Fi 信号强度足够
- 尝试重启机器人
-
语音指令无法识别
- 确保环境噪音较小
- 提高说话音量
- 检查唤醒词是否正确
-
动作执行异常
- 检查电量是否充足
- 确保机器人处于稳定状态
- 尝试重启机器人
下一步
完成基本设置后，您可以：
- 尝试更多语音指令
- 自定义角色设定
- 开始自定义开发
如果遇到任何问题，请查看我们的常见问题解答或联系技术支持。