1. 為什么你的 OpenClaw 在嵌入式 Linux 上只會(huì)“動(dòng)嘴”如果你已經(jīng)在 OK1126B-S 這類開發(fā)板上跑通了 OpenClaw也接上了本地模型或者飛書入口大概率會(huì)遇到一個(gè)很尷尬的場(chǎng)景你問它“板子上有哪些 LED”它能答得頭頭是道你讓它“把 work 燈點(diǎn)亮”它回你一段看起來正確、但根本沒執(zhí)行的命令。問題不在模型而在于它沒有“手”。OpenClaw 本身是一個(gè)對(duì)話與任務(wù)編排框架模型負(fù)責(zé)理解意圖但真正去讀寫/sys/class/leds/、操作 GPIO、跑一段 shell 的是 Skills 機(jī)制。沒有 SkillOpenClaw 就只是一個(gè)裝在開發(fā)板上的聊天窗口有了 Skill它才會(huì)在識(shí)別到“點(diǎn)燈”“閃爍”“讀 GPIO”這類意圖時(shí)主動(dòng)去調(diào)用本地腳本并返回真實(shí)執(zhí)行結(jié)果。這篇就圍繞嵌入式 Linux 場(chǎng)景把 Skills 和 SKILL.md 講清楚Skill 目錄放哪、SKILL.md 怎么寫、scripts 里的 GPIO 腳本怎么組織最后給一條可以直接復(fù)制運(yùn)行的 GPIO 讀寫驗(yàn)證動(dòng)作讓你確認(rèn) OpenClaw 是真的在“干活”而不是在“背課文”。適合已經(jīng)在開發(fā)板上部署過 OpenClaw、想讓它接管硬件外設(shè)的嵌入式開發(fā)者。2. 前置準(zhǔn)備TaoToken 與 OpenClaw 的接入位置在寫 Skill 之前先把模型調(diào)用這條鏈路理順。OpenClaw 的“大腦”需要穩(wěn)定的模型接口我這邊習(xí)慣用 TaoToken 來做統(tǒng)一接入它的 API 地址是https://taotoken.net/api兼容常見的 OpenAI 風(fēng)格調(diào)用方式配置到 OpenClaw 的模型后端里就行。具體操作上先在 TaoToken 控制臺(tái)創(chuàng)建一個(gè) API Key然后把它填到 OpenClaw 的模型配置中。控制臺(tái)入口在這里控制臺(tái)https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite創(chuàng)建 Key 的頁面API Keyshttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite如果你還沒決定用哪個(gè)模型可以先去模型對(duì)話頁面試一下確認(rèn)模型對(duì)“GPIO”“LED”“shell 腳本”這類嵌入式語義的理解是否到位模型對(duì)話https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite接入文檔里有 OpenClaw 這類客戶端的具體配置字段說明建議對(duì)照著填接入文檔https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite這一步的意義在于Skill 負(fù)責(zé)“做什么”模型負(fù)責(zé)“判斷該不該做、用哪個(gè)參數(shù)做”。兩者缺一不可。模型接口不穩(wěn)定Skill 觸發(fā)就會(huì)時(shí)靈時(shí)不靈Skill 寫得不清楚模型再強(qiáng)也不知道該調(diào)哪個(gè)腳本。3. 可復(fù)制配置SKILL.md 骨架與 Skills 目錄3.1 Skill 目錄結(jié)構(gòu)與命名規(guī)范OpenClaw 默認(rèn)從下面這個(gè)路徑加載 Skill~/.openclaw/workspace/skills/${SKILL_NAME}一個(gè)完整的 Skill 目錄長(zhǎng)這樣gpio-led-control/ ├── SKILL.md # 核心元數(shù)據(jù) 操作手冊(cè) ├── scripts/ # 可直接運(yùn)行的腳本 │ ├── led_on.sh │ ├── led_off.sh │ └── led_blink.sh ├── references/ # 按需加載的參考資料 │ └── ok1126b-led-map.md └── assets/ # 輸出用資源不參與推理 └── led-report-template.md目錄名有硬性規(guī)范只能用小寫字母、數(shù)字和連字符比如gpio-led-control。我踩過的坑就是一開始用了下劃線gpio_led_control結(jié)果 OpenClaw 死活不加載排查半天才發(fā)現(xiàn)是命名問題。這一點(diǎn)在嵌入式場(chǎng)景里尤其要注意因?yàn)楹芏喙こ處熈?xí)慣用下劃線命名腳本。3.2 SKILL.md 的元數(shù)據(jù)部分SKILL.md 分兩段前置元數(shù)據(jù)和正文。元數(shù)據(jù)用---包裹負(fù)責(zé)讓 OpenClaw 識(shí)別和語義匹配--- name: gpio-led-control description: 控制嵌入式 Linux 開發(fā)板上的 GPIO LED支持點(diǎn)亮、熄滅、按節(jié)奏閃爍適用于 OK1126B-S 等板卡。 user-invocable: true ---name和description是必填。description寫得越貼近用戶真實(shí)說法觸發(fā)越準(zhǔn)。比如用戶會(huì)說“讓燈閃起來”“work 燈亮一下”那 description 里就該出現(xiàn)“點(diǎn)亮”“熄滅”“閃爍”這些詞而不是只寫“LED 控制”。3.3 SKILL.md 正文操作手冊(cè)怎么寫正文是給模型看的“行動(dòng)指南”要寫清楚什么時(shí)候執(zhí)行、執(zhí)行哪個(gè)腳本、參數(shù)怎么傳。下面是一份可以直接改的骨架# GPIO LED Control - 開發(fā)板 LED 燈控制 控制 OK1126B-S 等開發(fā)板上的系統(tǒng) LEDwork / net 等。 ## 快速開始 ### 查看可用 LED 執(zhí)行l(wèi)s /sys/class/leds/ ### 點(diǎn)亮指定 LED 執(zhí)行bash scripts/led_on.sh led_name 示例bash scripts/led_on.sh work ### 熄滅指定 LED 執(zhí)行bash scripts/led_off.sh led_name ### 按節(jié)奏閃爍 執(zhí)行bash scripts/led_blink.sh led_name interval_ms count 示例bash scripts/led_blink.sh work 500 6 ## 使用場(chǎng)景示例 - 用戶說“把 work 燈點(diǎn)亮” → 調(diào)用 led_on.sh work - 用戶說“讓 net 燈閃 6 次每次 500 毫秒” → 調(diào)用 led_blink.sh net 500 6 - 用戶說“現(xiàn)在有哪些燈” → 執(zhí)行 ls /sys/class/leds/ ## 權(quán)限說明 操作 /sys/class/leds/ 通常需要 root 權(quán)限腳本內(nèi)已包含 sudo 判斷。 ## 注意事項(xiàng) - 執(zhí)行前先確認(rèn) LED 名稱存在不存在則返回錯(cuò)誤提示。 - 閃爍間隔不要低于 100ms避免占用過多 CPU。正文里把“用戶可能怎么說”和“對(duì)應(yīng)執(zhí)行什么”一一列出來模型匹配起來就穩(wěn)。很多人 Skill 不觸發(fā)不是模型笨是正文里只寫了命令沒寫觸發(fā)語。3.4 scripts 里的 GPIO 腳本scripts/放固定邏輯的腳本避免模型每次現(xiàn)生成代碼。以led_blink.sh為例#!/bin/bash # led_blink.sh - 按節(jié)奏閃爍指定 LED LED_NAME$1 INTERVAL_MS${2:-500} COUNT${3:-6} LED_PATH/sys/class/leds/${LED_NAME} if [ ! -d $LED_PATH ]; then echo ERROR: LED ${LED_NAME} 不存在可用 LED ls /sys/class/leds/ exit 1 fi for i in $(seq 1 $COUNT); do echo 1 ${LED_PATH}/brightness sleep $(echo scale3; ${INTERVAL_MS}/1000 | bc) echo 0 ${LED_PATH}/brightness sleep $(echo scale3; ${INTERVAL_MS}/1000 | bc) done echo OK: ${LED_NAME} 已閃爍 ${COUNT} 次間隔 ${INTERVAL_MS}ms腳本最后一定要輸出明確的結(jié)果字符串OpenClaw 會(huì)把這段回顯給用戶用戶才知道是真執(zhí)行了。4. 驗(yàn)證請(qǐng)求確認(rèn) OpenClaw 真的在主動(dòng)執(zhí)行配置完成后重啟 OpenClaw 讓它重新加載 Skill 目錄openclaw restart # 或者 systemctl --user restart openclaw然后通過飛書或本地對(duì)話入口發(fā)一條自然語言指令讓 work 燈閃 6 次每次間隔 500 毫秒預(yù)期行為是OpenClaw 識(shí)別意圖 → 匹配gpio-led-control→ 讀取 SKILL.md → 調(diào)用scripts/led_blink.sh work 500 6→ 返回類似下面的結(jié)果OK: work 已閃爍 6 次間隔 500ms同時(shí)你盯著開發(fā)板work 燈應(yīng)該真的在閃。如果燈閃了、回顯也對(duì)說明 OpenClaw 已經(jīng)從“只會(huì)答”變成“會(huì)做”了。再補(bǔ)一條 GPIO 讀寫的直接驗(yàn)證確認(rèn)底層通路沒問題# 讀一個(gè) GPIO 的當(dāng)前方向 cat /sys/class/gpio/gpio12/direction # 導(dǎo)出并設(shè)置為輸出點(diǎn)亮 echo 12 /sys/class/gpio/export echo out /sys/class/gpio/gpio12/direction echo 1 /sys/class/gpio/gpio12/value # 讀取當(dāng)前值 cat /sys/class/gpio/gpio12/value把這段邏輯也封裝成scripts/gpio_rw.sh在 SKILL.md 里加一條“讀寫任意 GPIO”的說明OpenClaw 就能接管更通用的引腳操作而不只是板載 LED。5. 本篇常見錯(cuò)排查Skill 不加載九成是目錄名不規(guī)范。檢查是否用了下劃線、大寫字母或中文。必須是小寫字母數(shù)字連字符。Skill 加載了但不觸發(fā)看 SKILL.md 的description和正文觸發(fā)語。用戶說“閃一下”你只寫了“閃爍控制”匹配度就低。把口語化說法補(bǔ)進(jìn)去。腳本執(zhí)行報(bào)權(quán)限錯(cuò)誤/sys/class/leds/和/sys/class/gpio/多數(shù)需要 root。要么腳本里加 sudo要么給 OpenClaw 運(yùn)行用戶配置對(duì)應(yīng)的 udev 規(guī)則?；仫@是模型編的燈沒動(dòng)說明模型沒真正調(diào)用腳本而是自己“腦補(bǔ)”了結(jié)果。檢查 SKILL.md 里是否明確寫了“必須執(zhí)行 scripts 下的腳本不得自行編造輸出”。閃爍間隔異常sleep不支持小數(shù)時(shí)用bc或改成毫秒級(jí)usleep。上面腳本用了bc如果板子上沒裝換成整數(shù)秒或sleep 0.5的寫法。GPIO 導(dǎo)出失敗部分內(nèi)核已經(jīng)廢棄 sysfs GPIO改用libgpiod。這時(shí)把腳本里的echo /sys/class/gpio/換成gpioset/gpioget命令即可SKILL.md 里同步更新調(diào)用方式。6. 讓 OpenClaw 長(zhǎng)期接管嵌入式任務(wù)單次點(diǎn)燈只是驗(yàn)證。真正讓 OpenClaw 在嵌入式 Linux 上長(zhǎng)期干活建議把常用外設(shè)都做成獨(dú)立 SkillUART 收發(fā)、I2C 讀傳感器、SPI 驅(qū)動(dòng)屏幕、PWM 調(diào)電機(jī)。每個(gè) Skill 一個(gè)目錄SKILL.md 寫清觸發(fā)語和腳本入口scripts 里放穩(wěn)定腳本references 里放寄存器手冊(cè)和引腳映射。如果你打算讓它承擔(dān)更連續(xù)的編碼和 Agent 任務(wù)比如自動(dòng)寫驅(qū)動(dòng)、批量改設(shè)備樹、跑回歸腳本可以了解下 Coding Plan把長(zhǎng)期編碼場(chǎng)景的額度規(guī)劃好Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewriteClaude Code 這類編碼 Agent 的接入方式在文檔里也有說明ClaudeCodeAnthropichttps://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude-code-anthropicutm_campaignrewrite回到最實(shí)際的一點(diǎn)先把gpio-led-control這個(gè) Skill 跑通看著燈真的閃起來再去擴(kuò)展下一個(gè)外設(shè)。嵌入式場(chǎng)景里能動(dòng)手的 OpenClaw價(jià)值遠(yuǎn)大于能聊天的 OpenClaw。