WordPress OAuth 技能

使用此技能执行人工参与的 OAuth 流程，并利用已存储的 Bearer Token 发布文章。

该技能包含的文件

• 脚本：{baseDir}/wp_oauth_skill.py
• OAuth 状态存储文件：{baseDir}/oauth_state.json
• 凭据存储文件：{baseDir}/credentials.json

该技能将状态和凭据保存在本技能目录内的文件中。

命令

使用 Python 3 运行脚本：

python3 {baseDir}/wp_oauth_skill.py --help

1) 启动 OAuth

python3 {baseDir}/wp_oauth_skill.py begin-oauth 
  --client-id "$WPCOM_CLIENT_ID" 
  --redirect-uri "$WPCOM_REDIRECT_URI" 
  --scope "posts media" 
  --blog "$WPCOM_SITE"

返回 auth_url 和 state。请在浏览器中打开该 URL，授权访问，然后复制回调 URL。

2) 换取 Token

python3 {baseDir}/wp_oauth_skill.py exchange-token 
  --client-id "$WPCOM_CLIENT_ID" 
  --client-secret "$WPCOM_CLIENT_SECRET" 
  --redirect-uri "$WPCOM_REDIRECT_URI" 
  --callback-url "https://example/callback?code=...&state=..."

验证 CSRF state，使用授权码换取访问令牌，并将凭据写入 {baseDir}/credentials.json。

3) 查询 Token 信息

python3 {baseDir}/wp_oauth_skill.py token-info --client-id "$WPCOM_CLIENT_ID"

通过 WordPress 的 token-info 接口校验 Token 的有效性。

4) 发布文章

python3 {baseDir}/wp_oauth_skill.py publish-post 
  --site "$WPCOM_SITE" 
  --title "My post" 
  --content "
Hello from OpenClaw
" 
  --status draft

使用已存储的 Token，通过 POST /rest/v1.1/sites/$site/posts/new 接口发布文章。

推荐流程

1. 运行 begin-oauth。
2. 在浏览器中打开 auth_url 并完成授权。
3. 将回调 URL 粘贴至 exchange-token 命令中执行。
4. （可选）运行 token-info 验证 Token 状态。
5. 运行 publish-post 发布文章。

安全注意事项

• 切勿共享 credentials.json 文件或客户端密钥（client secret）。
• 首次测试发布的文章建议设为 draft 状态。
• 若回调时 state 校验失败，或授权码（auth code）已过期，请重新运行 begin-oauth。