Bab 11 Pemecahan Masalah dan Optimasi

Berbagai masalah tidak dapat dihindari saat menggunakan OpenClaw. Bab ini merangkum solusi untuk masalah umum, tips penyesuaian kinerja, dan sumber daya komunitas.

Saran Membaca: Bagian 1 "Pertanyaan yang Sering Diajukan Pemeriksaan Cepat" disarankan agar semua orang membacanya sehingga Anda dapat dengan cepat menemukan masalah saat menemuinya. Anda dapat membaca diagnosis log berikut, pengoptimalan kinerja, dan konten lainnya ketika Anda mengalami masalah tertentu.

1. FAQ Cepat

1.1 Masalah instalasi

Masalah	Penyebab	Solusi
`npm install -g openclaw` Kegagalan	Versi Node.js terlalu rendah	Tingkatkan ke Node.js 22+
Kesalahan izin	Izin tidak mencukupi untuk instalasi global npm	Gunakan `sudo` atau konfigurasikan awalan npm
Batas waktu jaringan	sumber npm tidak dapat diakses	Beralih ke sumber Taobao: `npm config set registry https://registry.npmmirror.com`

1.2 Masalah koneksi API

Masalah	Penyebab	Solusi
`401 Unauthorized`	Kunci API tidak valid atau kedaluwarsa	Periksa dan perbarui Kunci API
`429 Too Many Requests`	Batas panggilan API tercapai	Kurangi tugas bersamaan, atau tingkatkan paket API
Batas waktu koneksi	Masalah jaringan (terutama saat mengakses API luar negeri)	Konfigurasikan proxy jaringan (variabel lingkungan HTTP_PROXY) atau beralih ke penyedia domestik (seperti Silicon Mobile, lihat Bab 1)
`503 Service Unavailable`	Layanan API untuk sementara tidak tersedia	Menunggu pemulihan, atau beralih ke model cadangan
Asisten mengalami "amnesia" (lupa informasi yang diberikan sebelumnya)	Percakapan panjang melebihi jendela konteks, dan kompresi memori asli kehilangan detail	Tulis informasi penting ke USER.md atau MEMORY.md (lihat 第九章 untuk rinciannya); skenario jangka panjang dapat menginstal plugin memori OpenViking

1.3 Masalah akses saluran

Masalah	Penyebab	Solusi
Telegram tidak merespons	Kesalahan Bot Token atau masalah jaringan	Periksa Token dan konfirmasi konfigurasi proxy
Pesan Feishu tidak merespons	Izin tidak diaktifkan atau pemasangan tidak selesai	Periksa pengaturan izin platform terbuka Feishu
QQ terputus	NapCat WebSocket terputus	Periksa status berjalan NapCat dan masuk lagi

1.4 Masalah keterampilan

Masalah	Penyebab	Solusi
`clawhub install` Kegagalan	Masalah jaringan atau nama skill salah	Periksa jaringan dan pastikan nama skill (slug) sudah benar
Keterampilan tidak tersedia setelah instalasi	Ketergantungan sistem tidak ada	Periksa persyaratan di SKILL.md
Kesalahan masih dilaporkan setelah konfigurasi Kunci API	kesalahan format openclaw.json	Gunakan `openclaw config` untuk konfigurasi interaktif

Perluas: Log diagnosis

2. Catat diagnosisnya

2.1 Melihat log

bash

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

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

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

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

2.2 Tingkat log

jsonc

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

Anda dapat mengaktifkan tingkat debug untuk sementara selama pengembangan dan debugging:

bash

openclaw config set logging.level debug
openclaw gateway restart

Perluas: Pengoptimalan kinerja

3. Optimalisasi kinerja

3.1 Kecepatan respons

KETERAMPILAN AKTIF YANG DIKURANGI: Menambahkan konteks sekitar 200-500 token per keterampilan. 10 keterampilan dapat menambah 3000-5000 token.

bash

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

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

Gunakan Model Lebih Cepat: Haiku 5-10 kali lebih cepat dibandingkan Opus untuk tugas sederhana.

Aktifkan cache:

json

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

3.2 Optimasi memori

bash

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

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

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

