技能包

用 wecom-cli 在終端檢查企業微信授權再動手辦公

適合要在終端裡操作企業微信文件、待辦或日程的人,前提是 Node.js >= 18 和企業微信帳號,並先裝 CLI 再裝必需的 Skill。

官方來源 · wecom-cli

安裝

npx skills add WeComTeam/wecom-cli -y -g

適合誰

你要在終端裡操作企業微信,覆蓋訊息、郵件、文件、待辦、日程、會議、微盤或通訊錄,並且希望人類和 AI Agent 都能用同一套命令列時,用這份技能。它不是另一套網頁後台,而是把開放平台能力接到終端,用來提升企業辦公效率。官方倉庫是:

https://github.com/wecomteam/wecom-cli

前置條件寫得很明確:本機要有 Node.js >= 18,還要有企業微信帳號;平台限於 macOS (x64/arm64)、Linux (x64/arm64) 及 Windows (x64)。沒有帳號、版本不夠、或不在這些平台上,先不要裝。只想在瀏覽器裡點選企業微信、又不準備在本機留下全域命令的人,也不適合從這裡起步。

源文把 CLI 安裝和 CLI Skill 安裝分成兩步,並且寫明 Skill 是必需的。先有命令列,再讓 Agent 學會呼叫。不要發明未出現的安裝器,也不要補寫未點名的技能目錄。源文沒有把「人類和 AI Agent」寫成某幾個產品獨占,不要自行收窄用戶端名單。

3 分鐘完成第一次嘗試

先確認三件事:Node.js 已是 18 或更高;你有企業微信帳號;目前系統在上述平台裡。打開官方頁面核對:

https://github.com/wecomteam/wecom-cli

主路徑是先裝 CLI,再裝必需的 CLI Skill。裝包會改本機全域命令,執行前確認你要在這台機器上留下 @wecom/cli:

npm install -g @wecom/cli

確認後,再執行源文給出的 Skill 安裝(標註為必需):

npx skills add WeComTeam/wecom-cli -y -g

不要把這兩步拆成兩套並列主路徑,也不要改參數。源文沒有寫技能落盤目錄,不要自行補路徑。

第一次在 Agent 裡只做檢查,不要新建文件、發郵件或改日程。若還沒配過憑證,配置是副作用:預設掃碼,也可用 --manual 手動輸入。執行前確認這是你自己的企業微信帳號,並且你準備完成這一次互動:

wecom-cli auth init

配完後,用唯讀命令查看授權狀態:

wecom-cli auth show

成功訊號:命令正常結束,並能看到目前授權狀態。源文沒有給出 show 的欄位名稱,不要編造輸出格式。第一次不要做機器人通知、文件寫入、會議預約或微盤上傳。若 Agent 只能複述「先 init、再 show」,還沒有真正跑通 show,也不要當作已經授權成功。

使用案例

案例一:只檢查授權。已經裝好 CLI 和必需 Skill 後,在終端或能呼叫同一套命令的 Agent 裡執行 wecom-cli auth show。這是查看授權狀態,適合確認憑證是否還在。執行前確認你不會順便改配置;成功訊號是看到授權狀態。源文沒有寫未授權時的退出碼,失敗時停下,不要發明修復命令。也不要把這次檢查擴展成發送郵件或讀取通訊錄,那些動作沒有對應命令寫法。

案例二:第一次配置憑證。源文寫明配置憑證是互動式、僅需一次,預設掃碼,--manual 可手動輸入。命令是 wecom-cli auth init。執行前確認你要在本機留下企業微信憑證,並準備掃碼或手動輸入。配完後再跑 wecom-cli auth show 核對。源文沒有寫撤銷或登出命令,不要編造卸載憑證步驟。訊息、文件、待辦、日程、會議、微盤、郵件、通訊錄等業務能力只寫到功能名稱,例如新建與讀取文件、文件搜尋、新建與管理日程、預約與取得會議資訊、新建與跟進待辦、上傳與取得微盤檔、發送與取得郵件、取得通訊錄成員資訊,以及機器人主動通知;需要那些操作時先回到官方倉庫,不要自行補命令。

使用邊界

平台、執行時和帳號要求以源文為準:macOS (x64/arm64)、Linux (x64/arm64) 及 Windows (x64),Node.js >= 18,以及企業微信帳號。人類和 AI Agent 都能在終端中操作,但源文沒有點名具體 Agent 產品,不要寫成某幾個用戶端獨占。

安裝順序是 npm install -g @wecom/cli,然後必需的 npx skills add WeComTeam/wecom-cli -y -g。不要發明第二條市場或未出現的 skills add 變體。也不要把「必需 Skill」理解成可以跳過 CLI,兩步都要按源文順序做完。

憑證配置會寫到本機,預設掃碼,可用 --manual。源文沒有寫憑證檔路徑、過期策略或如何吊銷。業務功能覆蓋訊息、郵件、文件、待辦、日程、會議、微盤、通訊錄,包括機器人主動通知、文件搜尋、預約會議、上傳微盤等,但證據停在能力描述,沒有給出這些子命令的寫法;沒有寫到的參數、權限範圍和計費,不要補全。第一次只驗證授權,不要把未給出命令的辦公動作當成已經可複製的步驟。證據沒寫到的卸載或更新路徑,也不要自行補。