【AI Agent开发实战】Day6——AI Agent实战：搭建你的第一个AI助手（收官之作）

用户 → 对话界面 → OpenClaw Agent → 大模型
↓
Skill调用
↓
文件系统 / 日历 / 搜索

mkdir -p ~/.openclaw/workspace/my-assistant
mkdir -p ~/.openclaw/workspace/my-assistant/skills
mkdir -p ~/.openclaw/workspace/my-assistant/knowledge
mkdir -p ~/.openclaw/workspace/my-assistant/logs

{
"name": "my-assistant",
"description": "个人AI助手，帮主处理信息、管理知识、提供即时问答服务",
"model": "minimax-portal/MiniMax-M2.7",
"language": "zh",
"timezone": "Asia/Shanghai",

"skills": {
"builtin": ["search", "calculator"],
"custom": [
"~/.openclaw/workspace/my-assistant/skills/file-skill",
"~/.openclaw/workspace/my-assistant/skills/summarize-skill",
"~/.openclaw/workspace/my-assistant/skills/email-skill"
]
},

"memory": {
"enabled": true,
"type": "file",
"path": "~/.openclaw/workspace/my-assistant/memory.json"
},

"workspace": "~/.openclaw/workspace/my-assistant",

"limits": {
"maxTokens": 4000,
"timeout": 60
}
}

{
agents: {
entries: {
"my-assistant": {
type: "agent",
configPath: "~/.openclaw/workspace/my-assistant/agent.json"
}
}
}
}

openclaw start my-assistant

[OpenClaw] Starting agent: my-assistant
[OpenClaw] Model loaded: minimax-portal/MiniMax-M2.7
[OpenClaw] Skills loaded: 5
[OpenClaw] Memory initialized
[OpenClaw] Agent ready at http://127.0.0.1:18789

mkdir -p ~/.openclaw/workspace/my-assistant/skills/file-skill/scripts

# File Skill – 文件处理技能

## 技能简介

文件处理Skill帮助Agent读取、搜索、处理本地文件。

## 功能列表

1. **read_file**：读取文件内容
2. **list_files**：列出目录文件
3. **search_content**：在文件中搜索关键词
4. **get_file_info**：获取文件信息

## 使用场景

– 用户要求读取某个文件
– 用户询问目录下有哪些文件
– 用户需要在文件中搜索特定内容
– 用户想知道文件大小、修改时间等信息

## 使用示例

用户："帮我看看 ~/documents/readme.txt 的内容"
Agent调用：read_file, {"path": "~/documents/readme.txt"}

用户："~/projects 目录下有什么文件？"
Agent调用：list_files, {"path": "~/projects"}

用户："在 ~/notes 目录下搜索'会议纪要'"
Agent调用：search_content, {"path": "~/notes", "keyword": "会议纪要"}

## 参数说明

| 参数 | 类型 | 必填 | 说明 |
|——|——|——|——|
| path | string | 是 | 文件路径 |
| keyword | string | search_content时必填 | 搜索关键词 |

## 输出格式

标准JSON格式，包含执行结果或错误信息。

#!/usr/bin/env python3
import os
import json
import re
from datetime import datetime

def read_file(path):
"""读取文件内容"""
try:
path = os.path.expanduser(path)
if not os.path.exists(path):
return {"success": False, "error": "文件不存在"}

if not os.path.isfile(path):
return {"success": False, "error": "路径不是文件"}

with open(path, 'r', encoding='utf-8') as f:
content = f.read()

return {
"success": True,
"path": path,
"content": content,
"size": os.path.getsize(path),
"modified": datetime.fromtimestamp(os.path.getmtime(path)).isoformat()
}
except Exception as e:
return {"success": False, "error": str(e)}

def list_files(path):
"""列出目录文件"""
try:
path = os.path.expanduser(path)
if not os.path.exists(path):
return {"success": False, "error": "目录不存在"}

if not os.path.isdir(path):
return {"success": False, "error": "路径不是目录"}

files = []
for item in os.listdir(path):
item_path = os.path.join(path, item)
files.append({
"name": item,
"type": "dir" if os.path.isdir(item_path) else "file",
"size": os.path.getsize(item_path) if os.path.isfile(item_path) else 0
})

return {
"success": True,
"path": path,
"files": files,
"count": len(files)
}
except Exception as e:
return {"success": False, "error": str(e)}

