บทที่ 11 การแก้ไขปัญหาและการเพิ่มประสิทธิภาพ

ย่อมหลีกเลี่ยงที่จะประสบปัญหาต่าง ๆ เมื่อใช้ OpenClaw บทนี้สรุปวิธีแก้ปัญหาทั่วไป เคล็ดลับการปรับแต่งประสิทธิภาพ และทรัพยากรชุมชน

คำแนะนำในการอ่าน: แนะนำให้ทุกคนอ่านส่วนที่ 1 "คำถามที่พบบ่อย Quick Check" เพื่อให้คุณสามารถค้นหาปัญหาได้อย่างรวดเร็วเมื่อพบปัญหา คุณสามารถอ่านการวิเคราะห์บันทึก การเพิ่มประสิทธิภาพการทำงาน และเนื้อหาอื่นๆ ต่อไปนี้ได้เมื่อคุณพบปัญหาเฉพาะ

1. คำถามที่พบบ่อยด่วน

1.1 ปัญหาการติดตั้ง

ปัญหา	สาเหตุ	โซลูชั่น
`npm install -g openclaw` ความล้มเหลว	เวอร์ชัน Node.js ต่ำเกินไป	อัปเกรดเป็น Node.js 22+
ข้อผิดพลาดในการอนุญาต	สิทธิ์ไม่เพียงพอสำหรับการติดตั้งทั่วโลก npm	ใช้ `sudo` หรือกำหนดค่าคำนำหน้า npm
หมดเวลาเครือข่าย	ไม่สามารถเข้าถึงแหล่งที่มา npm	เปลี่ยนไปใช้แหล่งที่มาของ Taobao: `npm config set registry https://registry.npmmirror.com`

1.2 ปัญหาการเชื่อมต่อ API

ปัญหา	สาเหตุ	โซลูชั่น
`401 Unauthorized`	รหัส API ไม่ถูกต้องหรือหมดอายุ	ตรวจสอบและอัปเดตคีย์ API
`429 Too Many Requests`	ถึงขีดจำกัดการเรียก API แล้ว	ลดงานที่เกิดขึ้นพร้อมกันหรืออัปเกรดแพ็คเกจ API
หมดเวลาการเชื่อมต่อ	ปัญหาเครือข่าย (โดยเฉพาะเมื่อเข้าถึง API ต่างประเทศ)	กำหนดค่าพร็อกซีเครือข่าย (ตัวแปรสภาพแวดล้อม HTTP_PROXY) หรือเปลี่ยนไปใช้ผู้ให้บริการในประเทศ (เช่น Silicon Mobile โปรดดูบทที่ 1)
`503 Service Unavailable`	บริการ API ไม่สามารถใช้งานได้ชั่วคราว	กำลังรอการกู้คืนหรือเปลี่ยนไปใช้โมเดลสำรอง
ผู้ช่วยมีอาการ “ความจำเสื่อม” (ลืมข้อมูลที่เคยให้ไว้)	การสนทนาที่ยาวเกินหน้าต่างบริบท และการบีบอัดหน่วยความจำดั้งเดิมจะสูญเสียรายละเอียด	เขียนข้อมูลสำคัญไปที่ USER.md หรือ MEMORY.md (ดู 第九章 สำหรับรายละเอียด) สถานการณ์ระยะไกลสามารถติดตั้งปลั๊กอินหน่วยความจำ OpenViking

1.3 ปัญหาการเข้าถึงช่อง

ปัญหา	สาเหตุ	โซลูชั่น
โทรเลขไม่ตอบสนอง	ข้อผิดพลาด Bot Token หรือปัญหาเครือข่าย	ตรวจสอบโทเค็นและยืนยันการกำหนดค่าพร็อกซี
ข้อความ Feishu ไม่ตอบสนอง	ไม่ได้เปิดใช้งานการอนุญาตหรือการจับคู่ไม่เสร็จสมบูรณ์	ตรวจสอบการตั้งค่าการอนุญาตแพลตฟอร์มเปิด Feishu
QQ ถูกตัดการเชื่อมต่อ	NapCat WebSocket ถูกตัดการเชื่อมต่อ	ตรวจสอบสถานะการทำงานของ NapCat และเข้าสู่ระบบอีกครั้ง

