Skip to main content

OpenClaw AI编写脚本控制外设教程

开始前请先完成 使用前准备 目录下的 [01-外设硬件配置]、[02-openclaw Ajetson-KEY配置]、[03-openclaw切换模型]、[04-AI语音交互配置]、[05-三种对话方案配置测试]。如果当前只使用 TUI / 飞书，可以先跳过 04。本文默认基础环境已经准备完成，只展开“让 AI 生成可独立运行脚本”这部分内容。

1. 教程目标​

本文通过“自然语言生成硬件脚本”的方式，展示 OpenClaw 不只是能直接控制外设，也能帮你把控制逻辑保存成脚本文件。完成本教程后，读者可以：

  • 了解 OpenClaw 生成硬件控制脚本的基本思路

  • 通过飞书、TUI、语音代码三种方式和 OpenClaw 对话

  • 生成四类常见脚本：RGB、舵机、温湿度、OLED

2. 硬件准备​

  • OpenClaw 主控板

  • 舵机 / RGB 灯条 / OLED / DHT 温湿度传感器

  • [可选] AI语音模块 + 扬声器

说明：

  • 本教程不要求一次把所有外设都接上

  • 你准备演示哪一类脚本，就先接好对应硬件

3. 软件准备​

教程中会用到的代码入口

  • 脚本生成技能：/home/jetson/.openclaw/workspace/skills/script-runner/SKILL.md

  • 脚本默认保存目录：/home/jetson/Desktop/

  • 硬件命令示例目录：/home/jetson/hardware_hal_demo/

  • 语音入口：/home/jetson/voice_to_openclaw/src/main.py

当前这类能力的核心不是“执行一条即时命令”，而是让 OpenClaw 帮你生成一个可独立运行的 Python 脚本。根据现有技能约定：

  • 用户说“生成脚本”“写个脚本”“保存到桌面”时，会优先走 script-runner

  • 硬件脚本默认使用 openclaw_lib

  • 默认串口是 /dev/ttyTHS1

  • 默认波特率是 115200

  • 脚本通常保存在 /home/jetson/Desktop/

你可以把它理解成两种使用方式：

  • 方式一：生成脚本并立即运行

  • 方式二：只生成脚本，先保存到桌面，后续再自己修改或二次运行

4. 测试脚本生成能力​

开始当前教程前，请先完成一次 openclaw tui 基础对话自检；如果还没做，先看 [05-三种对话方案配置测试]。确认 OpenClaw 能正常回复后，再进入脚本生成专项测试。

终端输入以下命令进入 TUI：

openclaw tui

image-20260529193959497

建议先从最简单的脚本需求开始，例如：

  • 帮我写个脚本让 RGB 红灯闪烁 5 次，保存到桌面并运行

  • 生成一个读取温湿度的脚本，先不要运行

  • 写个脚本让舵机 1 在 0、90、180 度之间往返摆动

  • 生成一个 OLED 显示“Hello OpenClaw”的脚本

5. 和 OpenClaw 对话的三种方案​

方案适合场景优点建议定位
飞书远程发需求、课堂演示可以直接描述“帮我写什么脚本”用来展示自然语言生成能力
TUI本地调试、校验生成结果最容易看见脚本生成与运行返回首选调试方案
语音代码语音交互、完整 AI 体验可以直接口头描述脚本需求作为完整演示方案

如果选配了AI语音模块+扬声器，飞书对话、tui、whatsapp对话需要播报openclaw回复的内容，可以终端运行下面的程序，ai语音模块对话不需要重复运行

  • 修改是否打开播报参数

xxxxxxxxxx /home/jetson/voice_to_openclaw/.env xxxxxxxxxx ENABLE_TTS = true #这个参数就是控制是否播报，修改完保存，终端运行下面程序

  • 终端输入

xxxxxxxxxx cd ~/ voice_to_openclaw source . venv / bin / activate python \- m src . openclaw_session_tts

image-20260529194025490

5.1 飞书方案​

飞书接入步骤请直接参考 [05-三种对话方案配置测试]，本节只保留适合脚本生成教程的对话示例。

可以直接对话，例如：

  • 生成一个舵机左右摆动 10 秒的脚本并运行

image-20260428185931543

5.2 TUI 方案​

如果已经完成第 0 篇中的 TUI 自检，直接在终端输入下面命令即可继续对话：

xxxxxxxxxx openclaw tui

然后就可以直接输入脚本需求，例如：

  • 帮我写个脚本控制 RGB 变成蓝色呼吸灯并运行

image-20260428190049521

5.3 语音代码方案​

xxxxxxxxxx 需要选配 ai 语音交互模块 + 扬声器

语音模块安装、环境配置和基础唤醒流程请直接参考 [04-AI语音交互配置]。唤醒之后，可以直接说出控制内容，例如：

  • 写个脚本把当前温湿度显示到屏幕上并运行

image-20260529194118400

6. 综合案例​

注意：下面都是在 openclaw tui 方式进行对话演示，你也可以自己选择飞书或语音方式来完成。

6.1 案例一：RGB 闪烁脚本​

实验目标​

让 OpenClaw 生成一个基础灯光脚本，用来验证“脚本创建 + 外设执行”链路。

效果说明​

OpenClaw 会把你的自然语言需求整理成一个 Python 脚本，脚本保存到桌面后，可以直接运行，也可以留作后续修改。

示例指令​

  • 帮我写个脚本让 RGB 红灯闪烁 5 次

  • 生成一个蓝色呼吸灯脚本，保存到桌面并运行

  • 写个脚本让 RGB 做一段彩虹灯效

6.2 案例二：舵机动作脚本​

实验目标​

生成一个舵机动作脚本，把单次对话动作固化成可重复运行的程序。

效果说明​

这类脚本适合做“点头”“摇头”“往返摆动”“回中”等动作，也适合后续继续扩展成课堂演示或组合项目。

示例指令​

  • 写个脚本让舵机 1 在 0、90、180 度之间往返运动

  • 生成一个舵机点头脚本

  • 帮我写个脚本让四路舵机一起回到 90 度

6.3 案例三：温湿度读取脚本​

实验目标​

生成一个读取当前温湿度并输出结果的脚本。

效果说明​

这种脚本适合做传感器自检、数据采样或后续日志记录，也是后面做定时任务时最常用的一类基础脚本。

示例指令​

  • 生成一个读取温湿度的脚本，保存到桌面

  • 帮我写个脚本打印当前温度和湿度

  • 写个脚本读取一次 DHT 数据并运行

6.4 案例四：OLED 显示脚本​

实验目标​

生成一个把文字或指标内容显示到 OLED 上的脚本。

效果说明​

这个案例适合做欢迎页、状态页、简易仪表盘，也是后续和温湿度、摄像头等能力联动的基础。

示例指令​

  • 帮我写个脚本在 OLED 上显示“Hello OpenClaw”

  • 生成一个脚本把温湿度显示到 OLED 上

  • 写个脚本显示一页简单的状态信息

6.5 案例五：组合脚本​

实验目标​

让 OpenClaw 一次生成一个包含多个外设动作的综合脚本。

效果说明​

这类脚本可以把“读取传感器”“显示到 OLED”“控制 RGB”“驱动舵机”串起来，适合从单外设控制过渡到小型项目脚本。

示例指令​

  • 写个综合脚本：读取温湿度后显示到 OLED

  • 生成一个脚本：先亮绿灯，再让舵机转到 90 度

  • 帮我写个脚本：温度过高就亮红灯并在 OLED 上提示