# Volcengine Balance Check

> 查询火山引擎账户消费信息。使用时：用户询问火山引擎账户消费、余额或账单信息时触发。

- Skill: `igoingdown/volcengine-balance-check` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add igoingdown/volcengine-balance-check`
- Raw SKILL.md: https://api.skillmd.com/api/skills/igoingdown/volcengine-balance-check/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: igoingdown (https://skillmd.com/u/igoingdown)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/igoingdown/volcengine-balance-check

---


# 火山引擎账户查询

## 快速开始

1. **安装依赖**：`bash install.sh`
2. **配置密钥**：把火山引擎 AK/SK 加进 `~/github/my_dot_files/secrets.sh`（参考 `secrets.example.sh`）
   ```bash
   export VOLC_ACCESS_KEY="..."
   export VOLC_SECRET_KEY="..."
   ```
   获取密钥：访问 [火山引擎密钥管理](https://console.volcengine.com/iam/keymanage) 创建 Access Key（推荐使用主账号密钥）。
3. **测试运行**：
   ```bash
   source venv/bin/activate && python volcengine_balance_check.py
   ```

## 功能

- 使用火山引擎官方 SDK 查询账单信息
- 提取本月消费总金额、已支付和待支付金额
- 显示消费明细（按产品分类）
- 记录到日志文件（默认 `~/.openclaw/workspace/volcengine_balance.log`）
- 可选：通过飞书发送消息

## 环境变量（统一放 secrets.sh，敏感信息不进仓库）

脚本启动时若环境变量未设置，会 source `~/github/my_dot_files/secrets.sh`（可用 `SECRETS_FILE` 改路径）。完整占位见 `secrets.example.sh`。

| 变量 | 必填 | 说明 |
|------|------|------|
| `VOLC_ACCESS_KEY` | 是 | 火山引擎 Access Key |
| `VOLC_SECRET_KEY` | 是 | 火山引擎 Secret Key |
| `VOLC_REGION` | 否 | 区域，默认 `cn-beijing` |
| `VOLC_WORKSPACE_PATH` | 否 | 日志输出路径，默认 `~/.openclaw/workspace` |
| `FEISHU_RECEIVER_ID` | 否 | 飞书接收者 ID，不填则不发送飞书消息 |

## 故障排除

- **SDK 导入失败**：`source venv/bin/activate && pip install volcengine`
- **API 调用失败**：检查 `~/github/my_dot_files/secrets.sh` 中的 Access Key / Secret Key 是否正确。