def search_content(path, keyword):
"""在文件中搜索关键词"""
try:
path = os.path.expanduser(path)
if not os.path.exists(path):
return {"success": False, "error": "路径不存在"}

results = []
pattern = re.compile(keyword, re.IGNORECASE)

if os.path.isfile(path):
with open(path, 'r', encoding='utf-8') as f:
for i, line in enumerate(f, 1):
if pattern.search(line):
results.append({
"file": path,
"line": i,
"content": line.strip()
})
else:
for root, dirs, files in os.walk(path):
for file in files:
file_path = os.path.join(root, file)
try:
with open(file_path, 'r', encoding='utf-8') as f:
for i, line in enumerate(f, 1):
if pattern.search(line):
results.append({
"file": file_path,
"line": i,
"content": line.strip()
})
except:
continue

return {
"success": True,
"keyword": keyword,
"results": results,
"count": len(results)
}
except Exception as e:
return {"success": False, "error": str(e)}

def get_file_info(path):
"""获取文件信息"""
try:
path = os.path.expanduser(path)
if not os.path.exists(path):
return {"success": False, "error": "文件不存在"}

stat = os.stat(path)
return {
"success": True,
"path": path,
"size": stat.st_size,
"created": datetime.fromtimestamp(stat.st_ctime).isoformat(),
"modified": datetime.fromtimestamp(stat.st_mtime).isoformat(),
"is_file": os.path.isfile(path),
"is_dir": os.path.isdir(path)
}
except Exception as e:
return {"success": False, "error": str(e)}

if __name__ == "__main__":
import sys
action = sys.argv[1] if len(sys.argv) > 1 else None

if action == "read_file":
result = read_file(sys.argv[2] if len(sys.argv) > 2 else "")
elif action == "list_files":
result = list_files(sys.argv[2] if len(sys.argv) > 2 else "")
elif action == "search_content":
result = search_content(sys.argv[2] if len(sys.argv) > 2 else "",
sys.argv[3] if len(sys.argv) > 3 else "")
elif action == "get_file_info":
result = get_file_info(sys.argv[2] if len(sys.argv) > 2 else "")
else:
result = {"success": False, "error": "未知操作"}

print(json.dumps(result, ensure_ascii=False))

mkdir -p ~/.openclaw/workspace/my-assistant/skills/summarize-skill/scripts

# Summarize Skill – 文档摘要技能

## 技能简介

文档摘要Skill帮助Agent读取长文档并生成简洁摘要。

## 功能列表

1. **summarize_text**：对文本内容生成摘要
2. **summarize_file**：对文件生成摘要

## 使用场景

– 用户上传了一份文档，希望了解主要内容
– 用户需要将长文章缩写成短文
– 用户希望提取文档的关键点

## 使用示例

用户："帮我总结一下这篇文档的主要内容"
Agent调用：summarize_text, {"text": "用户提供的文本"}

用户："这个PDF文件讲了什么？"
Agent调用：summarize_file, {"path": "~/documents/report.pdf"}

## 参数说明

| 参数 | 类型 | 必填 | 说明 |
|——|——|——|——|
| text | string | summarize_text时必填 | 要摘要的文本 |
| path | string | summarize_file时必填 | 文件路径 |
| max_length | int | 否 | 摘要最大长度（字符数） |

#!/usr/bin/env python3
import os
import json
import sys

def summarize_text(text, max_length=200):
"""生成文本摘要"""
if not text or len(text.strip()) == 0:
return {"success": False, "error": "文本为空"}

# 简单摘要策略：取前3段，每段取前两句话
lines = text.split('\n')
paragraphs = [p.strip() for p in lines if p.strip()]

summary_parts = []
for para in paragraphs[:3]:
para_lines = para.split('。')
for line in para_lines[:2]:
if line.strip():
summary_parts.append(line.strip())

summary = '。'.join(summary_parts)

if len(summary) > max_length:
summary = summary[:max_length] + '…'
else:
summary += '。'

return {
"success": True,
"original_length": len(text),
"summary_length": len(summary),
"summary": summary
}

def summarize_file(path, max_length=200):
"""生成文件摘要"""
try:
path = os.path.expanduser(path)
if not os.path.exists(path):
return {"success": False, "error": "文件不存在"}

