XGO-RangerWiki 首页
Wiki 首页/XGO-Ranger/Luwu-OS 用户手册 / 使用篇
XGO-Ranger 知识库Luwu-OS 用户手册 / 使用篇

AI 对话

适用版本新版 Luwu-OS
版本说明
系列共用文档切换机型,继续阅读本篇
共用内容按本机型的执行器、外设和版本使用。

在 Ranger 主界面进入AI 交互,即可通过语音提问、查看摄像头画面中的物体,并控制 Ranger 的运动、姿态和灯光。使用前,请让设备接入可访问互联网的 Wi-Fi,并完成设备绑定。

4.1 语音对话

4.1.1 进入 AI 交互

  1. 在主界面按 A 键(左)或 B 键(右),切换到AI 交互卡片,再按 D 键进入。
  2. 等待程序加载。设备已联网并完成绑定时,会进入表情对话页面;如果出现扫码添加设备页面,请先按 4.3 配网与绑定 完成设置。
  3. 看到表情和请说「小陆同学」唤醒提示后,即可开始语音交互。
设备页面页面说明
Ranger 主界面选中 AI 交互卡片AI 交互入口
选中卡片后,按 D 键进入。
Ranger 对话页面显示 A 配网绑定、B 打断、C 退出和小陆同学唤醒提示刚进入对话页面
屏幕显示表情、唤醒提示,以及 A 配网绑定、B 打断、C 退出的按键提示。
Ranger 隐藏操作提示后的表情待机页面表情待机页面
进入约 10 秒后,按键和唤醒提示会自动隐藏。仍可说唤醒词或按 B 键开始对话,按键功能不受影响。

4.1.2 开始、打断与结束对话

  1. 对 Ranger 说“小陆同学”,唤醒后再说出问题或指令,例如“给我讲一个小故事”。待机时,也可以直接按 B 键开始说话。
  2. Ranger 会通过语音回答,屏幕配合显示表情和对话文字。
  3. 回答过程中按 B 键,可打断当前播报并继续提出新问题;正在聆听时按 B 键,则结束当前会话并回到待机。
  4. 需要离开 AI 交互时,按 C 键返回主界面。

中文模式的唤醒词为“小陆同学”,英文模式为“Hi Luka”。按键操作如下:

按键操作说明
A 键打开配网绑定页面,用手机扫码进行网络设置和设备绑定。
B 键待机时:直接开始聆听,无需先说唤醒词。
播报时:打断回答,转为聆听。
聆听时:结束当前会话,回到待机。
C 键退出 AI 交互,返回主界面。

4.2 功能说明

4.2.1 语音问答与视觉交互

功能使用方法
语音问答唤醒后提出问题,例如“为什么天空是蓝色的?”“给我讲一个小故事”。
视觉问答将物体放在 Ranger 摄像头前,唤醒后说“看看你面前是什么”。触发拍照分析时,屏幕会短暂显示拍摄画面,再恢复表情;Ranger 根据拍摄内容回答。
表情与文字交互过程中,屏幕会随对话显示相应表情和文字;待机时继续显示表情动画。
音量调节可以说“把音量调到百分之五十”,调整设备的语音播放音量。

语音回答和视觉分析需要网络服务支持。进行视觉问答时,请让镜头朝向目标,并保持光线充足。

4.2.2 用语音控制 Ranger

Ranger 的语音控制包括轮足/小车模式切换、前后移动、转向、姿态调节和预设动作。体验运动指令时,请将 Ranger 放在平坦、开阔的地面上。可参考以下说法:

控制项目语音指令示例
运动模式“切换到轮足模式”“切换到小车模式”。
移动与转向“向前移动”“向后移动”“向左转”“向右转”;需要停下时说“停止运动”。
高度与姿态“把身体升高一点”“把身体降低一点”“调整一下俯仰姿态”。轮足模式下还可调节左右倾斜。
预设动作“做一个左右摇摆动作”“做一个高低起伏动作”。还支持前进后退、四方蛇形、升降旋转、圆周晃动。
表演模式“开启表演模式”“关闭表演模式”。
姿态自稳“开启姿态自稳”“关闭姿态自稳”。姿态自稳只在轮足模式下生效。
RGB 灯“把灯光调成蓝色”。
恢复初始状态“让机器人恢复初始状态”。

