Chương 11 Khắc phục sự cố và tối ưu hóa

Không thể tránh khỏi việc gặp phải nhiều vấn đề khác nhau khi sử dụng OpenClaw. Chương này tóm tắt các giải pháp cho các vấn đề thường gặp, mẹo điều chỉnh hiệu suất và tài nguyên cộng đồng.

Gợi ý đọc: Phần 1 "Kiểm tra nhanh các câu hỏi thường gặp" được khuyến nghị mọi người nên đọc để có thể nhanh chóng xác định vấn đề khi gặp phải. Bạn có thể đọc chẩn đoán nhật ký sau, tối ưu hóa hiệu suất và các nội dung khác khi gặp sự cố cụ thể.

1. Câu hỏi thường gặp nhanh

1.1 Vấn đề cài đặt

Vấn đề	Nguyên nhân	Giải pháp
`npm install -g openclaw` Thất bại	Phiên bản Node.js quá thấp	Nâng cấp lên Node.js 22+
Lỗi cấp phép	Không đủ quyền để cài đặt npm toàn cầu	Sử dụng `sudo` hoặc định cấu hình tiền tố npm
Hết thời gian mạng	nguồn npm không thể truy cập được	Chuyển sang nguồn Taobao: `npm config set registry https://registry.npmmirror.com`

1.2 vấn đề kết nối API

Vấn đề	Nguyên nhân	Giải pháp
`401 Unauthorized`	Khóa API không hợp lệ hoặc đã hết hạn	Kiểm tra và cập nhật API Key
`429 Too Many Requests`	Đã đạt đến giới hạn lệnh gọi API	Giảm bớt các tác vụ đồng thời hoặc nâng cấp gói API
Hết thời gian kết nối	Sự cố mạng (đặc biệt khi truy cập API ở nước ngoài)	Định cấu hình proxy mạng (biến môi trường HTTP_PROXY) hoặc chuyển sang nhà cung cấp trong nước (chẳng hạn như Silicon Mobile, tham khảo Chương 1)
`503 Service Unavailable`	Dịch vụ API tạm thời không khả dụng	Chờ phục hồi hoặc chuyển sang mô hình dự phòng
Trợ lý bị "mất trí nhớ" (quên thông tin đã đưa trước đó)	Các cuộc hội thoại dài vượt quá cửa sổ ngữ cảnh và việc nén bộ nhớ riêng sẽ mất chi tiết	Viết thông tin chính vào USER.md hoặc MEMORY.md (xem 第九章 để biết chi tiết); các kịch bản tầm xa có thể cài đặt plug-in bộ nhớ OpenViking

1.3 Vấn đề truy cập kênh

Vấn đề	Nguyên nhân	Giải pháp
Telegram không phản hồi	Lỗi Bot Token hoặc vấn đề mạng	Kiểm tra Token và xác nhận cấu hình proxy
Tin nhắn Feishu không phản hồi	Quyền không được kích hoạt hoặc ghép nối chưa hoàn thành	Kiểm tra cài đặt quyền của nền tảng mở Feishu
QQ bị ngắt kết nối	NapCat WebSocket bị ngắt kết nối	Kiểm tra trạng thái chạy NapCat và đăng nhập lại

1.4 Vấn đề về kỹ năng

Vấn đề	Nguyên nhân	Giải pháp
`clawhub install` Thất bại	Mạng có vấn đề hoặc tên kỹ năng sai	Kiểm tra mạng và xác nhận rằng tên kỹ năng (sên) là chính xác
Kỹ năng không có sẵn sau khi cài đặt	Thiếu phụ thuộc hệ thống	Kiểm tra các yêu cầu trong SKILL.md
Lỗi vẫn được báo cáo sau khi cấu hình Khóa API	lỗi định dạng openclaw.json	Sử dụng `openclaw config` để cấu hình tương tác

Mở rộng: Chẩn đoán nhật ký

2. Chẩn đoán nhật ký

2.1 Xem nhật ký

bash

# 查看实时日志（持续输出）
openclaw logs --follow

# 查看最近 100 条日志
openclaw logs --limit 100