3.3 Pengoptimalan token

bash

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

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

Perluas: Pencadangan dan pemulihan data

4. Pencadangan dan pemulihan data

4.1 Apa yang perlu dibackup

~/.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 Perintah cadangan

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 Pemulihan

bash

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

# 重启服务
openclaw gateway restart

Perluas: Panduan Peningkatan

5. Panduan Peningkatan

5.1 Tingkatkan OpenClaw

bash

# 查看当前版本
openclaw --version

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

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

5.2 Catatan Peningkatan

Cadangkan direktori ~/.openclaw/ sebelum memutakhirkan
Lihat Catatan Rilis untuk mengetahui perubahan terkini
Beberapa keterampilan mungkin perlu dikonfigurasi ulang setelah peningkatan versi utama

6. Sumber daya komunitas

6.1 Sumber daya resmi

Sumber Daya	Alamat
Dokumentasi Resmi	https://openclaw.ai/docs
Repositori GitHub	https://github.com/openclaw/openclaw
Pasar Keterampilan ClawHub	https://github.com/openclaw/clawhub
Komunitas Perselisihan	https://discord.gg/openclaw

6.2 Komunitas Tionghoa

Sumber Daya	Alamat
Versi online dari tutorial ini	https://datawhalechina.github.io/hello-claw
Komunitas Paus Data	https://github.com/datawhalechina

6.3 Dapatkan bantuan

Langkah-langkah pemecahan masalah ketika menemui masalah:

Periksa "FAQ Singkat" pada bab ini terlebih dahulu.
Cari Masalah GitHub
Ajukan pertanyaan di komunitas Discord
Kirim Masalah GitHub (lampirkan log dan langkah-langkah reproduksi)

Selamat telah menyelesaikan semua "Adopt a Claw"! Sekarang Anda telah menguasai instalasi dan konfigurasi OpenClaw, akses seluler, tugas otomatis, sistem keterampilan, integrasi layanan eksternal, penerapan produksi, pengoptimalan multi-model, dan skenario aplikasi praktis.

Jika Anda ingin mempelajari lebih lanjut tentang internal OpenClaw, atau membangun Agen AI Anda sendiri dari awal, lanjutkan membaca Bagian Kedua, "Membangun Claw."

Langkah selanjutnya: 第二部分：构建 Claw

Bab 11 Pemecahan Masalah dan Optimasi ​

1. FAQ Cepat ​

1.1 Masalah instalasi ​

1.2 Masalah koneksi API ​

1.3 Masalah akses saluran ​

1.4 Masalah keterampilan ​

2. Catat diagnosisnya ​

2.1 Melihat log ​

2.2 Tingkat log ​

3. Optimalisasi kinerja ​

3.1 Kecepatan respons ​

3.2 Optimasi memori ​

3.3 Pengoptimalan token ​

4. Pencadangan dan pemulihan data ​

4.1 Apa yang perlu dibackup ​

4.2 Perintah cadangan ​

4.3 Pemulihan ​

5. Panduan Peningkatan ​

5.1 Tingkatkan OpenClaw ​

5.2 Catatan Peningkatan ​

6. Sumber daya komunitas ​

6.1 Sumber daya resmi ​

6.2 Komunitas Tionghoa ​

6.3 Dapatkan bantuan ​

Bab 11 Pemecahan Masalah dan Optimasi

1. FAQ Cepat

1.1 Masalah instalasi

1.2 Masalah koneksi API

1.3 Masalah akses saluran

1.4 Masalah keterampilan

2. Catat diagnosisnya

2.1 Melihat log

2.2 Tingkat log

3. Optimalisasi kinerja

3.1 Kecepatan respons

3.2 Optimasi memori

3.3 Pengoptimalan token

4. Pencadangan dan pemulihan data

4.1 Apa yang perlu dibackup

4.2 Perintah cadangan

4.3 Pemulihan

5. Panduan Peningkatan

5.1 Tingkatkan OpenClaw

5.2 Catatan Peningkatan

6. Sumber daya komunitas

6.1 Sumber daya resmi

6.2 Komunitas Tionghoa

6.3 Dapatkan bantuan