建议一次说清一个操作,观察 Ranger 的响应后再继续。需要直接调节姿态或操作动作按钮时,可使用 3.1 手机 App 遥控。

4.3 微信小程序配网与绑定

首次使用、设备未联网或尚未完成绑定时,Ranger 会显示扫码添加设备页面。在 AI 对话页面按 A 键,也可以打开配网绑定页面。

设备页面操作说明
Ranger 扫码添加设备页面,提示微信扫描二维码配网并绑定打开手机蓝牙,使用微信扫一扫扫描设备屏幕上的小程序码,进入小陆同学小程序。
设备屏幕底部会显示等待手机配网的名称,示例为 XGO-RangerC4E9,请以自己的设备为准。

Ranger 的配网入口:在 AI 交互页面按 A 键,保持设备停留在扫码配网页,再用手机搜索。小程序搜索页中的“长按背部按钮约 3 秒”是通用提示,Ranger 请按这里的 A 键操作进入配网。

4.3.1 添加设备并连接 Wi-Fi

小程序页面(点击图片可放大)操作说明
小陆同学小程序首页,显示暂无设备和添加设备按钮1. 添加设备

首次进入时,首页显示暂无设备。点击添加设备,进入蓝牙配网流程。

蓝牙配网页的搜索设备步骤,底部有开始搜索按钮2. 开始搜索

确认 Ranger 已开机并停留在配网绑定页面,手机蓝牙已开启。点击开始搜索,按微信提示允许蓝牙等所需权限。

蓝牙配网发现 XGO-RangerC4E9 设备3. 选择 Ranger

在搜索结果中点击与设备屏幕名称对应的 Ranger。本例为 XGO-RangerC4E9,右侧的 dBm 数值表示蓝牙信号强度。

未发现设备时,靠近 Ranger,检查手机蓝牙与小程序权限,再点击开始搜索重试。

连接设备后正在扫描 Wi-Fi,可跳过搜索手动输入4. 等待扫描 Wi-Fi

连接设备后,小程序会获取周围无线网络列表。等待扫描完成后选择网络;需要手动填写网络时,可点击跳过搜索,手动输入。

连接 Wi-Fi 页面,填写网络名称和密码后开始配网5. 填写网络信息

确认网络名称并输入对应的WiFi 密码,然后点击开始配网。截图中的 XGO2 仅为示例,请填写自己要连接的网络。

小程序显示正在配网,等待设备连接网络6. 等待配网完成

页面显示正在配网…,表示 Wi-Fi 配置已发送给 Ranger。保持设备开机,等待连接结果。

小程序显示配网成功、设备绑定成功和注入生命体按钮7. 确认配网与绑定成功

页面显示配网成功!、已连接的网络名称和设备绑定成功后,点击注入生命体,继续选择对话角色。

完成配网与绑定后,等待 Ranger 进入表情对话页面。需要退出设备端配网绑定页面时,按 C 键返回主界面。

4.4 生命体与角色配置

小程序中的生命体用于选择和管理 AI 对话角色。首次绑定后可以选择一个角色,之后也可以从首页的当前生命体入口切换或编辑。

4.4.1 注入与切换生命体

小程序页面(点击图片可放大)操作说明
注入生命体页面,选中小陆同学后点击注入选择角色并注入

在注入生命体页面选择所需角色,例如小陆同学,再点击底部注入。可展开角色卡片查看属性、相识日期等信息。

角色列表以小程序实际显示为准。

绑定后的 Ranger 首页,显示当前设备、当前生命体、群控和遥控入口查看绑定后的首页

首页顶部显示当前设备名称与连接状态,本例为 XGO-Ranger-E8;中间显示 Ranger 图片和当前生命体。

点击当前生命体进入角色管理;点击遥控进入 Ranger 控制页面,点击齿轮图标进入设备设置。首页还提供群控入口,并展示交互次数、五维人格等信息。

底部可切换小陆、日志、更多三个页面。

生命体管理列表,当前角色标记当前使用,其他角色可使用或编辑切换或编辑角色

当前角色带有当前使用标记。点击其他角色右侧的使用进行切换;点击编辑进入该角色的配置页面。

