🔧 常见问题排查

踩过的坑和解决方案汇总

🔴 Cron 任务执行失败

现象:定时任务状态显示 error

原因:agent 不知道如何读取生成的文件

解决:在 message 中明确指示"使用 read 工具读取生成的文件"

🔴 Nginx 403 Forbidden

现象:网站返回 403 错误

原因:www-data 用户没有文件读取权限

解决:将网站文件移动到 /var/www/,并设置正确权限

chown -R www-data:www-data /var/www/your-site

🔴 SSL 证书申请失败

现象:certbot 无法申请证书

原因:DNS 未解析或 80 端口被占用

解决:先确保 DNS 解析生效,检查 Nginx 配置

🔴 飞书消息发送失败

现象:消息没有发送到飞书

原因:target 格式错误或权限问题

解决:使用正确的 user:open_id 格式

💡 调试技巧

  • 查看 Nginx 错误日志:tail -f /var/log/nginx/error.log
  • 检查文件权限:namei -l /path/to/file
  • 测试用户权限:sudo -u www-data cat file
  • 检查 cron 任务:openclaw cron list
← 静态网站部署 返回教程列表 →