# 以 JSON 格式输出（方便用 jq 等数据处理工具过滤，新手可忽略此选项）
openclaw logs --limit 100 --json

# 纯文本输出（无颜色）
openclaw logs --limit 50 --plain

2.2 Cấp độ nhật ký

jsonc

// openclaw.json 中的 logging 配置
{
  "logging": {
    "level": "info",
    "file": true,
    "maxSize": "50mb",
    "maxFiles": 10
  }
}

Bạn có thể tạm thời bật mức gỡ lỗi trong quá trình phát triển và gỡ lỗi:

bash

openclaw config set logging.level debug
openclaw gateway restart

Mở rộng: Tối ưu hóa hiệu suất

3. Tối ưu hóa hiệu suất

3.1 Tốc độ phản hồi

GIẢM KỸ NĂNG HOẠT ĐỘNG: Đã thêm bối cảnh khoảng 200-500 mã thông báo cho mỗi kỹ năng. 10 kỹ năng có thể thêm 3000-5000 token.

bash

# 查看当前活跃技能数量
clawhub list --active

# 禁用不常用的技能
clawhub uninstall rarely-used-skill

Sử dụng mô hình nhanh hơn: Haiku nhanh hơn Opus 5-10 lần cho các tác vụ đơn giản.

Bật bộ nhớ đệm:

json

{
  "cache": {
    "enabled": true,
    "ttl": 3600,
    "maxSize": "100mb"
  }
}

3.2 Tối ưu hóa bộ nhớ

bash

# 查看 OpenClaw 内存使用
openclaw status --verbose

# 清理对话历史缓存
openclaw cleanup --conversations --older-than 7d

# 清理技能缓存
openclaw cleanup --skill-cache

3.3 Tối ưu hóa mã thông báo

bash

# 查看每次调用的 Token 消耗
openclaw usage --detail

# 按技能统计
openclaw usage --by-skill --period month

Mở rộng: Sao lưu và phục hồi dữ liệu

4. Sao lưu và phục hồi dữ liệu

4.1 Những gì cần sao lưu

~/.openclaw/
├── openclaw.json        # 配置文件（API Key、渠道设置）
├── workspace/           # 工作区（详见第九章第 7 节）
│   ├── IDENTITY.md      # 助理身份（名字、风格）
│   ├── SOUL.md          # 人格设定和行为准则
│   ├── USER.md          # 你的个人信息和偏好
│   ├── AGENTS.md        # 工作流程和操作规范
│   ├── TOOLS.md         # 环境专属信息（服务器、设备等）
│   ├── MEMORY.md        # 长期记忆
│   ├── HEARTBEAT.md     # 定期巡检清单
│   ├── BOOT.md          # 网关启动时执行的任务
│   ├── BOOTSTRAP.md     # 首次运行初始化（完成后自动删除）
│   └── memory/          # 每日工作日志
├── skills/              # 已安装技能及配置
├── cron/                # 定时任务
└── conversations/       # 对话历史

4.2 Lệnh sao lưu

bash

# 完整备份
tar -czf openclaw-backup-$(date +%Y%m%d).tar.gz ~/.openclaw/

# 只备份配置和工作区（不含对话历史）
tar -czf openclaw-config-$(date +%Y%m%d).tar.gz \
  ~/.openclaw/openclaw.json \
  ~/.openclaw/workspace/ \
  ~/.openclaw/skills/ \
  ~/.openclaw/cron/

4.3 Phục hồi

bash

# 恢复备份
tar -xzf openclaw-backup-20260307.tar.gz -C ~/

# 重启服务
openclaw gateway restart

Mở rộng: Hướng dẫn nâng cấp

5. Hướng dẫn nâng cấp

5.1 Nâng cấp OpenClaw

bash

# 查看当前版本
openclaw --version

# 升级到最新版
npm update -g openclaw

# Docker 用户
docker pull ghcr.io/openclaw/openclaw:latest
docker compose up -d

5.2 Ghi chú nâng cấp

