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