# 根据文件类型读取
ext = os.path.splitext(path)[1].lower()

if ext in ['.txt', '.md', '.json', '.xml', '.py', '.js', '.html', '.css']:
with open(path, 'r', encoding='utf-8') as f:
content = f.read()
elif ext in ['.pdf', '.doc', '.docx']:
return {"success": False, "error": "不支持的格式，请使用txt或md文件"}
else:
return {"success": False, "error": f"未知的文件类型: {ext}"}

return summarize_text(content, max_length)

except Exception as e:
return {"success": False, "error": str(e)}

if __name__ == "__main__":
action = sys.argv[1] if len(sys.argv) > 1 else None

if action == "summarize_text":
text = sys.stdin.read() if len(sys.argv) == 2 else sys.argv[2] if len(sys.argv) > 2 else ""
result = summarize_text(text)
elif action == "summarize_file":
result = summarize_file(sys.argv[2] if len(sys.argv) > 2 else "")
else:
result = {"success": False, "error": "未知操作"}

print(json.dumps(result, ensure_ascii=False))

mkdir -p ~/.openclaw/workspace/my-assistant/skills/email-skill/scripts

# Email Skill – 邮件助手技能

## 技能简介

邮件助手Skill帮助用户撰写邮件，提供邮件模板和优化建议。

## 功能列表

1. **draft_email**：根据简要信息起草邮件
2. **improve_email**：优化现有邮件内容
3. **email_template**：提供常用邮件模板

## 使用场景

– 用户需要写一封邮件但不知如何开始
– 用户写完邮件后希望优化表达
– 用户需要某种场景的邮件模板

## 使用示例

用户："帮我写一封请假邮件，明天请假一天"
Agent调用：draft_email, {"purpose": "请假", "details": "明天请假一天，因为身体不适"}

用户："帮我优化一下这封邮件：'经理你好，我想请假…'"
Agent调用：improve_email, {"content": "经理你好，我想请假…"}

用户："给我一个会议邀请的模板"
Agent调用：email_template, {"type": "meeting_invitation"}

## 参数说明

| 参数 | 类型 | 必填 | 说明 |
|——|——|——|——|
| purpose | string | draft_email时必填 | 邮件目的 |
| details | string | 否 | 邮件详情 |
| content | string | improve_email时必填 | 要优化的邮件内容 |
| type | string | email_template时必填 | 模板类型 |

## 模板类型

– meeting_invitation：会议邀请
– sick_leave：病假申请
– resignation：离职申请
– thank_you：感谢邮件
– apology：道歉邮件
– follow_up：跟进邮件

#!/usr/bin/env python3
import json
import sys

TEMPLATES = {
"meeting_invitation": {
"subject": "会议邀请：{topic}",
"body": """尊敬的{recipient}：

您好！

诚邀您参加以下会议：

【会议主题】{topic}
【会议时间】{time}
【会议地点】{location}
【会议内容】{content}

请确认是否能出席。如有疑问，请联系我。

此致
敬礼

{sender}
{date}"""
},
"sick_leave": {
"subject": "请假申请：{date}请假",
"body": """尊敬的{manager}：

您好！

因身体不适，我申请在{date}请假{days}天。

请假原因：{reason}

我已经将手头工作交接给{backup}，确保工作不受影响。

恳请批准。

此致
敬礼

{employee}
{date}"""
},
"thank_you": {
"subject": "感谢",
"body": """尊敬的{recipient}：

您好！

感谢您{reason}。您的帮助对我来说非常重要。

我会继续努力，不辜负您的信任。

再次感谢！

此致
敬礼

{sender}
{date}"""
}
}

def draft_email(purpose, details="", recipient="", sender="我"):
"""起草邮件"""
date = "2026年5月23日"

templates = {
"请假": f"尊敬的领导：\n\n您好！\n\n因{details}，申请请假。\n\n请批准。\n\n此致\n敬礼\n\n{sender}\n{date}",
"感谢": f"尊敬的{recipient}：\n\n您好！\n\n感谢您{details}。\n\n此致\n敬礼\n\n{sender}\n{date}",
"会议邀请": f"尊敬的{recipient}：\n\n您好！\n\n诚邀您参加会议：{details}\n\n请确认是否能出席。\n\n此致\n敬礼\n\n{sender}\n{date}",
}

