如果你有会员账号，可以在这里配置cookie来下载原图

openclaw AI使用帮助 2026-04-09 1

修改前请备份 claw.conf 文件。

如果你有会员账号，可以在这里配置cookie来下载原图-第1张图片-AI小龙虾下载官网 - openclaw下载 - openclaw小龙虾

核心优化参数（位于 `[Main]` 或 `[Core]` 部分）

这些设置直接影响下载引擎的性能。

thread
- 作用：每个下载任务的并发线程数，增加线程可以提高下载速度，但设置过高会增加服务器负担，可能导致IP被暂时封禁或连接超时。
- 建议：对于大型、速度快的站点（如 pixiv），可以设为 8-16，对于限制较严的站点，建议 3-8，默认值通常为 5。
retry
- 作用：下载失败后的重试次数。
- 建议：对于网络不稳定或服务器响应慢的站点，可以增加到 5-10，默认值通常为 3。
timeout
- 作用：网络请求超时时间（秒），如果服务器响应慢，提高此值可以避免不必要的重试。
- 建议：对于慢速站点，可以设为 30-60，默认值通常为 30。
speed_limit
- 作用：全局下载速度限制（KB/s），设置为 0 表示不限速，如果你想在下载时做其他事情，可以适当限速。
- 格式：speed_limit = 1024 （限制为 1MB/s）。
queue_size
- 作用：同时进行的最大下载任务数，如果你的网络带宽足够大，可以增加此值以并行下载多个图集/作品。
- 建议：根据带宽和CPU性能，3-10 为宜，设置过高可能导致大量任务卡在重试阶段。

网络与请求参数（提升连接稳定性和成功率）

proxy
- 作用：设置HTTP/HTTPS代理，对于无法直接访问的站点（如 X/Twitter）至关重要。
- 格式：
```
proxy = http://127.0.0.1:7890
proxy = socks5://127.0.0.1:7891
```
user_agent
- 作用：设置HTTP请求的User-Agent头，有些网站会检查UA，使用一个常见的浏览器UA可以避免被识别为爬虫。
- 格式：
```
user_agent = Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36
```
header
- 作用：添加自定义的HTTP请求头，这是高级且重要的功能，用于应对复杂的反爬机制。
- 常见用例：
  - 设置Referer（防盗链）：许多图站要求请求图片时携带来源页面的Referer。
```
header = Referer: https://www.pixiv.net/
```
  - 设置Cookie：对于需要登录才能访问的内容，可以手动填入登录后的Cookie。
```
header = Cookie: PHPSESSID=xxx; login_token=yyy
```
  - 设置授权：
```
header = Authorization: Bearer xxxxxxxx
```
verify_ssl
- 作用：是否验证SSL证书，如果遇到SSL错误，可以尝试关闭验证（仅用于调试或信任的站点）。
- 格式：verify_ssl = false

文件与路径参数（优化文件管理）

filename
- 作用：定义下载文件的命名规则，这是高度自定义的部分。
- 变量（不同模块支持的变量不同，常见有）：
  - {id}：作品ID
  - {title}
  - {user_id}：作者ID
  - {user_name}：作者名称
  - {index}：图片序号
  - {ext}：文件扩展名
- 示例：
```
filename = {user_name}/{id}_{index}.{ext}      # 按作者名分文件夹，文件名为“作品ID_序号”
filename = {id}/{index:03d}.{ext}              # 按作品ID分文件夹，文件名为“001.jpg”
```
folder
- 作用：根下载目录。
- 格式：folder = D:/Downloads/OpenClaw
overwrite
- 作用：当文件已存在时是否覆盖。
- 选项：true (覆盖) / false (跳过，默认)。
continue
- 作用：是否开启断点续传。
- 建议：对于大文件，设置为 true。

模块特定参数（针对不同网站）

在 claw.conf 中，每个网站模块（如 [Pixiv], [Twitter], [YouTube]）都有自己独立的配置节，你可以为不同站点设置不同的优化参数。

示例：优化 Pixiv 模块

[Pixiv]
thread = 12                     # Pixiv服务器较好，线程可以开多一些
retry = 5
timeout = 30
filename = Pixiv/{user_name}({user_id})/{id}_p{index}.{ext} # 详细的命名规则
header = Referer: https://www.pixiv.net/ # Pixiv必须的Referer# header = Cookie: PHPSESSID=你的SESSID

示例：配置 Twitter 模块

[Twitter]
thread = 5                      # Twitter限制较严，线程数不宜过高
retry = 10                      # 网络不稳定，增加重试
proxy = http://127.0.0.1:7890   # Twitter通常需要代理
timeout = 60

进阶调整建议与策略

循序渐进：每次只修改1-2个参数，测试效果，再进行调整。
场景化配置：
- 批量下载：适当提高 queue_size 和 thread。
- 困难站点：优先调整 timeout, retry，并正确配置 header（尤其是Cookie和Referer）。
- 节省资源：降低 thread 和 queue_size，启用 speed_limit。
善用日志：遇到问题时，开启日志功能（如果有）或查看命令行输出，根据错误信息（如 403 Forbidden, Timeout, Connection Reset）针对性调整参数（如添加Header、降低线程数、增加超时）。
网络环境：确保你的网络稳定，如果需要代理，代理服务器的质量是决定性因素。