← 返回 Skills 市场
alimail
作者
Colin-megan
· GitHub ↗
· v1.0.6
· MIT-0
337
总下载
0
收藏
2
当前安装
6
版本数
在 OpenClaw 中安装
/install alimail
功能描述
快速查询企业内部员工邮箱、工号及部门信息。
使用说明 (SKILL.md)
\r \r
Configuration\r
\r
Configure in ~/.openclaw/openclaw.json:\r
\r
{\r
"skills": {\r
"entries": {\r
"alimail": {\r
"enabled": true,\r
"env": {\r
"ALIMAIL_CLIENT_ID": "your_CLIENT_ID",\r
"ALIMAIL_CLIENT_SECRET": "your_CLIENT_SECRET"\r
}\r
}\r
}\r
}\r
}\r
```\r
\r
\r
## Core Features\r
* **Precise Lookup**: Enter a name to retrieve the full email address.\r
* **Fuzzy Search**: Supports partial name searches, automatically handling `(name=*xxx)` logic.\r
* **Detailed Information**: Returns employee ID (`employeeNo`), email (`email`), and name (`name`).\r
\r
## User Guide\r
\r
AI automatically recognizes and searches for names mentioned by users. For example:\r
- “查一下张三的邮箱”\r
\r
## Agent instructions\r
\r
**SearchAlimailUser**:Run the script under workspace (do not use the path under node_modules):\r
```bash\r
python3 ~/.openclaw/workspace/skills/alimail/main.py "张三"\r
```\r
\r
## Output Examples\r
**error result1:**\r
```json\r
{"status": "error", "message": "Parameter 'name' is required"}\r
```\r
**error result:**\r
```json\r
{"status": "api_failed", "details": "403 Client Error: Forbidden for url: "}\r
```\r
**error result:**\r
```json\r
{\r
"users": [\r
{\r
"name": "总部IT开发-张三",\r
"email": "[email protected]",\r
"employeeNo": "zhangsan"\r
}\r
],\r
"total": 1\r
}\r
```\r
## Privacy Statement\r
This skill only calls the query interface and does not have the permissions to read, delete, or send emails, ensuring the security of enterprise data.
安全使用建议
This skill appears to do exactly what it says: authenticate with AliMail and query user records. Before installing, ensure you trust the source and supply valid ALIMAIL_CLIENT_ID and ALIMAIL_CLIENT_SECRET for a service account with only the needed query permissions. Be aware the skill will read ~/.openclaw/openclaw.json as a fallback for credentials — if you store secrets there, they are accessible to any code that reads that file. Test with least-privilege credentials and verify network calls go to your organization's alimail endpoint. If you need stronger guarantees, review the main.py source and host a vetted copy in your environment.
功能分析
Type: OpenClaw Skill
Name: alimail
Version: 1.0.6
The skill is a legitimate tool for searching the Alibaba Mail enterprise directory using official API endpoints (alimail-cn.aliyuncs.com). It implements a standard OAuth2 client credentials flow and includes a configuration fallback mechanism that reads specific keys from the local OpenClaw configuration file (~/.openclaw/openclaw.json). No evidence of data exfiltration, malicious execution, or harmful prompt injection was found in main.py or SKILL.md.
能力评估
Purpose & Capability
Name/description request access to ALIMAIL_CLIENT_ID and ALIMAIL_CLIENT_SECRET which is expected for OAuth2 API access to an AliMail user query endpoint. The included code calls alimail-cn.aliyuncs.com and returns email/employeeNo/name as promised.
Instruction Scope
SKILL.md and main.py limit behavior to authenticating and calling the AliMail user query API. The only non-API file access is an optional read of ~/.openclaw/openclaw.json to load credentials when environment variables are missing; otherwise the agent is not instructed to read or transmit unrelated files or data.
Install Mechanism
No install spec. The skill is instruction/code-only and only depends on the well-known requests package declared in requirements.txt. Nothing is downloaded from third-party URLs or written to system locations.
Credentials
Only two environment variables are required (ALIMAIL_CLIENT_ID and ALIMAIL_CLIENT_SECRET), which are appropriate for client_credentials OAuth2 flow. The code may also read those values from ~/.openclaw/openclaw.json as a fallback — this is reasonable but means the file can contain the same secrets.
Persistence & Privilege
The skill does not request always:true and does not modify other skills or system-wide settings. It only reads (not writes) the user's OpenClaw config as a fallback and sets process env for its own run.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install alimail - 安装完成后,直接呼叫该 Skill 的名称或使用
/alimail触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.6
- Added a metadata section specifying required environment variables for improved clarity and integration.
- No changes were made to the core functionality or configuration steps.
v1.0.5
- Added detailed configuration instructions for enabling and setting up the skill in `~/.openclaw/openclaw.json`.
- Clarified agent instructions, including the exact command for running the script in the workspace.
- Included output examples to illustrate API responses and error cases.
- Expanded and clarified sections on core features, user guide, and privacy statement.
v1.0.4
- Updated author to Colin.
- Removed permissions and category fields.
- Simplified description of API usage in documentation.
- No changes to code functionality.
v1.0.3
- Skill name changed from "AliMail Assistant" to "alimail".
- Version updated to 1.0.3.
v1.0.2
- Added entrypoint: main.py to skill manifest.
- Updated info details to include "工号 (employeeNo)", "邮箱(email)", and "姓名(name)" in returned information.
- Revised example queries and usage guide for clarity and brevity.
v1.0.1
AliMail Assistant v1.0.1
- Added concise and clear description of the assistant's purpose and features.
- Clarified supported search modes (exact and fuzzy name search).
- Listed detailed returned information: email address, employee number, join date, and department ID.
- Included usage instructions and privacy notice to enhance user confidence.
元数据
常见问题
alimail 是什么?
快速查询企业内部员工邮箱、工号及部门信息。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 337 次。
如何安装 alimail?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install alimail」即可一键安装,无需额外配置。
alimail 是免费的吗?
是的,alimail 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
alimail 支持哪些平台?
alimail 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 alimail?
由 Colin-megan(@colin-megan)开发并维护,当前版本 v1.0.6。
推荐 Skills