CSlawyer1985/legal-skillhub / skills/agent-email
agent-email
VerifiedAgent 专用邮箱统一管理:让 Claude Code、Codex 等平台的 Agent 用一套命令收发邮件、整理收件箱、分发任务。支持网易 ClawEmail(claw.163.com)和腾讯 Agent Mail(QQ 邮箱,agent.qq.com)两家后端,通过 MAIL_PROVIDER 切换。当用户提到收发邮件、看收件箱、搜索邮件、回复转发邮件、下载附件、整理邮件、给其他 Agent 派邮件任务、配置 Agent 邮箱、腾讯 QQ 邮箱 Agent、网易 ClawEmail 时使用此 skill。
| File | Kind | Size |
|---|---|---|
| CHANGELOG.md | markdown | 4.1 KB |
| LICENSE.txt | markdown | 1.1 KB |
| SKILL.md | skill md | 10.1 KB |
| _meta.json | config | 104 B |
| references/agently-cli-guide.md | markdown | 9.0 KB |
| references/agently-overview.md | markdown | 3.3 KB |
| references/agently-setup-guide.md | markdown | 2.7 KB |
| references/backends-install.md | markdown | 4.4 KB |
| references/clawemail-mail-cli-guide.md | markdown | 6.2 KB |
| references/clawemail-overview.md | markdown | 7.7 KB |
| references/clawemail-setup-guide.md | markdown | 2.8 KB |
| scripts/.env.example | other | 1.5 KB |
| scripts/mail-ops.sh | script | 17.8 KB |
| templates/reply-template.md | markdown | 522 B |
references/clawemail-setup-guide.md
View on GitHub# Agent Email — 网易 ClawEmail 首次配置指南
## 前提
- 已安装 Node.js 18+(macOS: `brew install node`)
- 已在 [claw.163.com](https://claw.163.com) 注册并创建 Agent 邮箱
- 已获取认证 URL(格式如 `t1/xxxxxx`,有效期 30 分钟)
- 已在 ClawEmail 后台配置**通信规则**(Agent 邮箱管理 → 通信规则),开放外部收发权限
## 方式一:一键配置(推荐)
```bash
source scripts/mail-ops.sh
claw_init "t1/你的认证URL" "你的显示名称"
```
`claw_init` 自动完成:
1. `curl` 解析认证 URL → 获取邮箱前缀和 API Key
2. `mail-cli auth apikey set` → 存储 API Key
3. `mail-cli auth login` → 创建默认 Profile
4. `mail-cli folder list` → 验证连通
5. 写入 `scripts/.env` → 保存配置(邮箱地址、显示名称、文件夹 ID)
完成后即可使用 `claw_send`、`claw_list` 等函数。
## 方式二:手动配置
### 1. 解析认证 URL
```bash
curl -sL "https://u.163.com/<你的认证URL>"
```
返回两行:
```
<邮箱前缀>:<account-id>:
__apikey__:workspace:ck_live_xxx
```
记录邮箱前缀和 `ck_live_xxx`(API Key)。
### 2. 存储 API Key
```bash
npx "@clawemail/mail-cli@latest" auth apikey set "ck_live_xxx"
```
### 3. 创建默认 Profile
```bash
npx "@clawemail/mail-cli@latest" auth login \
--user "<邮箱前缀>@claw.163.com" \
--auth-method password \
--password "ck_live_xxx"
```
### 4. 验证连通
```bash
npx "@clawemail/mail-cli@latest" folder list
npx "@clawemail/mail-cli@latest" mail list --fid 1 --limit 5
```
### 5. 写入 .env 配置
复制 `scripts/.env.example` 为 `scripts/.env`,填入实际值:
```env
AGENT_EMAIL=<邮箱前缀>@claw.163.com
DISPLAY_NAME="你的显示名称"
CLAW_PREFIX=<邮箱前缀>
CLAW_PROFILE=default
INBOX_FID=1
SENT_FID=3
```
`DISPLAY_NAME` 用于 `claw_send` 自动构造 `--from` 参数,控制对方收件箱里显示的发件人名称。
## 配置产物
| 文件 | 说明 |
|------|------|
| `~/.config/mail-cli/config.json` | mail-cli Profile 配置(用户名、显示名称) |
| `~/Library/Keychains/` 或系统密钥链 | API Key(由 `auth apikey set` 存储) |
| `scripts/.env` | Skill 内部配置备份(邮箱地址、文件夹 ID 等) |
## 常见问题
### claw_init 报错"认证 URL 无效或已过期"
认证 URL 有效期 30 分钟,过期后需从 ClawEmail 平台重新获取。
### Profile 已存在
如果之前配置过,`auth login` 会覆盖已有 Profile。如需保留,使用 `--profile <name>` 指定不同名称。
### 多邮箱管理
```bash
# 创建第二个 Profile
npx "@clawemail/mail-cli@latest" auth login \
--user "another@claw.163.com" --auth-method password --password "ck_live_xxx" \
--profile work
# 使用指定 Profile
mail-cli --profile work folder list
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |