「自動化」這個詞容易讓人想到複雜的程序和技術門檻。但實際上，QClaw 的任務自動化大多數時候就是：把你平時需要坐在電腦前手動做的操作，換成一條微信指令讓它替你做。
這篇指南從基礎用法開始，逐步深入，覆蓋從簡單文件操作到和腳本配合的進階用法。
理解 QClaw 自動化的本質
在說「怎麼做」之前，先說清楚「是什麼」。
QClaw 的自動化不是設置一個規則讓任務定時自動運行（那是 cron job 的邏輯）。它的自動化模式是：你發出指令 → AI 解析意圖 → 桌面端執行。
這個模式有幾個特點：
- 人工觸發：每次執行需要你發一條指令，不是無人值守自動運行
- 意圖理解：你不需要寫精確的命令行，用自然語言描述就行
- 本地執行：操作在你的電腦上執行，結果在你的本地文件系統
- 異步反饋：執行結果通過微信發回來，你不需要盯著電腦屏幕
理解這個模式，你就知道 QClaw 自動化適合什麼：適合那些「你知道要做什麼，但需要手動一步步操作，而且你不想花時間坐在電腦前做」的任務。
基礎篇：寫出有效的指令
指令結構的四個要素
有效的 QClaw 指令通常包含四個要素：操作對象、操作動作、操作條件、期望結果。
不好的指令：「整理文件」 好的指令：「把 ~/Desktop 上的所有 .pdf 文件（操作對象），移動（操作動作）到 ~/Documents/pdf-archive/（期望結果），如果有同名文件，加上日期後綴（操作條件）」
不是每條指令都需要四個要素都寫全，但越完整，執行越符合預期。
常用操作動詞
不同的動作，QClaw 的識別和執行效果不同：
文件操作類：
- 「移動」/ 「move」：把文件從一個位置移到另一個位置
- 「複製」/ 「copy」：複製文件到指定位置，保留原文件
- 「重命名」/ 「rename」：按規則改文件名
- 「刪除」/ 「delete」（高風險，謹慎使用）：刪除文件
- 「壓縮」/ 「zip」：打包成壓縮文件
- 「解壓」/ 「unzip」：解壓縮文件
查詢類：
- 「列出」/ 「list」：列出目錄下的文件或符合條件的文件
- 「搜索」/ 「search」/ 「找」：按關鍵詞或條件查找文件
- 「統計」：統計文件數量、大小等
生成類：
- 「生成」/ 「寫」/ 「創建」：生成文本內容、文檔草稿
- 「整理成」：把輸入整理成特定格式
執行類：
- 「運行」/ 「執行」：觸發腳本或程序
範圍限定的重要性
「整理文件夾」和「整理 ~/Documents/projects/ 文件夾」的差別非常大。沒有範圍限定的指令，QClaw 可能：
- 搜索範圍太廣，返回結果太多
- 在你不預期的位置執行操作
- 因為路徑不明確而報錯
建議的做法：
- 用絕對路徑（
~/Desktop、/Users/你的用戶名/Documents）而不是相對描述（「我的文件夾」） - 不確定路徑時，先讓 QClaw 列出當前目錄，確認後再操作
- 對不熟悉的目錄，先用「只列出，不操作」確認內容
基礎篇：常用自動化場景
場景一：日常文件清理
很多人桌面上堆滿文件，找東西靠搜索。一條指令可以開始解決這個問題：
把 ~/Desktop 上所有超過 7 天未修改的文件，按文件類型分類移動到 ~/archive/by-type/，
PDF 放 pdf/，Word 文檔放 docs/，圖片放 images/，其他放 others/這個清理操作，手動做需要 20-30 分鐘，用 QClaw 一條指令，幾分鐘完成。
場景二：項目文件打包
每週或每月需要把項目文件打包歸檔：
把 ~/Projects/ClientA/ 下所有文件打包成
ClientA-archive-2026-05.zip，放到 ~/archive/monthly/或者在外出前準備好文件：
把 ~/Projects/meeting-prep/ 下的文件打包成
meeting-materials-0521.zip，放到桌面場景三：批量重命名
收到一批圖片或文件，命名規則混亂：
把 ~/Downloads/photos/ 下所有 jpg 文件，按「客戶名_日期_序號.jpg」格式重命名，
客戶名用 WangXiao，日期用今天，序號從 001 開始或者統一加前綴後綴：
把 ~/Documents/drafts/ 下所有 docx 文件，文件名前面加「DRAFT-」前綴場景四：搜索整合
需要找散落在多個地方的相關文件：
在 ~/Documents/ 和 ~/Desktop/ 下，搜索文件名包含「報告」或「report」的文件，
列出文件名、位置和修改日期，按修改日期倒序排列場景五：文案和草稿生成
遠程時突然需要寫東西：
幫我寫一封道歉郵件草稿，對象是供應商，說因為審批延遲，合同的簽署要推遲到下週，
語氣要正式，長度不超過 200 字或者朋友圈文案：
幫我寫三個版本的朋友圈文案草稿，主題是今天去了一個品茶活動，
要有點生活感，不要廣告味，每個版本控制在 80 字以內進階篇：複雜任務的拆解方法
為什麼複雜任務容易出錯
當一個指令包含太多步驟時，任何一個環節出問題都可能導致：
- 後面的步驟沒有執行
- 某個步驟執行了但方式不對
- 出錯了但你不知道出在哪裡
解決方法是把複雜任務拆成多個單步指令，每步確認後再繼續。
拆解的原則
原則一：一條指令只做一件事 不要在一條指令裡包含多個獨立的操作。「搜索文件，整理，然後打包」應該拆成三條。
原則二：先查詢，後操作 任何涉及文件移動、刪除、修改的操作，先用列出指令確認對象，再執行。
原則三：操作有可逆性 優先選擇可逆操作：「移動到臨時文件夾」比「刪除」好；「複製到目標位置」比「移動」好（在你不確定的情況下）。
原則四：每步有回饋確認 讓每步操作都返回執行結果，確認符合預期再繼續。
複雜任務拆解示例
任務：把本月的工作文件整理歸檔
拆解為：
- 「列出 ~/Projects/ 和 ~/Desktop/ 下本月修改的所有文件，按修改日期排序」
- （確認列表後）「把列表中的項目文件（.docx、.pdf、.xlsx）複製到 ~/archive/2026-05/projects/」
- （確認複製完成後）「把列表中的圖片文件複製到 ~/archive/2026-05/images/」
- （確認所有文件都備份後）「把原始位置的臨時文件（.tmp、.bak 結尾）刪除」
這個流程比一次性指令多了幾個步驟，但每步都可以確認，出錯概率更低，出錯了也知道在哪一步。
進階篇：與腳本配合使用
QClaw 最強大的用法之一，是把它和你預先寫好的腳本結合。這樣 QClaw 負責接收你的微信指令，然後觸發腳本執行。
基本腳本觸發
假設你有一個備份腳本 ~/scripts/backup.sh，每次需要備份時你都要打開終端運行。
用 QClaw，你在微信發「運行備份腳本」，它觸發這個腳本，腳本運行完後把結果發回微信。
腳本觸發的好處：
- 不需要每次打開終端
- 不在電腦旁邊時也能遠程觸發
- 腳本可以比較複雜，QClaw 只需要觸發它
腳本設計建議
配合 QClaw 使用的腳本，有幾個建議：
1. 腳本應該有明確的輸出 腳本運行完，輸出一條簡短的結果信息（成功/失敗，處理了多少文件等），這樣 QClaw 可以把這個信息發回微信。
2. 腳本應該是單一功能 一個腳本只做一件事。「備份腳本」只做備份，「清理腳本」只做清理。不要把所有功能塞進一個大腳本，難以維護。
3. 腳本應該有錯誤處理 腳本中應該加入基本的錯誤捕獲，出錯時輸出錯誤信息，而不是靜默失敗。
4. 給腳本一個清晰的名字
讓腳本名字直接表達功能：backup-documents.sh、clean-downloads.sh、compile-project.sh。
開發者的進階用法
如果你是開發者，QClaw 可以成為一個非常順手的遠程開發助手：
遠程觸發構建： 在外面客戶那邊，需要觸發一個構建。發微信給 QClaw：「運行構建腳本，把構建結果發回來」。電腦跑完構建，把 stdout 的最後幾行發回微信。你不需要打開電腦，看看有沒有報錯。
遠程查看日誌： 發微信：「查看 ~/logs/app.log 最後 50 行，如果有 ERROR 字樣的行，把這些行發回來」。
遠程重啟服務： 如果你的電腦本地跑著一個開發服務器，可以用腳本重啟它，然後通過 QClaw 遠程觸發。
代碼片段生成： 「幫我生成一個 Python 腳本，讀取 ~/data/input.csv，把第三列的值按從大到小排序，輸出到 ~/data/sorted-output.csv」。
進階篇：建立個人自動化庫
如果你經常用 QClaw 做某些固定任務，建議建立一個「個人指令庫」：把那些有效的指令保存下來，下次直接複製用。
如何建立
最簡單的方式：在手機微信的「收藏」功能裡，建立一個「QClaw 指令」標籤，把常用指令保存進去。
用的時候打開收藏，找到指令，複製，發給 QClaw，根據當前情況修改幾個變量（日期、文件名、路徑），發出去。
建議收藏的指令類型
- 每週清理：固定的文件清理規則
- 項目打包：按月/按週打包的格式
- 文案模板：常用的文案生成提示
- 查詢指令：常用的搜索格式
版本迭代
指令庫不是一成不變的。用一段時間後，你會發現某些指令不夠精確，某些可以合併。定期回顧和優化你的指令庫。
安全邊界
做完進階用法的介紹，有必要說清楚安全邊界。
哪些操作有風險
高風險：
- 刪除操作（rm、delete）：不可逆，誤操作後數據可能找不回來
- 權限更改（chmod 等）：可能導致系統文件無法訪問
- 系統目錄操作：不要讓 QClaw 操作
/System、/Library等系統目錄
中風險：
- 大批量移動：操作幾百個文件，一個判斷錯誤影響面大
- 腳本觸發：腳本本身有 bug 或副作用，通過 QClaw 觸發可能不容易及時發現
低風險：
- 查詢類操作（list、search）：只讀，不改變文件
- 複製操作：保留原文件，可以回滾
- 生成文本：沒有文件系統副作用
建立安全習慣
- 對刪除操作額外謹慎：先移到臨時文件夾，確認不需要後再清空
- 批量操作前先小範圍測試：先在 5 個文件上測試指令效果，確認無誤後再擴大範圍
- 重要操作前備份：如果操作對象是重要文件，先手動備份一份
- 不要操作你不了解的目錄：如果你不知道某個目錄裡有什麼，先 list 不先操作
微信帳號安全邊界
除了文件操作安全，還需要注意微信帳號安全：
- 不要用 QClaw 批量發送微信消息
- 不要設置高頻自動觸發（每分鐘多次觸發）
- 不要讓陌生人觸發你的 QClaw
這些行為都可能觸發微信的異常行為檢測，輕則功能受限，重則帳號被限制。
常見問題排查
指令發出去沒有回應
可能原因：
- 電腦進入睡眠狀態
- QClaw 應用意外退出
- 網絡連接中斷
解決步驟：
- 確認電腦是否在線（如果有遠程桌面，看一眼）
- 在電腦端重啟 QClaw 應用
- 重新發送指令（不要重複發多次，先確認應用在線）
指令執行結果不符合預期
可能原因：
- 指令描述不夠精確
- 文件路徑理解偏差
- 操作條件理解偏差
解決步驟：
- 先用「列出」指令確認操作對象是否正確
- 更精確地描述路徑和條件
- 把複雜指令拆成多步，找出哪一步理解出錯
執行部分完成後停止
可能原因：
- 遇到了特殊文件（權限問題、文件鎖定）
- 路徑不存在
- 磁盤空間不足
解決步驟：
- 查看回饋信息，找出停止原因
- 處理停止原因（釋放磁盤空間、創建目標路徑）
- 重新從停止的地方繼續
結語
QClaw 的任務自動化不需要你是程序員，也不需要學特定的語法。核心能力只有一個：把你想做的事用清晰、具體的語言描述出來。
剛開始用的時候，從簡單的查詢和文件操作開始，熟悉了 QClaw 的理解方式後，再嘗試更複雜的任務。不要一開始就嘗試複雜的多步批量操作。
好的自動化工作流是慢慢積累起來的，從解決一個具體的重複任務開始，然後一步步完善。
相關閱讀：QClaw 全天工作流 · QClaw 使用技巧 · QClaw 下載