必须先验证s3fs是否安装，命令为which s3fs或s3fs --version；未安装时ubuntu/debian用sudo apt install s3fs，centos/rhel需先启用epel再yum install s3fs-fuse；密钥文件权限必须为600，挂载非aws服务时必须指定-o url=和-o use_path_request_style参数。
挂载前必须确认 s3fs 是否已正确安装
s3fs 不是系统默认自带的工具，很多 Linux 发行版（尤其是最小化安装的 CentOS/Alibaba Cloud Linux）压根没装。直接运行 s3fs 会报 command not found，别急着查文档，先验证安装状态。
检查命令：which s3fs 或 s3fs --version。如果返回空或报错，说明没装。不同系统安装方式有差异：
- Ubuntu/Debian：
sudo apt-get update && sudo apt-get install -y s3fs - CentOS/RHEL 7+：
sudo yum install -y epel-release && sudo yum install -y s3fs-fuse - Alibaba Cloud Linux 3 / Anolis OS：
sudo dnf install -y s3fs-fuse
注意：某些旧版系统（如 CentOS 7）若 yum install s3fs-fuse 失败，大概率是 EPEL 源未启用，sudo yum install epel-release 必须先执行。
密钥文件权限必须设为 600，否则挂载必然失败
这是最常踩的坑——s3fs 出于安全强制校验密钥文件权限，只要不是 600，就会静默拒绝挂载，错误信息只有一句模糊的 s3fs: unable to access credentials，不提示具体原因。
正确操作顺序：
- 用
echo "AK:SK" | sudo tee /etc/passwd-s3fs写入（AK/SK 替换为你的真实密钥） - 立刻执行
sudo chmod 600 /etc/passwd-s3fs - 确认结果：
ls -l /etc/passwd-s3fs应显示-rw-------
不要用 644 或 655，哪怕你只是想“方便调试”——s3fs 会直接退出，不给任何商量余地。
挂载命令里 endpoint 和 url 参数不能省，尤其对接非 AWS 的 S3 兼容服务
Hi168、MinIO、火山云 TOS、阿里云 OSS 等都兼容 S3 协议，但它们不是 AWS，所以默认的 https://s3.amazonaws.com 根本连不通。漏掉 -o url=... 或 -o endpoint=... 会导致挂载卡住、超时，或者报 Connection refused。
Linux AI 服务器 — 将 Linux 服务器转换为本地 AI 推理集群。使用 systemd、NVIDIA CUDA 实现无头 Linux AI，零 GUI 开销。
关键参数对照：
- Hi168：用
-o url=http://s3.hi168.com（注意是http，不是https；官方文档明确要求） - MinIO 自建：用
-o url=http://your-minio-ip:9000，并加-o use_path_request_style - 阿里云 OSS：用
-o url=https://oss-cn-hangzhou.aliyuncs.com+-o use_path_request_style - AWS 海外区域（如东京）：用
-o endpoint=ap-northeast-1
另外，-o use_path_request_style 对多数国产 S3 兼容服务是刚需，否则会因签名格式不匹配而 403。
普通用户要能读写挂载点，必须加 allow_other 且确保 fuse 模块可用
默认情况下，s3fs 挂载后只有 root 能访问。如果你用 sudo s3fs ... 挂载，但 OpenClaw 是以 claw-user 运行的，就会遇到 Permission denied —— 即便目录权限设成 777 也没用。
解决办法是加两个参数：
-
-o allow_other：允许其他用户访问该挂载点 -
-o umask=0022（可选）：让新创建的文件默认有读权限
但光加参数还不够：需确认 fuse 内核模块已加载（lsmod | grep fuse），且当前用户在 fuse 用户组里（sudo usermod -aG fuse $USER，改完需重新登录）。否则 allow_other 会被忽略。
完整挂载示例（Hi168 场景）：sudo s3fs hi168-openclaw-data /mnt/hi168-openclaw -o passwd_file=/etc/passwd-s3fs -o url=http://s3.hi168.com -o use_path_request_style -o allow_other -o umask=0022
挂载成功后，df -h 里会出现一行 s3fs 类型设备；但要注意：它不支持 du 统计大小，ls -l 显示的文件大小是元数据缓存值，不是真实对象大小。真要查用量，得去对应云平台控制台看。
