diff --git a/README.md b/README.md
index 72b1fab..becffc3 100644
--- a/README.md
+++ b/README.md
@@ -59,6 +59,15 @@ uv tool install twitter-cli
 pipx install twitter-cli
 ```
 
+Upgrade to the latest version:
+
+```bash
+uv tool upgrade twitter-cli
+# Or: pipx upgrade twitter-cli
+```
+
+> **Tip:** Upgrade regularly to avoid unexpected errors from outdated API handling.
+
 Install from source:
 
 ```bash
@@ -333,6 +342,15 @@ After installation, OpenClaw can call `twitter-cli` commands directly.
 uv tool install twitter-cli
 ```
 
+升级到最新版本：
+
+```bash
+uv tool upgrade twitter-cli
+# 或：pipx upgrade twitter-cli
+```
+
+> **提示：** 建议定期升级，避免因版本过旧导致的 API 调用异常。
+
 ### 使用指南
 
 ```bash
diff --git a/SKILL.md b/SKILL.md
index 3da9654..9a27566 100644
--- a/SKILL.md
+++ b/SKILL.md
@@ -22,6 +22,10 @@ tags:
 # Install (requires Python 3.8+)
 uv tool install twitter-cli
 # Or: pipx install twitter-cli
+
+# Upgrade to latest (recommended to avoid API errors)
+uv tool upgrade twitter-cli
+# Or: pipx upgrade twitter-cli
 ```
 
 ## Authentication