OpenClaw 新手指南：构建你的个人AI工作流助理

用 OpenClaw 自动处理邮件、日程和航班提醒

你不需要等一个“完美”的 AI 助理上线。OpenClaw 是一个轻量级开源 Agent 框架，能直接跑在本地，理解自然语言指令，并通过 WhatsApp、Telegram 等常用聊天应用接收任务。它不依赖大模型 API 中转，所有指令解析和插件调度都在本地完成，隐私可控，响应快。

它和“龙虾”没有关系——名字只是项目代号，别被误导。

安装与运行

1. 环境准备

确保系统满足以下最低要求：

• 操作系统：Windows 10+、macOS 12+ 或主流 Linux 发行版（如 Ubuntu 20.04+）
• Python：3.8–3.11（推荐 3.10；3.12 尚未全面验证）
• 其他工具：Git（必须），Node.js（仅当启用前端插件或 Web UI 时需要）

# Ubuntu/Debian 示例
sudo apt update
sudo apt install -y python3.10 python3.10-venv python3-pip git

# 可选：Node.js（v16.x 或 v18.x）
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejs

macOS 用户建议用 pyenv 管理 Python 版本，避免系统 Python 冲突。
Windows 用户请使用 PowerShell（非 CMD），并确保 pip 调用的是 Python 3.10+。

2. 安装 OpenClaw

用 pip 安装稳定版：

pip install openclaw

如果你打算开发插件或调试源码，可以克隆仓库后安装：

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pip install -e .

3. 初始化配置

运行初始化命令，生成默认配置目录和 config.yaml：

openclaw init

然后编辑配置文件：

nano ~/.openclaw/config.yaml

关键字段说明：

llm:
  backend: ollama          # 支持 ollama / llama-cpp / transformers
  model: qwen2:7b          # 本地模型名（需提前用 ollama pull）

plugins:
  email: true              # 启用邮件插件（需 SMTP 配置）
  calendar: true           # 启用日历插件（支持 iCal 文件或 Google Calendar API）
  flight: true             # 启用航班提醒（基于 IATA 航班号 + 日期）

channels:
  telegram:
    enabled: true
    token: "YOUR_TELEGRAM_BOT_TOKEN"
  whatsapp:
    enabled: false         # WhatsApp 需额外配置 Twilio 或 360dialog

邮件插件示例（SMTP）：

email:
  smtp_host: smtp.gmail.com
  smtp_port: 587
  username: your@gmail.com
  password: "APP_PASSWORD_HERE"  # Gmail 需用应用专用密码
  from_address: your@gmail.com

4. 启动服务

openclaw start

服务启动后，会在后台运行。默认日志输出到 ~/.openclaw/logs/，出问题时先看 app.log。

提示：首次启动会自动下载并加载配置的 LLM（如 qwen2:7b），耗时取决于网络和磁盘速度。可另开终端执行 ollama list 观察进度。

5. 发送指令试试

服务就绪后，在已配置的 Telegram Bot 中发送以下任意指令：

• 发邮件
  发邮件给 alice@company.com，主题：周报提交提醒，内容：请今天下班前提交 Q3 周报。
• 加日程
  明天下午 3 点和张三视频会议，时长 45 分钟，日历备注：客户方案评审
• 设航班提醒
  提醒我 CA123 航班，2024-10-15 08:20 起飞，提前 2 小时通知

OpenClaw 会解析时间、联系人、航班号等实体，调用对应插件执行。成功后自动回复确认消息。

6. 快速验证

不用等真实场景，立刻验证三件事：

失败时，直接查 ~/.openclaw/logs/app.log，常见错误包括：

• SMTP 认证失败（检查密码是否为应用专用密码）
• Telegram token 无效（重新在 BotFather 获取）
• LLM 加载超时（确认 ollama serve 正在运行）

常见问题

OpenClaw 启动后不响应消息

• 检查 openclaw status 是否显示 running
• 查看 app.log 末尾是否有 Channel telegram started 类似日志
• 如果用 Telegram，确认 Bot 已在群组中被设为管理员（需 post messages 权限）

指令总是被忽略或解析错误

• OpenClaw 默认使用中文指令，但对句式敏感。避免嵌套从句，用直白主谓宾结构：

  • ✅ 把文档发给李四，附件是 report.pdf
  • ❌ 请将我昨天写的那份报告，就是带图表的那版，发给李四
• 模型太小（如 phi3:3.8b）可能导致实体识别不准。换 qwen2:7b 或 llama3:8b 通常更稳。

插件报错 “module not found”

• 运行 pip list | grep openclaw，确认插件包已安装（如 openclaw-email）
• 插件需单独安装：pip install openclaw-email openclaw-calendar
• 某些插件依赖系统库（如 libmagic），Ubuntu 上执行 sudo apt install libmagic1

下一步

• 修改 config.yaml 中的 llm.model，换用你本地跑得动的模型（Ollama 模型库 可查量化版本）
• 在 ~/.openclaw/plugins/ 下写一个 Python 文件，实现自定义插件（参考 email.py 结构）
• 关闭 channels.telegram.enabled，改用 channels.cli: true，直接在终端交互调试，跳过消息平台环节

OpenClaw 不是黑盒。它的核心逻辑就藏在 openclaw/agent/ 和各插件的 main.py 里——遇到问题，grep 一下比读文档更快。