核心配置文件
OpenClaw 的配置通常通过命令行参数、配置文件或两者结合来管理,主要配置文件路径：
- Linux/macOS:
~/.config/claw/claw.conf或~/.clawrc - Windows:
%USERPROFILE%\.config\claw\claw.conf或%USERPROFILE%\.clawrc
您可以通过 claw --help 查看所有支持的参数，通过 claw -c /path/to/your/config.conf 指定自定义配置文件。
连接与性能优化
这些设置用于提升下载速度和资源利用率。
| 参数/配置 | 示例/建议值 | 说明 |
|---|---|---|
-j, --max-concurrent-downloads |
-j 8 |
最大同时下载任务数，根据网络和磁盘性能调整（3-8）。 |
-s, --max-connections-per-server |
-s 16 |
单个服务器最大连接数，对支持多线程的服务器（如HTTP）有效，可显著提速，值太高可能被服务器封禁。 |
--min-split-size |
--min-split-size=20M |
最小分片大小，文件大于此值才会使用多连接下载，避免对小文件建立过多无效连接。 |
--max-connection-per-host |
--max-connection-per-host=50 |
对同一主机名（域名）的最大总连接数（所有任务总和），防止过度占用对方服务器。 |
--stream-piece-selector |
--stream-piece-selector=geom |
分片选择算法。geom（几何）通常比默认的inorder（顺序）更快，能优先下载靠前的分片以便尽早播放/查看。 |
-k, --continue |
-k |
始终启用断点续传，强烈建议在配置文件中默认开启。 |
示例配置段 (用于 claw.conf):
max-concurrent-downloads=5
max-connection-per-server=16
min-split-size=20M
stream-piece-selector=geom协议与功能高级设置
针对特定协议或功能的深度定制。
| 参数/配置 | 示例 | 说明 |
|---|---|---|
--user-agent |
--user-agent="Mozilla/5.0 ..." |
伪装浏览器 User-Agent，绕过某些服务器的简单屏蔽。 |
--referer |
--referer="https://example.com" |
设置来源页，对需要 Referer 校验的资源有效。 |
--header |
--header="Cookie: session=xxx" |
添加自定义 HTTP 请求头，用于传递认证信息、特殊令牌等，可多次使用。 |
--all-proxy |
--all-proxy="http://127.0.0.1:7890" |
为所有协议设置代理服务器，支持 HTTP/HTTPS/SOCKS5。 |
--check-certificate=false |
跳过 SSL 证书验证（不安全，仅用于测试或访问自签名证书站点）。 | |
-Z, --force-sequential |
-Z |
强制顺序下载，即使支持多线程，用于遵守特定网站规则或下载大量小文件时减轻服务器压力。 |
| *`--bt-` 系列参数** | --bt-tracker="udp://... --bt-enable-lpd=true --bt-remove-unselected-file |
BitTorrent 相关：添加 tracker 服务器、启用本地对等点发现、下载种子中选定文件后删除未选文件等。 |
-P, --directory-prefix |
-P ~/Downloads/category |
指定下载目录，可在命令行或配置中设置。 |
-o, --out |
-o "filename.ext" |
自定义下载文件名，支持模板（如 %(title)s.%(ext)s）。 |
代理与网络配置
精细控制网络行为。
| 参数 | 说明 |
|---|---|
--http-proxy, --https-proxy |
分别设置 HTTP 和 HTTPS 代理。 |
--no-proxy |
设置不使用代理的主机或域名列表（逗号分隔）。 |
--connect-timeout |
连接服务器超时时间（秒）。 |
--timeout |
整个下载操作超时时间（秒）。 |
--retry-wait |
重试等待时间（秒），可配合 --max-tries 使用。 |
--lowest-speed-limit |
最低速度限制（如 10K），若下载速度持续低于此值，则中止并重试。 |
后台与任务管理
适用于长期运行或自动化场景。
| 参数 | 示例 | 说明 |
|---|---|---|
-d, --daemon |
-d |
以守护进程（后台）模式运行。 |
--download-result |
--download-result=full |
下载结果报告级别：full（详细）、hide（静默）。 |
--save-session |
--save-session=/path/to/session.txt |
重要：定时将未完成的任务列表保存到文件。 |
--input-file |
--input-file=/path/to/urls.txt |
从文件批量读取下载链接（每行一个）。 |
--auto-save-interval |
--auto-save-interval=30 |
自动保存进度和会话的间隔（秒）。 |
| *`--on-download-`** | --on-download-complete=/path/to/script.sh |
事件钩子，可在下载开始、停止、完成、出错时触发外部脚本。 |
自动化工作流示例：
- 将待下载链接写入
queue.txt。 - 启动一个后台任务，并定期保存会话：
claw -c my_config.conf -i queue.txt --save-session=session.json --auto-save-interval=60 -d
- 如果程序中断，可以使用相同命令或
claw -c my_config.conf --input-file=session.json来恢复所有任务。
进阶使用技巧
- 配置文件模板：创建一个包含你常用设置（如代理、并发数、保存路径）的配置文件,作为所有任务的默认基础。
- 组合使用：将参数、配置文件和命令行参数灵活组合,命令行参数通常优先级最高。
- 脚本集成：利用
--on-download-complete等钩子，实现下载完成后自动调用媒体处理工具（如ffmpeg）、触发通知或移动文件。 - 会话恢复：定期使用
--save-session是下载大型或关键任务时的必备安全措施。 - 参数验证：不确定参数效果时,先用一个小的测试文件或磁力链接进行验证。
最简推荐进阶配置示例 (~/.clawrc):
# 基础优化 continue=true max-concurrent-downloads=3 max-connection-per-server=8 min-split-size=10M # 网络与重试 connect-timeout=60 timeout=300 max-tries=5 retry-wait=10 # 代理设置 (按需取消注释) # all-proxy=http://127.0.0.1:7890 # no-proxy=localhost,127.0.0.1,192.168.* # 保存路径 dir=~/Downloads # BT增强 (按需取消注释) # bt-enable-lpd=true # bt-tracker=udp://tracker.opentrackr.org:1337/announce,http://tracker.openbittorrent.com:80/announce # 安全与日志 # log-level=warn # save-session-interval=30
请根据您的实际网络环境、下载需求（HTTP/FTP/BT）和硬件性能，对上述参数进行调整测试,以找到最优配置组合。
版权声明：除非特别标注，否则均为本站原创文章，转载时请以链接形式注明文章出处。
