fujitatomoya/ros2ai

这是什么？

核心功能

• 01回答 ROS 2 相关问题，并给出对应的 ros2 命令。
• 02根据自然语言请求执行操作，例如列出节点或查看话题信息。
• 03可对接 OpenAI 模型，也可通过兼容接口使用本地 Ollama 服务。
• 04模型、接口地址和温度等参数可通过环境变量配置。
• 05提供 Debian 包和 Docker 镜像，也支持用 colcon 自行编译。

适用场景

• 初学者或学生边用边学习 ROS 2 命令行工具。
• 无需翻阅文档，快速找到完成某项任务所需的 ros2 命令。
• 在本地 Ollama 模型上运行，避免把 ROS 2 相关请求发送到云端 API。

快速上手

1. 1

   安装 ROS 2 Kilted 的二进制包

   apt install ros-kilted-ros2ai
2. 2

   安装所需的 Python 包（rolling、kilted、jazzy）

   pip install openai ollama validators --break-system-packages --ignore-installed
3. 3

   设置 OpenAI API 密钥，或配置 Ollama 并拉取模型

   export OPENAI_API_KEY='your-api-key-here'

使用前须知

• !需要 OpenAI API 密钥，或运行中的 Ollama 服务并已下载模型。
• !部分环境没有发布包，需要在 colcon 工作区中从源码构建。
• !仅支持 ROS 2 Humble、Jazzy、Kilted 和 Rolling 版本。

收录于专题

标签

常见问题

ros2ai 是什么？

为 ROS 2 命令行添加 LLM 能力，可用自然语言提问或执行 ROS 2 操作，支持 OpenAI 与 Ollama。 ros2ai 为 ROS 2 命令行增加了一个由大语言模型驱动的子命令，开发者可以直接用自然语言提问或下达指令，不必记住精确的 CLI 语法。它主要面向还不熟悉 ros2cli 的 ROS 2 初学者和学生。

ros2ai 可以免费使用吗？用的什么许可证？

ros2ai 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

ros2ai 还在维护吗？

活跃维护中。ros2ai 最近一次提交是在 2026年11月7日。

ros2ai 适合用来做什么？

初学者或学生边用边学习 ROS 2 命令行工具。 无需翻阅文档，快速找到完成某项任务所需的 ros2 命令。 在本地 Ollama 模型上运行，避免把 ROS 2 相关请求发送到云端 API。

ros2ai 怎么安装和运行？

安装 ROS 2 Kilted 的二进制包: apt install ros-kilted-ros2ai 安装所需的 Python 包（rolling、kilted、jazzy）: pip install openai ollama validators --break-system-packages --ignore-installed 设置 OpenAI API 密钥，或配置 Ollama 并拉取模型: export OPENAI_API_KEY='your-api-key-here'

在哪里获取 ros2ai？

源代码和安装说明在 GitHub 上：https://github.com/fujitatomoya/ros2ai