WordPress REST API 整合

本指南示範如何使用 OpenClaw Ultra 管理你的 WordPress 網站——發布文章、管理 WooCommerce 商品、選取分類以及填入 Hashtags——全部透過 WordPress REST API 完成。

事前準備

• 自架 WordPress 網站（使用 wordpress.org，非 wordpress.com）
• 你的 WordPress 網站已安裝 Basic Auth 外掛
• Windows 桌面已安裝 OpenClaw Ultra

步驟 1：安裝 Basic Auth 外掛

WordPress REST API 需要驗證身分。最簡單的方式是使用 Basic Auth 外掛。

1. 從此處下載外掛：https://github.com/WP-API/Basic-Auth
2. 在 WordPress 管理後台，前往 外掛 → 安裝外掛 → 上傳外掛
3. 上傳下載的 Basic-Auth-master.zip 檔案
4. 點擊 啟用

其他驗證方式

如果你的伺服器支援 OAuth 或應用程式密碼（WordPress 5.6 以上），你也可以使用那些方式。本指南為求簡潔使用 Basic Auth。

步驟 2：建立 .env 憑證檔案

在電腦的安全位置建立一個 .env 檔案，用來存放你的 WordPress 網站憑證。

建立名為 wordpress.env 的檔案，內容如下：

WP_SITE_URL=https://yoursite.com
WP_USERNAME=your-admin-username
WP_APPLICATION_PASSWORD=your-password

保護你的 .env 檔案

請勿將 .env 檔案提交到版本控制系統或公開分享。將 *.env 加入你的 .gitignore 檔案。

步驟 3：設定 OpenClaw Ultra 讀取 .env 檔案

在 OpenClaw Ultra 中，你可以使用 File 技能來讀取 .env 檔案並載入憑證。

1. 開啟 OpenClaw Ultra
2. 在聊天室中輸入：

讀取 C:\path\to\wordpress.env 檔案，並將每一行儲存為變數。

3. OpenClaw Ultra 會解析 .env 檔案，並將這些值提供給後續的請求使用。

步驟 4：透過 REST API 發布 WordPress 文章

現在你可以使用 OpenClaw Ultra 自動建立並發布 WordPress 文章。

範例提示：

使用 {WP_SITE_URL}/wp-json/wp/v2/posts 的 WordPress REST API，
建立一篇新文章：
- Title: "My First Automated Post"
- Content: "This post was created by OpenClaw Ultra via the WordPress REST API."
- Status: publish
- Categories: Technology, AI
- Hashtags: #WordPress #Automation #OpenClaw

使用 Basic Auth 進行驗證，使用者名稱 {WP_USERNAME}，密碼 {WP_APPLICATION_PASSWORD}。

OpenClaw Ultra 會發送 POST 請求到 WordPress REST API 端點，並發布你的文章。

API 端點參考

操作	Endpoint	Method
建立文章	/wp-json/wp/v2/posts	POST
更新文章	/wp-json/wp/v2/posts/{id}	PUT
取得文章	/wp-json/wp/v2/posts	GET
刪除文章	/wp-json/wp/v2/posts/{id}	DELETE

步驟 5：管理 WooCommerce 商品

如果你已安裝 WooCommerce，也可以透過 WooCommerce REST API 管理商品。

範例提示：

使用 {WP_SITE_URL}/wp-json/wc/v3/products 的 WooCommerce REST API，
建立一個新商品：
- Name: "AI Automation Course"
- Type: simple
- Regular price: 49.99
- Description: "Learn how to automate your workflows with AI."
- Categories: Courses, Digital Products
- Stock: 100

使用 Basic Auth 進行驗證，使用者名稱 {WP_USERNAME}，密碼 {WP_APPLICATION_PASSWORD}。

WooCommerce API 端點

操作	Endpoint	Method
建立商品	/wp-json/wc/v3/products	POST
取得商品	/wp-json/wc/v3/products	GET
更新商品	/wp-json/wc/v3/products/{id}	PUT
刪除商品	/wp-json/wc/v3/products/{id}	DELETE
取得訂單	/wp-json/wc/v3/orders	GET
建立分類	/wp-json/wc/v3/products/categories	POST

步驟 6：選取分類

在為文章指派分類之前，你可能需要先查詢現有的分類 ID。

查詢分類的提示：

使用 {WP_SITE_URL}/wp-json/wp/v2/categories 的 WordPress REST API，
列出網站上所有分類。

使用 Basic Auth 進行驗證，使用者名稱 {WP_USERNAME}，密碼 {WP_APPLICATION_PASSWORD}。

建立新分類：

建立一個名為「AI Tutorials」的新分類，
POST {WP_SITE_URL}/wp-json/wp/v2/categories
名稱為「AI Tutorials」，別名為「ai-tutorials」。

使用 Basic Auth 進行驗證，使用者名稱 {WP_USERNAME}，密碼 {WP_APPLICATION_PASSWORD}。

步驟 7：自動填入 Hashtags

你可以請 OpenClaw Ultra 自動產生相關的 Hashtags 並加入你的文章。

範例提示：

針對 {WP_SITE_URL} 上標題為「My First Automated Post」的文章，
根據內容產生 5 個相關的 Hashtags 並加入文章中。

使用 WordPress REST API 更新文章的標籤或自訂欄位。
使用 Basic Auth 進行驗證，使用者名稱 {WP_USERNAME}，密碼 {WP_APPLICATION_PASSWORD}。

疑難排解

401 未授權錯誤

• 確認 Basic Auth 外掛已啟用
• 確認你的使用者名稱和密碼正確
• 確認你的 WordPress 網站使用 HTTPS

404 端點未找到

• 確認 WordPress 設定 → 永久連結中已啟用友好網址結構
• 確認 REST API 可以存取：{WP_SITE_URL}/wp-json/

403 禁止存取 / Cloudflare 阻擋

如果你遇到 403 錯誤，可能是 Cloudflare 阻擋了 API 請求。這是因為來自自動化工具的 WordPress REST API 請求可能被標記為可疑。

解決方法——設定自訂 User-Agent 標頭：

透過 OpenClaw Ultra 發送請求時，明確設定一個常見的 User-Agent 字串，讓 Cloudflare 將該請求視為來自真實瀏覽器。例如：

User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36

在 OpenClaw Ultra 的提示中，像這樣加入 User-Agent 標頭：

POST {WP_SITE_URL}/wp-json/wp/v2/posts
Headers:
  User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36
  Authorization: Basic {base64-encoded-credentials}

Body:
  title: "My Post"
  content: "Post content"
  status: publish

WooCommerce 端點無法使用

• 確認 WooCommerce 外掛已安裝並啟用
• WooCommerce API 需要 WooCommerce 3.0 以上版本

後續步驟

• 探索其他 WordPress REST API 端點
• 自動化內容發布排程
• 使用 OpenClaw Ultra 建立完整的內容工作流程

繼續閱讀其他整合指南，擴展你的自動化能力。