# TOOLS.md - 环境配置备注

## 飞书应用配置

### Bot 凭证
- **应用名称：** 小编（xiaobian）
- **App ID：** cli_a9311be796f85cbd
- **凭证位置：** `/root/.openclaw/credentials/xiaobian/config.json`
- **权限范围：** 消息收发、知识库读取、文档读写、电子表格读写
- **Bot身份调用方式：** `LARKSUITE_CLI_CONFIG_DIR=/root/.openclaw/credentials/xiaobian lark-cli <command> --as bot`

### 辅助凭证（读取知识库用）
- **应用名称：** 小研（xiaoyan）
- **App ID：** cli_a931175d41799cc7
- **凭证位置：** `/root/.openclaw/credentials/xiaoyan/config.json`
- **用途：** 知识库文档读取（部分知识空间仅对小研授权）

### 飞书CLI版本
- **lark-cli：** v1.0.27
- **官方Skills位置：** `~/.openclaw/workspace-xiaobian/.agents/skills/lark-*`（24个官方技能）

## 飞书电子表格读取

直接通过飞书 Sheets V2 API + Bot身份的 `tenant_access_token` 调用：
```bash
# 获取token
APP_ID=$(jq -r '.apps[0].appId' /root/.openclaw/credentials/xiaoyan/config.json)
APP_SECRET=$(jq -r '.apps[0].appSecret' /root/.openclaw/credentials/xiaoyan/config.json)
TOKEN=$(curl -s -X POST "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal" \
  -H "Content-Type: application/json" \
  -d "{\"app_id\":\"$APP_ID\",\"app_secret\":\"$APP_SECRET\"}" | jq -r '.tenant_access_token')

# 获取表格元数据
curl -s "https://open.feishu.cn/open-apis/sheets/v2/spreadsheets/<TOKEN>/metainfo" -H "Authorization: Bearer $TOKEN"

# 读取数据
curl -s "https://open.feishu.cn/open-apis/sheets/v2/spreadsheets/<TOKEN>/values/<sheetId>!A1:Z50" -H "Authorization: Bearer $TOKEN"
```

## Office 文档处理

- **工具：** office-document-specialist-suite（skills/office-document-specialist-suite/）
- **依赖：** python-docx 1.2.0, openpyxl 3.1.5, python-pptx 1.0.2
- **虚拟环境：** `skills/office-document-specialist-suite/.venv/`
- **激活方式：** `source skills/office-document-specialist-suite/.venv/bin/activate`

## 密钥存储

- **位置：** `/root/.openclaw/workspace-xiaobian/secrets.md`
- **规则：** 所有密钥/Token仅存于此文件，禁止在其他文件中出现

## 安全提示

- 所有飞书操作使用Bot身份，禁止触发用户授权
- 数据库操作默认只读
- 外部API密钥管理由技术负责人负责