1.4 ปัญหาด้านทักษะ

ปัญหา	สาเหตุ	โซลูชั่น
`clawhub install` ความล้มเหลว	ปัญหาเครือข่ายหรือชื่อทักษะผิด	ตรวจสอบเครือข่ายและยืนยันว่าชื่อทักษะ (กระสุน) ถูกต้อง
ทักษะไม่สามารถใช้งานได้หลังการติดตั้ง	การพึ่งพาระบบที่ขาดหายไป	ตรวจสอบข้อกำหนดใน SKILL.md
ยังคงรายงานข้อผิดพลาดหลังจากการกำหนดค่าคีย์ API	ข้อผิดพลาดรูปแบบ openclaw.json	ใช้ `openclaw config` สำหรับการกำหนดค่าแบบโต้ตอบ

ขยาย: บันทึกการวินิจฉัย

2. บันทึกการวินิจฉัย

2.1 ดูบันทึก

bash

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

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

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

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

2.2 ระดับบันทึก

jsonc

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

คุณสามารถเปิดระดับการแก้ไขข้อบกพร่องได้ชั่วคราวในระหว่างการพัฒนาและการดีบัก:

bash

openclaw config set logging.level debug
openclaw gateway restart

ขยาย: การเพิ่มประสิทธิภาพการทำงาน

3. การเพิ่มประสิทธิภาพการทำงาน

3.1 ความเร็วในการตอบสนอง

ทักษะการใช้งานลดลง: เพิ่มบริบทประมาณ 200-500 โทเค็นต่อทักษะ 10 ทักษะอาจเพิ่มโทเค็น 3,000-5,000

bash

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

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

ใช้โมเดลที่เร็วกว่า: ไฮกุเร็วกว่า Opus 5-10 เท่าสำหรับงานง่ายๆ

เปิดใช้งานการแคช:

json

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

3.2 การเพิ่มประสิทธิภาพหน่วยความจำ

bash

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

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

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

3.3 การเพิ่มประสิทธิภาพโทเค็น

bash

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

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

ขยาย: การสำรองข้อมูลและการกู้คืน

4. การสำรองข้อมูลและการกู้คืนข้อมูล

4.1 สิ่งที่ต้องสำรองข้อมูล

~/.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 คำสั่งสำรอง

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 การกู้คืน

bash

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

# 重启服务
openclaw gateway restart

ขยาย: คู่มือการอัพเกรด

5. คู่มือการอัพเกรด

5.1 อัปเกรด OpenClaw

bash

# 查看当前版本
openclaw --version

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

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

5.2 หมายเหตุการอัพเกรด

สำรองข้อมูลไดเร็กทอรี ~/.openclaw/ ก่อนอัปเกรด
ดูบันทึกประจำรุ่นสำหรับการเปลี่ยนแปลงที่สำคัญ
ทักษะบางอย่างอาจจำเป็นต้องได้รับการกำหนดค่าใหม่หลังจากการอัปเกรดเวอร์ชันหลัก

6. ทรัพยากรชุมชน

6.1 แหล่งข้อมูลอย่างเป็นทางการ

ทรัพยากร	ที่อยู่
เอกสารอย่างเป็นทางการ	https://openclaw.ai/docs
พื้นที่เก็บข้อมูล GitHub	https://github.com/openclaw/openclaw
ตลาดทักษะ ClawHub	https://github.com/openclaw/clawhub
ชุมชน Discord	https://discord.gg/openclaw

6.2 ชุมชนชาวจีน

ทรัพยากร	ที่อยู่
บทช่วยสอนเวอร์ชันออนไลน์นี้	https://datawhalechina.github.io/hello-claw
ชุมชน Datawhale	https://github.com/datawhalechina

