如何查看PaperclipAI运行日志及排查Openclaw连接故障

• 直接查看启动进程的终端窗口：使用npx paperclipai run启动时，服务器的所有日志（包括错误详情、请求处理记录）都会实时输出到启动该命令的终端中，可滚动查看历史输出，或重启进程并重点关注错误相关内容。
• 检查配置文件指定的日志路径：若项目根目录存在.env或config.json配置文件，查找LOG_FILE、LOG_PATH类配置项，对应路径下会有持久化的日志文件。

日志位置与启用 #

• PaperclipAI端日志：同问题1的终端输出或配置指定的日志文件，agent邀请流程的请求处理日志、内部错误栈都会在这里输出，是排查internal server error的核心依据。
• Openclaw本地日志：本地运行的Openclaw服务（对应请求中的ws://localhost:18789），其启动终端或自身配置指定的日志文件中，会记录连接状态、token验证等相关信息。
• 代理服务器日志：若paperclipproxy.aiqa.net是你方部署的代理，直接查看该服务器的日志文件；若为第三方提供，需联系运维方获取请求相关日志。

curl请求排查要点 #

针对你发送的curl请求，可先检查以下内容：

• 确认x-openclaw-token的有效性，排查是否过期、权限范围是否匹配。
• 验证本地ws://localhost:18789服务是否正常运行，端口是否可访问。
• 检查请求体JSON格式：确认capabilities字段的格式是否符合PaperclipAI的要求（部分场景可能需要数组而非字符串）。

内容的提问来源于stack exchange，提问作者Khelvaster