4.4.2 编辑角色配置

在角色列表点击编辑,可设置昵称、角色介绍、对话模型、记忆、知识库和声音。修改完成后点击保存配置,配置将在下次对话时生效。

小程序页面(点击图片可放大)操作说明
角色配置长图,包含基本信息、模型配置、语音设置、保存配置和 MCP 接入点角色配置页面

页面依次包含基本信息、模型配置、语音设置和MCP 接入点。

可编辑助手昵称与角色介绍,也可按需使用AI 优化。模型、记忆模式和声音均从相应选项中选择。

截图中的模型、音色和记忆模式是当前角色的示例配置,实际可选项以小程序页面为准。

完成修改后,点击绿色的保存配置按钮。

项目说明
助手昵称与角色介绍设置角色的称呼、背景和交流风格。
大语言模型(LLM)选择用于生成对话回答的模型。
记忆模式选择角色使用的记忆方式。截图示例为长期记忆。
知识库选择要关联的知识库,或选择不使用;点击管理知识库可进入知识库页面。
对话语言选择角色使用的对话语言。设备唤醒时仍以屏幕上的唤醒词提示为准。
语音识别(ASR)选择将用户语音转换为文字的识别服务。
语音合成(TTS)与声音音色选择机器人回答时使用的语音合成服务和音色,也可通过复刻专属声音创建声音。
MCP 接入点用于接入 Home Assistant 等外部工具,页面提供专属连接地址和工具检测;普通语音对话无需设置。

4.5 小程序遥控与设备设置

4.5.1 Ranger 遥控

在小程序首页点击遥控,进入当前设备的控制页面。连接 Ranger 时,页面提供方向控制、速度调节、运动模式和预设动作。

小程序页面(点击图片可放大)操作说明
Ranger 小程序遥控页面,包含方向控制、速度、轮足和小车模式及预设动作方向与动作控制

使用上、下箭头控制前进和后退,左、右箭头控制转向;点击中央红色方块停止运动。

拖动速度滑条调整速度。点击轮足模式或小车模式切换运动模式,当前选项以绿色高亮显示。

预设动作包括左右摇摆、高低起伏、前进后退、四方蛇形、升降旋转、圆周晃动;下方还提供重置、表演模式、关闭表演按钮。

4.5.2 设备设置

点击小程序首页右上角的齿轮图标进入设备设置,可查看设备连接信息并调整音量、自动打断等选项。

小程序页面(点击图片可放大)操作说明
Ranger 设备设置页面,显示设备信息、音量、网络、自动打断和 MCP 控制设备查看状态与调整语音设置

设备信息:查看设备名称、MAC 地址和在线状态。

设备状态:通过音量旁的− / +按钮调节音量,并查看网络类型、Wi-Fi 名称、信号强度和固件版本。

自动打断:可通过开关启用或关闭。关闭时,如需打断 AI 回答,可按 Ranger 的B 键。

MCP 控制设备:页面下方提供设备接入配置,供有外部控制需求时使用。

4.6 更多功能

点击小程序底部的更多,可进入声音复刻、知识库、扫码登录网页版等功能。

小程序页面(点击图片可放大)操作说明
小程序更多页面,提供声音复刻、知识库、扫码登录网页版、联系客服和关于更多页面

页面提供声音复刻、知识库、扫码登录网页版、联系客服、关于入口,以及退出登录按钮。

4.6.1 声音复刻

从更多 → 声音复刻进入,也可以点击角色配置中的复刻专属声音。

小程序页面(点击图片可放大)操作说明
声音复刻页面,填写名称、选择 TTS 引擎、录音或选文件后开始复刻创建并使用复刻声音
  1. 填写声音名称,选择 TTS 引擎。
  2. 点击开始录音,或通过选文件提供音频。页面建议录音 15–30 秒、清晰自然说话,文件不超过 10 MB。
  3. 准备完成后点击开始复刻。
  4. 复刻成功后点击使用此声音,再保存智能体配置。

也可以进入角色配置,手动选择复刻声音对应的语音合成(TTS)模型和声音音色,然后保存。

4.6.2 知识库

小程序页面(点击图片可放大)操作说明
知识库页面显示暂无知识库,顶部可新建知识库创建并关联知识库

