定復(fù)用”)
1. 為什么你的 OpenClaw 智能體總是“這次行下次不行”如果你用過(guò) OpenClaw 這類智能體框架跑稍微復(fù)雜一點(diǎn)的任務(wù)大概率遇到過(guò)這種場(chǎng)景第一次對(duì)話你反復(fù)調(diào)整措辭、補(bǔ)充上下文終于讓它按你想要的路徑跑通了第二天你信心滿滿地復(fù)述同樣的需求它卻換了一條完全不同的路線輸出格式變了中間步驟跳了甚至工具都沒(méi)調(diào)對(duì)。這不是模型“變笨”了而是采樣機(jī)制決定的——大模型每次生成都帶有隨機(jī)性長(zhǎng)會(huì)話里歷史信息越堆越多上下文污染和 token 消耗同步上升執(zhí)行路徑自然就不穩(wěn)定。我試過(guò)最典型的例子是日志排查。同一個(gè)報(bào)錯(cuò)第一次我引導(dǎo)它先讀日志、再檢索歷史經(jīng)驗(yàn)、最后按置信度給根因輸出很漂亮第二次我只說(shuō)“看下這個(gè)報(bào)錯(cuò)”它直接憑常識(shí)猜了一個(gè)原因連日志文件都沒(méi)打開。問(wèn)題不在于模型能力而在于“偶然成功”沒(méi)有被固化下來(lái)。Skill 就是解決這件事的把一次跑通的任務(wù)經(jīng)驗(yàn)沉淀成智能體可以直接復(fù)用的“任務(wù)經(jīng)驗(yàn)包”。它包含流程層做什么、按什么順序、異常怎么回退和動(dòng)作層調(diào)哪些工具、讀哪些文件、寫回什么結(jié)果。在 OpenClaw 場(chǎng)景下skill-creator 就是幫你把這兩層從對(duì)話里抽出來(lái)、生成結(jié)構(gòu)化 Skill 定義的工具。這篇內(nèi)容適合正在用 OpenClaw 做自動(dòng)化、但被“同題不同解”困擾的開發(fā)者也適合想把團(tuán)隊(duì)排查經(jīng)驗(yàn)沉淀成可復(fù)用資產(chǎn)的工程同學(xué)。下面我會(huì)用一個(gè)日志異常定位的真實(shí)案例從零走一遍 skill-creator 的配置、驗(yàn)證和排障。2. TaoToken 前置準(zhǔn)備給 skill-creator 一個(gè)穩(wěn)定的模型入口skill-creator 本身是一個(gè)生成 Skill 定義的工具它需要調(diào)用大模型來(lái)理解你的結(jié)構(gòu)化需求并產(chǎn)出初稿。在 OpenClaw 里模型入口的配置直接決定了 skill-creator 能不能穩(wěn)定工作。如果你用的是 TaoToken 作為模型接入層需要先把 Base URL、API Key 和 Model ID 這三件套配好否則 skill-creator 會(huì)在生成階段報(bào)連接類錯(cuò)誤。先說(shuō)清楚 TaoToken 在這里的角色它是一個(gè)模型 API 接入服務(wù)提供統(tǒng)一的 Base URL 和 Key 管理讓你在 OpenClaw、Cline、Codex 等不同客戶端里用同一套憑證調(diào)用模型。官網(wǎng)入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 注意 API 地址不帶 UTM 參數(shù)。你需要先去控制臺(tái)創(chuàng)建一個(gè) API Key控制臺(tái)地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite Key 管理頁(yè)面在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。創(chuàng)建好 Key 之后在 OpenClaw 的模型配置里填入 Base URL 和 KeyModel ID 根據(jù)你實(shí)際要用的模型填寫比如 claude 系列或 gpt 系列的具體型號(hào)。這里有個(gè)容易踩的坑很多人把 Base URL 寫成 https://taotoken.net 而不是 https://taotoken.net/api 導(dǎo)致請(qǐng)求 404。Base URL 必須帶 /api 路徑。另外如果你在 OpenClaw 里同時(shí)配了多個(gè)模型入口要確認(rèn) skill-creator 調(diào)用的是你剛配好的那個(gè)而不是默認(rèn)的本地模型或舊配置。配置完成后建議先用一次簡(jiǎn)單的模型對(duì)話驗(yàn)證連通性模型對(duì)話入口在 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 發(fā)一句“你好”看是否正常返回。這一步過(guò)了再進(jìn)入 skill-creator 的實(shí)操。如果你打算長(zhǎng)期在 OpenClaw 里跑編碼類或 Agent 類任務(wù)可以考慮 Coding Plan入口是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 它更適合高頻調(diào)用場(chǎng)景。但就本篇的 skill-creator 演示而言普通 API Key 就夠了。接入文檔在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有各客戶端的配置示例遇到不確定的字段可以對(duì)照查。3. 可復(fù)制配置用 skill-creator 生成 log-incident-analyzer現(xiàn)在進(jìn)入核心操作。我們要?jiǎng)?chuàng)建的 Skill 叫 log-incident-analyzer目標(biāo)是輸入一份日志檢索歷史錯(cuò)誤經(jīng)驗(yàn)知識(shí)庫(kù)輸出異常摘要、歷史命中依據(jù)、根因候選、建議動(dòng)作和風(fēng)險(xiǎn)提示。在 OpenClaw 里Skill 的配置通常以 JSON 或 TOML 形式存放具體路徑取決于你的 OpenClaw 版本和安裝方式。下面給出一份可直接復(fù)制的 JSON 配置片段你可以根據(jù)實(shí)際環(huán)境調(diào)整路徑。{ skill_name: log-incident-analyzer, version: 1.0.0, description: 對(duì)日志進(jìn)行異常定位優(yōu)先復(fù)用歷史錯(cuò)誤經(jīng)驗(yàn)知識(shí)庫(kù)中的已驗(yàn)證方案輸出結(jié)構(gòu)化排查報(bào)告, inputs: { log_path: { type: string, required: true, description: 日志文件路徑 }, error_keyword: { type: string, required: false, description: 指定檢索關(guān)鍵詞 }, time_range: { type: string, required: false, description: 時(shí)間范圍如最近30分鐘 }, history_kb: { type: string, required: true, default: ./knowledge/error_history.jsonl, description: 歷史錯(cuò)誤經(jīng)驗(yàn)知識(shí)庫(kù)路徑 } }, output_format: markdown, output_sections: [ 異常摘要, 歷史案例命中情況, 根因候選, 建議動(dòng)作, 風(fēng)險(xiǎn)提示 ], execution_flow: [ 校驗(yàn)輸入?yún)?shù)合法性, 讀取日志并檢查是否可訪問(wèn), 提取異常模式與關(guān)鍵日志片段, 使用異常特征檢索 history_kb, 若命中高相似案例優(yōu)先輸出歷史已驗(yàn)證方案并給出差異說(shuō)明, 若未命中執(zhí)行常規(guī)根因分析流程, 形成根因候選并逐條附證據(jù), 輸出建議動(dòng)作并標(biāo)記優(yōu)先級(jí), 本次結(jié)論穩(wěn)定后新增或更新一條歷史經(jīng)驗(yàn)到 history_kb ], constraints: [ 不得編造日志內(nèi)容, 所有結(jié)論必須引用證據(jù), 命中歷史案例時(shí)必須明確命中依據(jù), 嚴(yán)禁在證據(jù)不足時(shí)硬套歷史方案, 輸出語(yǔ)言必須為中文 ], fallback: { file_not_found: 返回輸入文件不可訪問(wèn)并提示檢查路徑, no_anomaly: 返回未檢測(cè)到明確異常模式并給出下一步采樣建議, kb_unavailable: 明確標(biāo)注本次未能檢索歷史經(jīng)驗(yàn)庫(kù)并降級(jí)走常規(guī)分析, tool_failure: 返回失敗原因、已完成步驟、建議重試方式 } }這份配置可以直接作為 skill-creator 的輸入。在 OpenClaw 里調(diào)用 skill-creator 時(shí)把上面的 JSON 作為結(jié)構(gòu)化需求傳進(jìn)去或者用自然語(yǔ)言描述同樣的內(nèi)容。skill-creator 會(huì)生成一個(gè)初稿但初稿通常只保證“能跑”不保證“穩(wěn)”。你需要重點(diǎn)補(bǔ)三塊邊界定義輸入為空、文件不存在、日志格式異常怎么處理、異?；赝斯ぞ哒{(diào)用失敗返回什么、是否允許降級(jí)輸出、輸出一致性每次按固定章節(jié)輸出、證據(jù)引用格式統(tǒng)一。這三塊補(bǔ)完Skill 才算可維護(hù)。如果你用的是 TOML 格式的配置環(huán)境可以把上面的 JSON 轉(zhuǎn)成對(duì)應(yīng)的 TOML 結(jié)構(gòu)字段名保持一致。關(guān)鍵是 Base URL、Key、Model ID 三件套要在 OpenClaw 的模型配置里寫全否則 skill-creator 生成階段就會(huì)失敗。Model ID 建議填你實(shí)際驗(yàn)證過(guò)能用的型號(hào)不要留空。4. 驗(yàn)證請(qǐng)求同一任務(wù)二次調(diào)用輸出是否穩(wěn)定配置寫完之后必須做驗(yàn)證。驗(yàn)證的核心不是“能不能跑”而是“二次調(diào)用是否穩(wěn)定、可回歸”。我建議分三輪測(cè)試每輪記錄結(jié)果。第一輪是命中測(cè)試。用幾種真實(shí)說(shuō)法觸發(fā) Skill看是否命中正確的 Skill而不是誤觸發(fā)別的。比如# 測(cè)試觸發(fā)語(yǔ)1 幫我看下這份日志為什么報(bào)錯(cuò) # 測(cè)試觸發(fā)語(yǔ)2 這個(gè)異常是哪里來(lái)的 # 測(cè)試觸發(fā)語(yǔ)3 定位一下線上報(bào)錯(cuò)原因在 OpenClaw 里依次輸入這三句話觀察它是否都調(diào)用了 log-incident-analyzer而不是走通用對(duì)話。如果某一句沒(méi)觸發(fā)說(shuō)明觸發(fā)語(yǔ)覆蓋不夠需要在 Skill 描述里補(bǔ)充同義表達(dá)。第二輪是流程測(cè)試。給一個(gè)真實(shí)日志文件看它是否嚴(yán)格按執(zhí)行順序走先校驗(yàn)輸入再讀取日志再檢索 history_kb再輸出證據(jù)鏈。你可以用下面這個(gè)命令生成一個(gè)測(cè)試日志cat /tmp/test_error.log EOF 2024-01-15 10:23:45 ERROR [order-service] Failed to connect to database: connection timeout after 3000ms 2024-01-15 10:23:46 WARN [order-service] Retry attempt 1/3 2024-01-15 10:23:49 ERROR [order-service] Retry failed: connection refused 2024-01-15 10:23:50 INFO [order-service] Circuit breaker opened EOF然后把 /tmp/test_error.log 作為 log_path 傳給 Skill觀察輸出。合格的輸出應(yīng)該包含異常摘要數(shù)據(jù)庫(kù)連接超時(shí)重試失敗熔斷、歷史命中情況如果 history_kb 里有類似記錄、根因候選至少2條每條附證據(jù)片段、建議動(dòng)作立即動(dòng)作和后續(xù)動(dòng)作、風(fēng)險(xiǎn)提示證據(jù)不足項(xiàng)明確標(biāo)注。第三輪是結(jié)果測(cè)試。檢查輸出質(zhì)量根因候選是否至少2條、每條是否有證據(jù)片段、建議是否可執(zhí)行、不確定項(xiàng)是否標(biāo)“證據(jù)不足”。如果輸出只是“看起來(lái)像報(bào)告”但沒(méi)有證據(jù)引用說(shuō)明約束規(guī)則沒(méi)生效需要回到配置里加強(qiáng) constraints 部分。二次調(diào)用的穩(wěn)定性驗(yàn)證方法是用同一個(gè)日志文件、同一組輸入?yún)?shù)連續(xù)調(diào)用兩次對(duì)比兩次輸出的章節(jié)結(jié)構(gòu)、證據(jù)引用格式、根因排序是否一致。如果第二次輸出跳過(guò)了歷史檢索步驟或者根因排序完全變了說(shuō)明 Skill 的流程約束還不夠強(qiáng)需要在 execution_flow 里把順序?qū)懙酶啦⒃?constraints 里加一條“必須按固定章節(jié)輸出”。5. 本篇常見錯(cuò)排查401、local proxy failed、reading choices、OAuth配置和驗(yàn)證過(guò)程中最容易遇到幾類報(bào)錯(cuò)。下面逐個(gè)對(duì)照排查。401 Unauthorized這是 API Key 沒(méi)配好或配錯(cuò)了。檢查 OpenClaw 模型配置里的 Key 是否和 TaoToken 控制臺(tái)創(chuàng)建的一致注意不要有多余空格。如果 Key 剛創(chuàng)建確認(rèn)沒(méi)有復(fù)制錯(cuò)行。另外檢查 Base URL 是否寫成了 https://taotoken.net/api 少了 /api 會(huì)走到錯(cuò)誤的路由也可能返回 401 或 404。local proxy failed這個(gè)報(bào)錯(cuò)通常出現(xiàn)在 OpenClaw 嘗試通過(guò)本地代理轉(zhuǎn)發(fā)請(qǐng)求時(shí)。檢查你的環(huán)境變量里有沒(méi)有殘留的 HTTP_PROXY 或 HTTPS_PROXY 設(shè)置如果有先清掉再試。另外確認(rèn) OpenClaw 的模型配置里沒(méi)有開啟不必要的本地代理模式。如果你在 Cline 或 Claude Code 里也遇到類似報(bào)錯(cuò)檢查對(duì)應(yīng)的 settings.json 或 auth.json 里的 Base URL 是否指向了正確的 API 地址。reading choices 報(bào)錯(cuò)這個(gè)通常發(fā)生在模型返回結(jié)構(gòu)不符合預(yù)期時(shí)。skill-creator 期望模型返回結(jié)構(gòu)化的 Skill 定義但模型可能返回了純文本或格式錯(cuò)亂的內(nèi)容。排查方法是先用模型對(duì)話入口單獨(dú)發(fā)一次請(qǐng)求看模型是否正常返回。如果模型對(duì)話正常但 skill-creator 報(bào) reading choices說(shuō)明 skill-creator 的解析邏輯對(duì)返回格式有要求你需要在輸入里更明確地要求“輸出 JSON 格式”。另外檢查 Model ID 是否填對(duì)有些模型不支持結(jié)構(gòu)化輸出。OAuth 相關(guān)報(bào)錯(cuò)如果你在 OpenClaw 里用的是 OAuth 方式接入而不是 API Key可能會(huì)遇到 token 過(guò)期或 scope 不足的問(wèn)題。建議在 skill-creator 場(chǎng)景下直接用 API Key 方式避免 OAuth 的額外復(fù)雜度。如果你同時(shí)在用 Claude Code 或 Codex注意它們的 auth.json 和 OpenClaw 的配置是分開的不要混用。CC Switch 這類工具切換配置時(shí)確認(rèn) Base URL、Key、Model ID 三件套都切換到位不要只切了 Key 忘了 Base URL。還有一個(gè)隱蔽的坑history_kb 路徑寫的是相對(duì)路徑 ./knowledge/error_history.jsonl但 OpenClaw 的工作目錄可能不是你以為的那個(gè)。建議先用絕對(duì)路徑測(cè)試確認(rèn)能讀到文件后再改相對(duì)路徑。如果 history_kb 不可用Skill 應(yīng)該走降級(jí)邏輯明確標(biāo)注“本次未能檢索歷史經(jīng)驗(yàn)庫(kù)”而不是直接報(bào)錯(cuò)退出。6. 把 Skill 用起來(lái)從偶然成功到穩(wěn)定復(fù)用的最后一步Skill 創(chuàng)建好、驗(yàn)證通過(guò)之后真正的價(jià)值在于持續(xù)使用和迭代。上線后不要頻繁大改而是只沉淀兩類東西新知識(shí)新增錯(cuò)誤模式、典型故障鏈路和新路徑哪一步容易失敗就補(bǔ)規(guī)則或補(bǔ)工具。每次迭代都要保留至少3組固定回歸樣例正常可定位樣例、證據(jù)不足樣例、輸入異常樣例。每次改動(dòng)都跑這3組避免“修了A壞了B”?？刂茝?fù)雜度也很重要。別把一個(gè) Skill 寫成萬(wàn)能總控遇到場(chǎng)景分叉明顯時(shí)拆成兩個(gè) Skill 更穩(wěn)。比如日志分析可以拆成“日志異常定位”和“歷史經(jīng)驗(yàn)回寫”兩個(gè) Skill前者負(fù)責(zé)分析后者負(fù)責(zé)沉淀職責(zé)清晰維護(hù)成本低。如果你在 OpenClaw 里跑的是長(zhǎng)期編碼或 Agent 任務(wù)可以結(jié)合 Coding Plan 來(lái)管理調(diào)用頻率和成本入口是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。需要查具體配置字段時(shí)接入文檔在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。API Key 管理和創(chuàng)建在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。模型對(duì)話驗(yàn)證在 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 。最后說(shuō)一個(gè)實(shí)際經(jīng)驗(yàn)Skill 的觸發(fā)語(yǔ)要寫得足夠“像人話”不要只寫技術(shù)術(shù)語(yǔ)。用戶說(shuō)“看下這個(gè)報(bào)錯(cuò)”和“幫我分析日志”都應(yīng)該能命中而不是必須說(shuō)“執(zhí)行 log-incident-analyzer”。觸發(fā)語(yǔ)覆蓋越自然Skill 的復(fù)用率越高。把邊界、流程、證據(jù)這三件事做扎實(shí)Skill 就能從“演示可用”變成“生產(chǎn)可用”你節(jié)省的不只是 token而是團(tuán)隊(duì)協(xié)作里的時(shí)間和返工成本。 Skill 科普指南：用 skill-creator 把“偶然成功”變成“穩(wěn)定復(fù)用”
1. 為什么你的 OpenClaw 智能體總是“這次行下次不行”如果你用過(guò) OpenClaw 這類智能體框架跑稍微復(fù)雜一點(diǎn)的任務(wù)大概率遇到過(guò)這種場(chǎng)景第一次對(duì)話你反復(fù)調(diào)整措辭、補(bǔ)充上下文終于讓它按你想要的路徑跑通了第二天你信心滿滿地復(fù)述同樣的需求它卻換了一條完全不同的路線輸出格式變了中間步驟跳了甚至工具都沒(méi)調(diào)對(duì)。這不是模型“變笨”了而是采樣機(jī)制決定的——大模型每次生成都帶有隨機(jī)性長(zhǎng)會(huì)話里歷史信息越堆越多上下文污染和 token 消耗同步上升執(zhí)行路徑自然就不穩(wěn)定。我試過(guò)最典型的例子是日志排查。同一個(gè)報(bào)錯(cuò)第一次我引導(dǎo)它先讀日志、再檢索歷史經(jīng)驗(yàn)、最后按置信度給根因輸出很漂亮第二次我只說(shuō)“看下這個(gè)報(bào)錯(cuò)”它直接憑常識(shí)猜了一個(gè)原因連日志文件都沒(méi)打開。問(wèn)題不在于模型能力而在于“偶然成功”沒(méi)有被固化下來(lái)。Skill 就是解決這件事的把一次跑通的任務(wù)經(jīng)驗(yàn)沉淀成智能體可以直接復(fù)用的“任務(wù)經(jīng)驗(yàn)包”。它包含流程層做什么、按什么順序、異常怎么回退和動(dòng)作層調(diào)哪些工具、讀哪些文件、寫回什么結(jié)果。在 OpenClaw 場(chǎng)景下skill-creator 就是幫你把這兩層從對(duì)話里抽出來(lái)、生成結(jié)構(gòu)化 Skill 定義的工具。這篇內(nèi)容適合正在用 OpenClaw 做自動(dòng)化、但被“同題不同解”困擾的開發(fā)者也適合想把團(tuán)隊(duì)排查經(jīng)驗(yàn)沉淀成可復(fù)用資產(chǎn)的工程同學(xué)。下面我會(huì)用一個(gè)日志異常定位的真實(shí)案例從零走一遍 skill-creator 的配置、驗(yàn)證和排障。2. TaoToken 前置準(zhǔn)備給 skill-creator 一個(gè)穩(wěn)定的模型入口skill-creator 本身是一個(gè)生成 Skill 定義的工具它需要調(diào)用大模型來(lái)理解你的結(jié)構(gòu)化需求并產(chǎn)出初稿。在 OpenClaw 里模型入口的配置直接決定了 skill-creator 能不能穩(wěn)定工作。如果你用的是 TaoToken 作為模型接入層需要先把 Base URL、API Key 和 Model ID 這三件套配好否則 skill-creator 會(huì)在生成階段報(bào)連接類錯(cuò)誤。先說(shuō)清楚 TaoToken 在這里的角色它是一個(gè)模型 API 接入服務(wù)提供統(tǒng)一的 Base URL 和 Key 管理讓你在 OpenClaw、Cline、Codex 等不同客戶端里用同一套憑證調(diào)用模型。官網(wǎng)入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 注意 API 地址不帶 UTM 參數(shù)。你需要先去控制臺(tái)創(chuàng)建一個(gè) API Key控制臺(tái)地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite Key 管理頁(yè)面在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。創(chuàng)建好 Key 之后在 OpenClaw 的模型配置里填入 Base URL 和 KeyModel ID 根據(jù)你實(shí)際要用的模型填寫比如 claude 系列或 gpt 系列的具體型號(hào)。這里有個(gè)容易踩的坑很多人把 Base URL 寫成 https://taotoken.net 而不是 https://taotoken.net/api 導(dǎo)致請(qǐng)求 404。Base URL 必須帶 /api 路徑。另外如果你在 OpenClaw 里同時(shí)配了多個(gè)模型入口要確認(rèn) skill-creator 調(diào)用的是你剛配好的那個(gè)而不是默認(rèn)的本地模型或舊配置。配置完成后建議先用一次簡(jiǎn)單的模型對(duì)話驗(yàn)證連通性模型對(duì)話入口在 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 發(fā)一句“你好”看是否正常返回。這一步過(guò)了再進(jìn)入 skill-creator 的實(shí)操。如果你打算長(zhǎng)期在 OpenClaw 里跑編碼類或 Agent 類任務(wù)可以考慮 Coding Plan入口是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 它更適合高頻調(diào)用場(chǎng)景。但就本篇的 skill-creator 演示而言普通 API Key 就夠了。接入文檔在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有各客戶端的配置示例遇到不確定的字段可以對(duì)照查。3. 可復(fù)制配置用 skill-creator 生成 log-incident-analyzer現(xiàn)在進(jìn)入核心操作。我們要?jiǎng)?chuàng)建的 Skill 叫 log-incident-analyzer目標(biāo)是輸入一份日志檢索歷史錯(cuò)誤經(jīng)驗(yàn)知識(shí)庫(kù)輸出異常摘要、歷史命中依據(jù)、根因候選、建議動(dòng)作和風(fēng)險(xiǎn)提示。在 OpenClaw 里Skill 的配置通常以 JSON 或 TOML 形式存放具體路徑取決于你的 OpenClaw 版本和安裝方式。下面給出一份可直接復(fù)制的 JSON 配置片段你可以根據(jù)實(shí)際環(huán)境調(diào)整路徑。{ skill_name: log-incident-analyzer, version: 1.0.0, description: 對(duì)日志進(jìn)行異常定位優(yōu)先復(fù)用歷史錯(cuò)誤經(jīng)驗(yàn)知識(shí)庫(kù)中的已驗(yàn)證方案輸出結(jié)構(gòu)化排查報(bào)告, inputs: { log_path: { type: string, required: true, description: 日志文件路徑 }, error_keyword: { type: string, required: false, description: 指定檢索關(guān)鍵詞 }, time_range: { type: string, required: false, description: 時(shí)間范圍如最近30分鐘 }, history_kb: { type: string, required: true, default: ./knowledge/error_history.jsonl, description: 歷史錯(cuò)誤經(jīng)驗(yàn)知識(shí)庫(kù)路徑 } }, output_format: markdown, output_sections: [ 異常摘要, 歷史案例命中情況, 根因候選, 建議動(dòng)作, 風(fēng)險(xiǎn)提示 ], execution_flow: [ 校驗(yàn)輸入?yún)?shù)合法性, 讀取日志并檢查是否可訪問(wèn), 提取異常模式與關(guān)鍵日志片段, 使用異常特征檢索 history_kb, 若命中高相似案例優(yōu)先輸出歷史已驗(yàn)證方案并給出差異說(shuō)明, 若未命中執(zhí)行常規(guī)根因分析流程, 形成根因候選并逐條附證據(jù), 輸出建議動(dòng)作并標(biāo)記優(yōu)先級(jí), 本次結(jié)論穩(wěn)定后新增或更新一條歷史經(jīng)驗(yàn)到 history_kb ], constraints: [ 不得編造日志內(nèi)容, 所有結(jié)論必須引用證據(jù), 命中歷史案例時(shí)必須明確命中依據(jù), 嚴(yán)禁在證據(jù)不足時(shí)硬套歷史方案, 輸出語(yǔ)言必須為中文 ], fallback: { file_not_found: 返回輸入文件不可訪問(wèn)并提示檢查路徑, no_anomaly: 返回未檢測(cè)到明確異常模式并給出下一步采樣建議, kb_unavailable: 明確標(biāo)注本次未能檢索歷史經(jīng)驗(yàn)庫(kù)并降級(jí)走常規(guī)分析, tool_failure: 返回失敗原因、已完成步驟、建議重試方式 } }這份配置可以直接作為 skill-creator 的輸入。在 OpenClaw 里調(diào)用 skill-creator 時(shí)把上面的 JSON 作為結(jié)構(gòu)化需求傳進(jìn)去或者用自然語(yǔ)言描述同樣的內(nèi)容。skill-creator 會(huì)生成一個(gè)初稿但初稿通常只保證“能跑”不保證“穩(wěn)”。你需要重點(diǎn)補(bǔ)三塊邊界定義輸入為空、文件不存在、日志格式異常怎么處理、異?；赝斯ぞ哒{(diào)用失敗返回什么、是否允許降級(jí)輸出、輸出一致性每次按固定章節(jié)輸出、證據(jù)引用格式統(tǒng)一。這三塊補(bǔ)完Skill 才算可維護(hù)。如果你用的是 TOML 格式的配置環(huán)境可以把上面的 JSON 轉(zhuǎn)成對(duì)應(yīng)的 TOML 結(jié)構(gòu)字段名保持一致。關(guān)鍵是 Base URL、Key、Model ID 三件套要在 OpenClaw 的模型配置里寫全否則 skill-creator 生成階段就會(huì)失敗。Model ID 建議填你實(shí)際驗(yàn)證過(guò)能用的型號(hào)不要留空。4. 驗(yàn)證請(qǐng)求同一任務(wù)二次調(diào)用輸出是否穩(wěn)定配置寫完之后必須做驗(yàn)證。驗(yàn)證的核心不是“能不能跑”而是“二次調(diào)用是否穩(wěn)定、可回歸”。我建議分三輪測(cè)試每輪記錄結(jié)果。第一輪是命中測(cè)試。用幾種真實(shí)說(shuō)法觸發(fā) Skill看是否命中正確的 Skill而不是誤觸發(fā)別的。比如# 測(cè)試觸發(fā)語(yǔ)1 幫我看下這份日志為什么報(bào)錯(cuò) # 測(cè)試觸發(fā)語(yǔ)2 這個(gè)異常是哪里來(lái)的 # 測(cè)試觸發(fā)語(yǔ)3 定位一下線上報(bào)錯(cuò)原因在 OpenClaw 里依次輸入這三句話觀察它是否都調(diào)用了 log-incident-analyzer而不是走通用對(duì)話。如果某一句沒(méi)觸發(fā)說(shuō)明觸發(fā)語(yǔ)覆蓋不夠需要在 Skill 描述里補(bǔ)充同義表達(dá)。第二輪是流程測(cè)試。給一個(gè)真實(shí)日志文件看它是否嚴(yán)格按執(zhí)行順序走先校驗(yàn)輸入再讀取日志再檢索 history_kb再輸出證據(jù)鏈。你可以用下面這個(gè)命令生成一個(gè)測(cè)試日志cat /tmp/test_error.log EOF 2024-01-15 10:23:45 ERROR [order-service] Failed to connect to database: connection timeout after 3000ms 2024-01-15 10:23:46 WARN [order-service] Retry attempt 1/3 2024-01-15 10:23:49 ERROR [order-service] Retry failed: connection refused 2024-01-15 10:23:50 INFO [order-service] Circuit breaker opened EOF然后把 /tmp/test_error.log 作為 log_path 傳給 Skill觀察輸出。合格的輸出應(yīng)該包含異常摘要數(shù)據(jù)庫(kù)連接超時(shí)重試失敗熔斷、歷史命中情況如果 history_kb 里有類似記錄、根因候選至少2條每條附證據(jù)片段、建議動(dòng)作立即動(dòng)作和后續(xù)動(dòng)作、風(fēng)險(xiǎn)提示證據(jù)不足項(xiàng)明確標(biāo)注。第三輪是結(jié)果測(cè)試。檢查輸出質(zhì)量根因候選是否至少2條、每條是否有證據(jù)片段、建議是否可執(zhí)行、不確定項(xiàng)是否標(biāo)“證據(jù)不足”。如果輸出只是“看起來(lái)像報(bào)告”但沒(méi)有證據(jù)引用說(shuō)明約束規(guī)則沒(méi)生效需要回到配置里加強(qiáng) constraints 部分。二次調(diào)用的穩(wěn)定性驗(yàn)證方法是用同一個(gè)日志文件、同一組輸入?yún)?shù)連續(xù)調(diào)用兩次對(duì)比兩次輸出的章節(jié)結(jié)構(gòu)、證據(jù)引用格式、根因排序是否一致。如果第二次輸出跳過(guò)了歷史檢索步驟或者根因排序完全變了說(shuō)明 Skill 的流程約束還不夠強(qiáng)需要在 execution_flow 里把順序?qū)懙酶啦⒃?constraints 里加一條“必須按固定章節(jié)輸出”。5. 本篇常見錯(cuò)排查401、local proxy failed、reading choices、OAuth配置和驗(yàn)證過(guò)程中最容易遇到幾類報(bào)錯(cuò)。下面逐個(gè)對(duì)照排查。401 Unauthorized這是 API Key 沒(méi)配好或配錯(cuò)了。檢查 OpenClaw 模型配置里的 Key 是否和 TaoToken 控制臺(tái)創(chuàng)建的一致注意不要有多余空格。如果 Key 剛創(chuàng)建確認(rèn)沒(méi)有復(fù)制錯(cuò)行。另外檢查 Base URL 是否寫成了 https://taotoken.net/api 少了 /api 會(huì)走到錯(cuò)誤的路由也可能返回 401 或 404。local proxy failed這個(gè)報(bào)錯(cuò)通常出現(xiàn)在 OpenClaw 嘗試通過(guò)本地代理轉(zhuǎn)發(fā)請(qǐng)求時(shí)。檢查你的環(huán)境變量里有沒(méi)有殘留的 HTTP_PROXY 或 HTTPS_PROXY 設(shè)置如果有先清掉再試。另外確認(rèn) OpenClaw 的模型配置里沒(méi)有開啟不必要的本地代理模式。如果你在 Cline 或 Claude Code 里也遇到類似報(bào)錯(cuò)檢查對(duì)應(yīng)的 settings.json 或 auth.json 里的 Base URL 是否指向了正確的 API 地址。reading choices 報(bào)錯(cuò)這個(gè)通常發(fā)生在模型返回結(jié)構(gòu)不符合預(yù)期時(shí)。skill-creator 期望模型返回結(jié)構(gòu)化的 Skill 定義但模型可能返回了純文本或格式錯(cuò)亂的內(nèi)容。排查方法是先用模型對(duì)話入口單獨(dú)發(fā)一次請(qǐng)求看模型是否正常返回。如果模型對(duì)話正常但 skill-creator 報(bào) reading choices說(shuō)明 skill-creator 的解析邏輯對(duì)返回格式有要求你需要在輸入里更明確地要求“輸出 JSON 格式”。另外檢查 Model ID 是否填對(duì)有些模型不支持結(jié)構(gòu)化輸出。OAuth 相關(guān)報(bào)錯(cuò)如果你在 OpenClaw 里用的是 OAuth 方式接入而不是 API Key可能會(huì)遇到 token 過(guò)期或 scope 不足的問(wèn)題。建議在 skill-creator 場(chǎng)景下直接用 API Key 方式避免 OAuth 的額外復(fù)雜度。如果你同時(shí)在用 Claude Code 或 Codex注意它們的 auth.json 和 OpenClaw 的配置是分開的不要混用。CC Switch 這類工具切換配置時(shí)確認(rèn) Base URL、Key、Model ID 三件套都切換到位不要只切了 Key 忘了 Base URL。還有一個(gè)隱蔽的坑history_kb 路徑寫的是相對(duì)路徑 ./knowledge/error_history.jsonl但 OpenClaw 的工作目錄可能不是你以為的那個(gè)。建議先用絕對(duì)路徑測(cè)試確認(rèn)能讀到文件后再改相對(duì)路徑。如果 history_kb 不可用Skill 應(yīng)該走降級(jí)邏輯明確標(biāo)注“本次未能檢索歷史經(jīng)驗(yàn)庫(kù)”而不是直接報(bào)錯(cuò)退出。6. 把 Skill 用起來(lái)從偶然成功到穩(wěn)定復(fù)用的最后一步Skill 創(chuàng)建好、驗(yàn)證通過(guò)之后真正的價(jià)值在于持續(xù)使用和迭代。上線后不要頻繁大改而是只沉淀兩類東西新知識(shí)新增錯(cuò)誤模式、典型故障鏈路和新路徑哪一步容易失敗就補(bǔ)規(guī)則或補(bǔ)工具。每次迭代都要保留至少3組固定回歸樣例正常可定位樣例、證據(jù)不足樣例、輸入異常樣例。每次改動(dòng)都跑這3組避免“修了A壞了B”?？刂茝?fù)雜度也很重要。別把一個(gè) Skill 寫成萬(wàn)能總控遇到場(chǎng)景分叉明顯時(shí)拆成兩個(gè) Skill 更穩(wěn)。比如日志分析可以拆成“日志異常定位”和“歷史經(jīng)驗(yàn)回寫”兩個(gè) Skill前者負(fù)責(zé)分析后者負(fù)責(zé)沉淀職責(zé)清晰維護(hù)成本低。如果你在 OpenClaw 里跑的是長(zhǎng)期編碼或 Agent 任務(wù)可以結(jié)合 Coding Plan 來(lái)管理調(diào)用頻率和成本入口是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。需要查具體配置字段時(shí)接入文檔在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。API Key 管理和創(chuàng)建在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。模型對(duì)話驗(yàn)證在 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 。最后說(shuō)一個(gè)實(shí)際經(jīng)驗(yàn)Skill 的觸發(fā)語(yǔ)要寫得足夠“像人話”不要只寫技術(shù)術(shù)語(yǔ)。用戶說(shuō)“看下這個(gè)報(bào)錯(cuò)”和“幫我分析日志”都應(yīng)該能命中而不是必須說(shuō)“執(zhí)行 log-incident-analyzer”。觸發(fā)語(yǔ)覆蓋越自然Skill 的復(fù)用率越高。把邊界、流程、證據(jù)這三件事做扎實(shí)Skill 就能從“演示可用”變成“生產(chǎn)可用”你節(jié)省的不只是 token而是團(tuán)隊(duì)協(xié)作里的時(shí)間和返工成本。