AWS S3 Skill

预打包的 AWS S3 SDK，专供 OpenClaw 网关容器内部使用。所有传递依赖均已打包。安装时无需访问互联网。

安装

从发布版 tarball 安装到网关容器中：

TAG=$(curl -fsSL "https://api.github.com/repos/PanthroCorp-Limited/openclaw-skills/releases" 
  | grep -o '"tag_name":"aws-s3/v[^"]*"' | head -1 | cut -d'"' -f4)
VERSION=${TAG#aws-s3/v}
URL="https://github.com/PanthroCorp-Limited/openclaw-skills/releases/download/${TAG}/openclaw-aws-s3-${VERSION}.tgz"
docker exec openclaw-gateway npm install "$URL" --prefix /home/node/.openclaw/bin/.npm-global

或从已下载的 tarball 安装：

docker exec openclaw-gateway npm install /path/to/openclaw-aws-s3-0.1.0.tgz 
  --prefix /home/node/.openclaw/bin/.npm-global

使用方法

const { S3Client, ListObjectsV2Command, GetObjectCommand } = require("@openclaw/aws-s3");

const client = new S3Client({});

const list = await client.send(new ListObjectsV2Command({
  Bucket: process.env.EMAIL_BUCKET_NAME,
  Prefix: `parsed/${agentName}/`,
}));

const obj = await client.send(new GetObjectCommand({
  Bucket: process.env.EMAIL_BUCKET_NAME,
  Key: "parsed/agent/email.json",
}));
const body = await obj.Body.transformToString();

认证

凭证通过 AWS SDK 默认凭证提供程序链（Default Credential Provider Chain）自动解析。在 EC2/ECS 环境中，该机制会自动使用 IMDS（实例元数据服务）。当在 Docker 内运行时，请确保 IMDS 跳数限制（hop limit）设置为 2 或更高。

认证过程无需设置任何环境变量。AWS_REGION 应在无法从实例元数据中推断出区域时显式设置。

重要说明

• 本包已将 @aws-sdk/client-s3 及其全部传递依赖一并打包。
• 安装时无需网络连接。
• 网关容器中必须已安装 Node.js。
• SDK 中所有 S3 命令均可用，并不仅限于上述示例中列出的命令。