从更多 → 知识库进入,点击+ 新建知识库,按照页面提示创建。

创建后,进入角色配置 → 知识库选择要使用的知识库,再点击保存配置。角色配置中的管理知识库也可进入此页面。

4.6.3 扫码登录网页版

小程序页面(点击图片可放大)操作说明
扫码登录页面,提示在电脑打开 agent.xgorobot.com 后扫描网页二维码用小程序登录电脑网页版
  1. 在电脑浏览器打开 agent.xgorobot.com。
  2. 在小程序中进入更多 → 扫码登录网页版。
  3. 点击点击扫码,扫描电脑网页显示的二维码。
  4. 扫码后自动确认登录,电脑网页将使用当前小程序账号登录。

4.7 示例程序:AI 交互开发版

Ranger 的示例程序中还提供AI交互开发版,适合需要自行配置模型服务、API Key、语音识别、语音合成和角色提示词的用户。开发版通过设备提供的局域网网页进行设置。

入口配置方式
主界面 → AI 交互通过微信小陆同学小程序完成设备绑定、生命体选择和角色配置,见 4.3 微信小程序配网与绑定。
示例程序 → AI交互开发版打开设备屏幕显示的 IP 地址:5000,使用自己的模型服务配置和 API Key。

4.7.1 进入开发版与打开配置网页

  1. 先让 Ranger 连接 Wi-Fi,并让电脑连接到同一局域网。
  2. 在主界面选择示例程序并按 D 键进入,再按 A / B 键找到AI交互开发版,按 D 键打开。
  3. 等待程序加载。首次配置时,设备会显示网页访问地址;已有完整配置并进入待机后,可按 A 键返回地址页。
  4. 在电脑浏览器地址栏输入屏幕上的完整地址,例如 http://192.168.31.208:5000。设备 IP 会随网络变化,请以自己的屏幕显示为准。
设备页面操作说明
Ranger 示例程序中选中 AI交互开发版示例程序入口

选中AI交互开发版后按 D 键进入。

Ranger 开发版地址页,提示在同局域网电脑浏览器中打开 192.168.31.208:5000设备提供的配置地址

在同一局域网的电脑上,用浏览器打开屏幕地址。访问配置网页时,请保持开发版程序运行。

4.7.2 首次配置 API Key 与角色

打开网页后,首页显示欢迎使用 Luwu AI,提供 API Key、区域选择、角色配置和更多设置入口。

网页截图(点击可放大)操作说明
Ranger AI 交互开发版网页:欢迎配置页欢迎与配置入口
  1. 使用页面提供的服务商入口获取自己的 API Key,按服务商页面要求完成准备。
  2. 选择与 API Key 对应的区域,将 Key 粘贴到输入框,点击保存 Key,等待页面显示连接测试结果。
  3. 点击配置角色,设置角色称呼、交流风格和当前提示词,然后点击保存配置。
  4. 需要使用其他模型或分别设置语音服务时,点击使用其他模型 / 更多设置。

开发版开始对话前,需要完成 AI 大脑、语音识别、语音合成和角色提示词配置。

使用阿里云服务时,页面会同步相关标签页中的 API Key;选择其他服务商时,请分别填写对应的服务配置。

4.7.3 模型、语音与角色设置

详细设置页面顶部有AI 大脑、语音识别、语音合成、角色四个标签。修改后点击底部的保存配置。

网页截图(点击可放大)配置说明
Ranger AI 交互开发版网页:AI 大脑配置页AI 大脑

选择服务商预设和区域,填写 API 密钥、Base URL 和对话模型。

VLM Model(Vision/Photo)用于配置拍照识别使用的视觉模型。

需要用语音控制 Ranger 时,开启启用函数调用(机器人控制);需要联网检索时,可按需开启启用联网搜索。这些功能需要所选服务和模型支持。

点击测试 AI 大脑连接可检查连接,完成后保存配置。

Ranger AI 交互开发版网页:语音识别配置页语音识别

设置将用户语音转换为文字的服务,包括服务商、区域、API 密钥、模型和识别语言。

页面还提供VAD 阈值和静音时长,用于调整语音活动判断和停顿检测。

