← Back to Skills Marketplace
alimail
by
Colin-megan
· GitHub ↗
· v1.0.6
· MIT-0
337
Downloads
0
Stars
2
Active Installs
6
Versions
Install in OpenClaw
/install alimail
Description
快速查询企业内部员工邮箱、工号及部门信息。
README (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.
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install alimail - After installation, invoke the skill by name or use
/alimail - Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Frequently Asked Questions
What is alimail?
快速查询企业内部员工邮箱、工号及部门信息。 It is an AI Agent Skill for Claude Code / OpenClaw, with 337 downloads so far.
How do I install alimail?
Run "/install alimail" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is alimail free?
Yes, alimail is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does alimail support?
alimail is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created alimail?
It is built and maintained by Colin-megan (@colin-megan); the current version is v1.0.6.
More Skills