body = templates.get(purpose, f"尊敬的{recipient}：\n\n您好！\n\n{details}\n\n此致\n敬礼\n\n{sender}\n{date}")

return {
"success": True,
"purpose": purpose,
"draft": body
}

def improve_email(content):
"""优化邮件"""
improvements = []

if len(content) < 20:
improvements.append("邮件内容过短，建议补充更多细节")

if "你好" in content and "您好" not in content:
improvements.append("建议将'你好'改为'您好'，更正式")

if not content.endswith(("此致", "敬礼")):
improvements.append("建议添加结尾祝福语")

improved = content
if "你好" in improved:
improved = improved.replace("你好", "您好")

return {
"success": True,
"original": content,
"improved": improved,
"suggestions": improvements
}

def email_template(template_type):
"""获取邮件模板"""
if template_type in TEMPLATES:
return {
"success": True,
"type": template_type,
"template": TEMPLATES[template_type]
}
else:
return {
"success": False,
"error": f"未知模板类型: {template_type}",
"available": list(TEMPLATES.keys())
}

if __name__ == "__main__":
action = sys.argv[1] if len(sys.argv) > 1 else None

if action == "draft_email":
result = draft_email(
sys.argv[2] if len(sys.argv) > 2 else "",
sys.argv[3] if len(sys.argv) > 3 else ""
)
elif action == "improve_email":
content = sys.stdin.read() if len(sys.argv) == 2 else sys.argv[2] if len(sys.argv) > 2 else ""
result = improve_email(content)
elif action == "email_template":
result = email_template(sys.argv[2] if len(sys.argv) > 2 else "")
else:
result = {"success": False, "error": "未知操作"}

print(json.dumps(result, ensure_ascii=False))

{
skills: {
entries: {
"file-skill": {
path: "~/.openclaw/workspace/my-assistant/skills/file-skill",
enabled: true
},
"summarize-skill": {
path: "~/.openclaw/workspace/my-assistant/skills/summarize-skill",
enabled: true
},
"email-skill": {
path: "~/.openclaw/workspace/my-assistant/skills/email-skill",
enabled: true
}
}
}
}

openclaw start my-assistant

用户：2026年AI市场趋势是什么？
Agent：正在联网搜索…
（搜索Skill返回结果）
（结合搜索结果回答）

用户：帮我看看 ~/documents/notes.txt 的内容
Agent：正在读取文件…
（调用file-skill的read_file）
（返回文件内容）

用户：帮我总结一下这篇文档
Agent：正在生成摘要…
（调用summarize-skill的summarize_file）
（返回摘要结果）

用户：帮我写一封请假邮件，明天请假一天
Agent：正在起草邮件…
（调用email-skill的draft_email）
（返回邮件草稿）

{
"logging": {
"enabled": true,
"level": "debug",
"file": "~/.openclaw/workspace/my-assistant/logs/assistant.log"
}
}

tail -f ~/.openclaw/workspace/my-assistant/logs/assistant.log

cd ~/.openclaw/workspace
tar -czf my-assistant-backup.tar.gz my-assistant/

[Unit]
Description=OpenClaw Personal Assistant
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/root/.openclaw/workspace
ExecStart=/usr/bin/openclaw start my-assistant
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

systemctl enable openclaw-assistant
systemctl start openclaw-assistant

server {
listen 443 ssl;
server_name assistant.example.com;

ssl_certificate /path/to/cert.pem;
ssl_certificate_key /path/to/key.pem;

location / {
proxy_pass http://127.0.0.1:18789;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}

# 更新单个技能
openclaw skills update file-skill

# 重启Agent
openclaw restart my-assistant

# 定期备份记忆数据
cp ~/.openclaw/workspace/my-assistant/memory.json ~/.openclaw/workspace/my-assistant/memory.json.bak

{
"auth": {
"type": "oauth",
"provider": "google",
"clientId": "your-client-id",
"redirectUri": "http://localhost:18789/callback"
}
}

{
"webhook": {
"enabled": true,
"url": "https://your-webhook-server.com/notify",
"events": ["agent.error", "agent.start", "skill.invoked"]
}
}

{
"i18n": {
"default": "zh",
"supported": ["zh", "en", "ja"],
"fallback": "en"
}
}