填写后可点击测试语音识别连接,再保存配置。

Ranger AI 交互开发版网页:语音合成配置页语音合成

设置 Ranger 回答时使用的语音服务,包括服务商、区域、API 密钥和音色;可选字段会随服务商变化。

点击测试语音合成检查语音服务,再保存配置。

Ranger AI 交互开发版网页:角色配置页(已有文本已隐藏)角色

设置智能体名字、叫我什么、输出语言,选择性格类型,并填写对机器人的具体要求。

可点击自动生成提示词,也可以手动编辑当前提示词。自动生成需要先配置好 AI 大脑。

长期记忆可按需启用,页面提供记忆内容查看和清除记忆按钮。

完成后点击保存配置。截图中的称呼、提示词和记忆内容已隐藏。

截图中的模型、音色和参数为设备当前页面示例,请按自己所用服务选择。

4.7.4 开始对话与按键操作

配置完整后,设备可进入唤醒待机。按屏幕提示说“小陆同学”开始对话,也可以按 D 键直接开始。开发版的按键功能如下:

设备页面页面说明
Ranger AI 交互开发版完成配置后的表情待机页面配置完成后的待机状态

屏幕显示表情动画。按键和唤醒提示会自动隐藏,仍可使用唤醒词或按 D 键开始对话。

按键开发版中的功能
A 键:配置中断当前对话,返回显示局域网网页地址的配置页面。
B 键:打断打断当前回答,重新进入聆听;配置完成后,待机时也可用此键开始交互。
C 键:退出退出 AI 交互开发版,返回示例程序。
D 键:开始待机或配置页面中开始对话;交互过程中按下,会打断并重新开始聆听。需要先完成配置。

开启函数调用(机器人控制)后,可以使用 Ranger 的前后移动、转向、轮足/小车模式切换、姿态调节、RGB 灯和预设动作等功能。例如“切换到轮足模式”“做一个左右摇摆动作”“停止运动”,更多示例见 4.2.2 用语音控制 Ranger。姿态自稳仅在轮足模式下生效。

4.7.5 配置时的常见情况

情况处理方法
网页打不开检查电脑与 Ranger 是否处于同一局域网,并确认设备仍在运行开发版。按照设备屏幕上的当前 IP 地址访问,带上 http:// 和端口 :5000。
保存 Key 或模型测试失败检查 API Key、区域、Base URL 和模型是否匹配,并确认 Ranger 能访问所选模型服务。
按 D 键仍未开始对话检查 AI 大脑、语音识别和语音合成的必填配置是否完整,角色的当前提示词是否为空,并点击保存配置。
可以聊天,但没有执行动作检查AI 大脑 → 启用函数调用(机器人控制)是否开启,并确认所选模型支持函数调用。
需要拍照识别在AI 大脑中选择可用的视觉模型,并开启函数调用。让 Ranger 摄像头朝向目标后再提出视觉问题。

4.8 常见状态与处理

状态或使用情况处理方法
等待手机配网:XGO-Ranger…微信扫码进入小程序,点击添加设备 → 开始搜索,选择设备屏幕上对应的 Ranger。
小程序未发现设备确认 Ranger 停留在 AI 配网绑定页面,手机蓝牙及小程序权限已开启,靠近设备后重新搜索。
Wi-Fi 扫描未找到所需网络可使用跳过搜索,手动输入,填写网络名称和密码。
配网成功,等待绑定/请扫码绑定设备继续完成小程序中的配网绑定流程。看到设备绑定成功后,可点击注入生命体选择角色。
连接失败,请重试检查 Wi-Fi 名称、密码和网络信号,再通过小程序重试。
未连接服务器检查当前 Wi-Fi 是否可以访问互联网,网络恢复后重新进入 AI 交互。
角色配置修改后尚未生效确认已点击保存配置,结束当前会话后重新开始对话。
只有表情,没有按键或唤醒提示这是提示自动隐藏后的正常页面。说“小陆同学”或按 B 键即可开始对话。
唤醒没有反应靠近设备、减少环境噪声,并使用屏幕提示的唤醒词;也可以在待机时按 B 键直接开始聆听。
资料来源XGO 官方 Wiki
返回 XGO-Ranger 知识库目录