36 lines
1.4 KiB
Markdown
36 lines
1.4 KiB
Markdown
# 调试 PicoClaw
|
||
|
||
> 返回 [README](../project/README.zh.md)
|
||
|
||
PicoClaw 在处理每一个请求时，都会在后台执行多个复杂的交互操作——从消息路由和复杂度评估，到工具执行和模型故障适配。能够准确地看到正在发生什么至关重要，这不仅有助于排查潜在问题，也有助于真正理解代理的运作方式。
|
||
|
||
## 以调试模式启动 PicoClaw
|
||
|
||
要获取代理运行的详细信息（LLM 请求、工具调用、消息路由），可以使用调试标志启动 PicoClaw 网关：
|
||
|
||
```bash
|
||
picoclaw gateway --debug
|
||
# or
|
||
picoclaw gateway -d
|
||
```
|
||
|
||
在此模式下，系统会对日志进行详细格式化，并显示系统提示词和工具执行结果的预览。
|
||
|
||
## 禁用日志截断（完整日志）
|
||
|
||
默认情况下，PicoClaw 会在调试日志中截断过长的字符串（例如*系统提示词*或大型 JSON 输出结果），以保持控制台的可读性。
|
||
|
||
如果你需要检查某个命令的完整输出，或发送给 LLM 模型的确切载荷，可以使用 `--no-truncate` 标志。
|
||
|
||
**注意：** 此标志*仅*在与 `--debug` 模式组合使用时有效。
|
||
|
||
```bash
|
||
picoclaw gateway --debug --no-truncate
|
||
|
||
```
|
||
|
||
当此标志激活时，全局截断功能将被禁用。这在以下场景中非常有用：
|
||
|
||
* 验证发送给提供商的消息的确切语法。
|
||
* 读取 `exec`、`web_fetch` 或 `read_file` 等工具的完整输出。
|
||
* 调试保存在内存中的会话历史。
|