Sao lưu thư mục ~/.openclaw/ trước khi nâng cấp
Xem Ghi chú phát hành để biết những thay đổi đáng chú ý
Một số kỹ năng có thể cần phải được cấu hình lại sau khi nâng cấp phiên bản chính

6. Tài nguyên cộng đồng

6.1 Tài nguyên chính thức

Tài nguyên	Địa chỉ
Tài liệu chính thức	https://openclaw.ai/docs
Kho lưu trữ GitHub	https://github.com/openclaw/openclaw
Thị trường Kỹ năng ClawHub	https://github.com/openclaw/clawhub
Cộng đồng bất hòa	https://discord.gg/openclaw

6.2 Cộng đồng người Hoa

Tài nguyên	Địa chỉ
Phiên bản trực tuyến của hướng dẫn này	https://datawhalechina.github.io/hello-claw
Cộng đồng Datawhale	https://github.com/datawhalechina

6.3 Nhận trợ giúp

Các bước khắc phục sự cố khi gặp sự cố:

Trước tiên hãy kiểm tra "Câu hỏi thường gặp nhanh" của chương này.
Tìm kiếm các vấn đề về GitHub
Đặt câu hỏi trong cộng đồng Discord
Gửi vấn đề GitHub (đính kèm nhật ký và các bước sao chép)

Chúc mừng bạn đã hoàn thành tất cả "Adopt a Claw"! Bây giờ bạn đã thành thạo việc cài đặt và cấu hình OpenClaw, truy cập di động, tác vụ tự động, hệ thống kỹ năng, tích hợp dịch vụ bên ngoài, triển khai sản xuất, tối ưu hóa đa mô hình và các kịch bản ứng dụng thực tế.

Nếu bạn muốn tìm hiểu thêm về nội dung bên trong của OpenClaw hoặc xây dựng Tác nhân AI của riêng mình từ đầu, hãy tiếp tục đọc Phần thứ hai, "Xây dựng móng vuốt".

Bước tiếp theo: 第二部分：构建 Claw

Chương 11 Khắc phục sự cố và tối ưu hóa ​

1. Câu hỏi thường gặp nhanh ​

1.1 Vấn đề cài đặt ​

1.2 vấn đề kết nối API ​

1.3 Vấn đề truy cập kênh ​

1.4 Vấn đề về kỹ năng ​

2. Chẩn đoán nhật ký ​

2.1 Xem nhật ký ​

2.2 Cấp độ nhật ký ​

3. Tối ưu hóa hiệu suất ​

3.1 Tốc độ phản hồi ​

3.2 Tối ưu hóa bộ nhớ ​

3.3 Tối ưu hóa mã thông báo ​

4. Sao lưu và phục hồi dữ liệu ​

4.1 Những gì cần sao lưu ​

4.2 Lệnh sao lưu ​

4.3 Phục hồi ​

5. Hướng dẫn nâng cấp ​

5.1 Nâng cấp OpenClaw ​

5.2 Ghi chú nâng cấp ​

6. Tài nguyên cộng đồng ​

6.1 Tài nguyên chính thức ​

6.2 Cộng đồng người Hoa ​

6.3 Nhận trợ giúp ​

Chương 11 Khắc phục sự cố và tối ưu hóa

1. Câu hỏi thường gặp nhanh

1.1 Vấn đề cài đặt

1.2 vấn đề kết nối API

1.3 Vấn đề truy cập kênh

1.4 Vấn đề về kỹ năng

2. Chẩn đoán nhật ký

2.1 Xem nhật ký

2.2 Cấp độ nhật ký

3. Tối ưu hóa hiệu suất

3.1 Tốc độ phản hồi

3.2 Tối ưu hóa bộ nhớ

3.3 Tối ưu hóa mã thông báo

4. Sao lưu và phục hồi dữ liệu

4.1 Những gì cần sao lưu

4.2 Lệnh sao lưu

4.3 Phục hồi

5. Hướng dẫn nâng cấp

5.1 Nâng cấp OpenClaw

5.2 Ghi chú nâng cấp

6. Tài nguyên cộng đồng

6.1 Tài nguyên chính thức

6.2 Cộng đồng người Hoa

6.3 Nhận trợ giúp