第15章实战：个人全能 AI 助手

一句话：从零搭建一个个人 AI 助手——能管邮件、管日程、管购物、管代码，在任何聊天平台随叫随到。

15.1 完整配置示例

{
  $schema: "https://openclaw.dev/schema/config.json",

  env: { $include: "./env.json5" },

  gateway: {
    port: 18789,
    bind: "loopback",
    reload: { mode: "hybrid" },
  },

  agents: {
    defaults: {
      workspace: "~/.openclaw/workspace",
      model: {
        primary: "deepseek/deepseek-v3.2",
        fallbacks: ["minimax/MiniMax-M2.5"],
      },
      models: {
        "deepseek/deepseek-v3.2": { alias: "DeepSeek" },
        "minimax/MiniMax-M2.5": { alias: "MiniMax" },
        // "minimax/MiniMax-M2.7": { alias: "M2.7" },  // M2.7 需额外 provider 配置，见第 8 章
        "moonshot/kimi-k2.5": { alias: "Kimi" },
      },
      imageMaxDimensionPx: 1200,
      heartbeat: {
        every: "30m",
        target: "last",
        lightContext: true,
        activeHours: {
          start: "08:00",
          end: "23:00",
          timezone: "Asia/Shanghai",
        },
      },
    },
    list: [
      { id: "main", default: true },
    ],
  },

  session: {
    dmScope: "per-channel-peer",
  },

  channels: {
    telegram: {
      enabled: true,
      botToken: "${TELEGRAM_BOT_TOKEN}",
      proxy: "socks5://127.0.0.1:1080",
    },
  },

  models: {
    providers: {
      deepseek: {
        baseUrl: "https://api.deepseek.com/v1",
        api: "openai-completions",
      },
    },
  },

  cron: {
    enabled: true,
  },
}

然后通过 CLI 创建定时任务：

openclaw cron add \
  --name "晨间简报" \
  --cron "0 8 * * *" \
  --message "Morning Brief：请检查今天的天气、日历、待办事项，生成早间简报发送给我。" \
  --announce --channel telegram

15.2 工作区文件

SOUL.md

# Soul

## 身份
你叫小克（Claw），是小明的个人 AI 助手。

## 性格
- 高效务实，不说废话
- 用简洁的中文回复
- 技术话题可以深入，日常话题保持轻松
- 主动提醒，但不打扰

## 语言
- 默认中文，技术术语英文
- 代码注释用中文

## 行为边界
- 涉及金钱操作时，先确认再执行
- 不分享主人的隐私信息
- 遇到安全风险时主动警告

AGENTS.md

# Operating Instructions

## 核心职责
你是小明的全能个人助手，负责：
- 开发辅助（代码审查、Bug 排查、架构讨论）
- 日程管理（提醒、会议安排）
- 信息整理（邮件摘要、新闻速读）
- 生活事务（购物、预订、查询）

## 工具使用
- 浏览器：搜索信息、访问网页
- 文件系统：读写本地文件
- 命令执行：在服务器上运行命令
- 记忆系统：记录重要信息

## 工作流程
1. 理解请求 → 确认理解正确
2. 选择工具 → 执行任务
3. 汇报结果 → 等待反馈
4. 记录要点 → 写入记忆

## 记忆笔记
（Agent 会自动在这里追加重要信息）

USER.md

# User Profile

- 名字：小明
- 职业：全栈开发者，独立开发
- 技术栈：TypeScript, Python, Go
- 时区：Asia/Shanghai (UTC+8)
- 起床时间：08:00
- 常用工具：VS Code, GitHub, Notion
- 偏好：简洁代码，讨厌过度抽象

15.3 Morning Brief 自动化

通过 Cron 实现每天早上自动推送简报：

# 通过 CLI 创建早间简报任务
openclaw cron add \
  --name "早间简报" \
  --cron "0 8 * * *" \
  --message "生成今日早间简报：1) 今天上海天气 2) 检查 memory/ 中的待办提醒 3) 科技新闻 Top 3" \
  --announce --channel telegram

Agent 收到这个 Cron 消息后，会：

调用 web_search 查询天气
调用 memory_search 检查待办提醒
调用 web_search 搜索科技新闻
整理成摘要发送到 Telegram

15.4 邮件检查 + 1Password 集成

Agent 可以帮你检查邮件并从 1Password 获取凭证：

你: 帮我检查今天有没有重要邮件
Agent: [浏览器登录邮箱] → 你今天有 3 封重要邮件...

1Password CLI 集成（需要在 TOOLS.md 中说明用法）：

## 1Password
通过 `op` CLI 获取凭证。格式：
- `system.run("op item get <item-name> --fields password")`
- 获取凭证前需要用户确认

15.5 手机语音控制服务器

通过 Node 的 Voice 能力 + Talk Mode，实现语音控制服务器：

你（语音）: 查一下服务器 CPU 使用率
Agent: [system.run: "top -bn1 | head -5"] → CPU 使用率 32%，内存使用 4.2GB / 8GB

真实案例复现——遛狗修 Bug：

手机收到报警推送
在 Telegram 语音告诉 Agent：“查看一下生产环境日志最后 50 行”
Agent 通过 Node 执行命令，发回日志
语音指示：“把第 42 行的超时时间从 5 秒改成 30 秒”
Agent 修改文件并重新部署
全程 5 分钟，手没离开狗绳

15.6 Git 备份工作区

推荐将 workspace 纳入 Git 管理：

cd ~/.openclaw/workspace
git init
cat > .gitignore << 'EOF'
*.tmp
*.log
node_modules/
EOF
git add -A
git commit -m "initial workspace"

# 可选：推送到私有仓库
git remote add origin git@github.com:yourname/openclaw-workspace.git
git push -u origin main

配合 Cron 自动备份：

openclaw cron add \
  --name "每日备份" \
  --cron "0 0 * * *" \
  --session isolated \
  --message "请执行 workspace 的 git 备份：git add -A && git commit -m 'daily backup' && git push" \
  --no-deliver

15.7 小结

本章搭建了一个完整的个人 AI 助手，包括：

功能	实现方式
多模型	DeepSeek 为主，MiniMax 备选
人格设定	SOUL.md + AGENTS.md + USER.md
早间简报	Cron 定时 + web_search
邮件管理	浏览器 + 1Password CLI
语音控制	Node Voice + Talk Mode
自动备份	Cron + Git

下一章搭建一个内容运营 Bot。

第15章 实战：个人全能 AI 助手