6.3 รับความช่วยเหลือ

ขั้นตอนการแก้ไขปัญหาเมื่อประสบปัญหา:

ตรวจสอบ "คำถามที่พบบ่อยด่วน" ของบทนี้ก่อน
ค้นหาปัญหา GitHub
ถามคำถามในชุมชน Discord
ส่งปัญหา GitHub (แนบบันทึกและขั้นตอนการทำซ้ำ)

ขอแสดงความยินดีที่ทำ "Adopt a Claw" สำเร็จทั้งหมด! ตอนนี้ คุณได้เชี่ยวชาญการติดตั้งและการกำหนดค่าของ OpenClaw การเข้าถึงผ่านมือถือ งานอัตโนมัติ ระบบทักษะ การรวมบริการภายนอก การใช้งานจริง การเพิ่มประสิทธิภาพหลายโมเดล และสถานการณ์การใช้งานจริง

หากคุณต้องการเรียนรู้เพิ่มเติมเกี่ยวกับระบบภายในของ OpenClaw หรือสร้าง AI Agent ของคุณเองตั้งแต่เริ่มต้น โปรดอ่านต่อในส่วนที่สอง "การสร้าง Claw"

ขั้นตอนต่อไป: 第二部分：构建 Claw

บทที่ 11 การแก้ไขปัญหาและการเพิ่มประสิทธิภาพ ​

1. คำถามที่พบบ่อยด่วน ​

1.1 ปัญหาการติดตั้ง ​

1.2 ปัญหาการเชื่อมต่อ API ​

1.3 ปัญหาการเข้าถึงช่อง ​

1.4 ปัญหาด้านทักษะ ​

2. บันทึกการวินิจฉัย ​

2.1 ดูบันทึก ​

2.2 ระดับบันทึก ​

3. การเพิ่มประสิทธิภาพการทำงาน ​

3.1 ความเร็วในการตอบสนอง ​

3.2 การเพิ่มประสิทธิภาพหน่วยความจำ ​

3.3 การเพิ่มประสิทธิภาพโทเค็น ​

4. การสำรองข้อมูลและการกู้คืนข้อมูล ​

4.1 สิ่งที่ต้องสำรองข้อมูล ​

4.2 คำสั่งสำรอง ​

4.3 การกู้คืน ​

5. คู่มือการอัพเกรด ​

5.1 อัปเกรด OpenClaw ​

5.2 หมายเหตุการอัพเกรด ​

6. ทรัพยากรชุมชน ​

6.1 แหล่งข้อมูลอย่างเป็นทางการ ​

6.2 ชุมชนชาวจีน ​

6.3 รับความช่วยเหลือ ​

บทที่ 11 การแก้ไขปัญหาและการเพิ่มประสิทธิภาพ

1. คำถามที่พบบ่อยด่วน

1.1 ปัญหาการติดตั้ง

1.2 ปัญหาการเชื่อมต่อ API

1.3 ปัญหาการเข้าถึงช่อง

1.4 ปัญหาด้านทักษะ

2. บันทึกการวินิจฉัย

2.1 ดูบันทึก

2.2 ระดับบันทึก

3. การเพิ่มประสิทธิภาพการทำงาน

3.1 ความเร็วในการตอบสนอง

3.2 การเพิ่มประสิทธิภาพหน่วยความจำ

3.3 การเพิ่มประสิทธิภาพโทเค็น

4. การสำรองข้อมูลและการกู้คืนข้อมูล

4.1 สิ่งที่ต้องสำรองข้อมูล

4.2 คำสั่งสำรอง

4.3 การกู้คืน

5. คู่มือการอัพเกรด

5.1 อัปเกรด OpenClaw

5.2 หมายเหตุการอัพเกรด

6. ทรัพยากรชุมชน

6.1 แหล่งข้อมูลอย่างเป็นทางการ

6.2 ชุมชนชาวจีน

6.3 รับความช่วยเหลือ