OpenClaw新手指南：本地跑起来，真能干活的AI智能体

你试过让AI回邮件、查航班、改日程，结果卡在“API密钥申请失败”“响应慢得像等外卖”“操作记录全在别人服务器上”？OpenClaw不是又一个聊天框——它是一个能在你电脑上自己动手做事的AI小助手。

问题

传统大模型应用（比如网页版ChatGPT）本质是“问答机”：你问，它答，答完就结束。它不能主动发邮件，不能读你本地Outlook日历，更没法在微信里提醒你“明早9点会议，材料已整理好”。企业级自动化工具（如Zapier）又依赖云服务、要连外部API、数据不落地——对隐私敏感或网络受限的用户很不友好。

方案

OpenClaw 是国产开源的轻量级AI智能体框架，核心是 RAG（本地知识检索）+ Agent（任务规划与执行）双引擎：

• RAG 让它“懂你”：你扔进几份PDF合同、邮箱导出的CSV、微信聊天截图，它立刻记住，不上传、不联网也能精准引用；
• Agent 让它“做事”：把“查今天飞北京的航班”拆解为「调用本地航班数据库→过滤时间→生成摘要→用微信发给你」，每步都可追踪、可修改、可重放。

最关键的是：全程离线运行，不需OpenAI/千问/文心密钥，所有代码、数据、日志都在你机器上。

步骤：3分钟跑通第一个任务（自动整理收件箱）

1. 安装（Windows/macOS/Linux通用）

# 确保已安装Python 3.9+
python -m venv openclaw-env
source openclaw-env/bin/activate  # macOS/Linux
# 或 openclaw-env\Scripts\activate.bat  # Windows
pip install openclaw

为什么用虚拟环境？ 避免和你其他Python项目冲突，删掉整个openclaw-env文件夹就能干净卸载。

2. 启动并加载你的邮箱数据

# 创建配置目录，放入你的邮件导出文件（如outlook导出的mails.csv）
mkdir -p ~/.openclaw/data
cp ~/Downloads/mails.csv ~/.openclaw/data/

# 启动本地服务（默认端口8000）
openclaw serve

为什么用CSV？ 不需要连接邮箱服务器，导出一次即可，隐私完全自主。OpenClaw内置解析器能识别发件人、主题、日期、正文。

3. 发送指令（用浏览器访问 http://localhost:8000）

在Web界面输入：

“把过去7天标记为‘重要’且含‘合同’的邮件，按发件人分组，生成摘要发给我”

几秒后，你看到结构化结果：

【腾讯法务部】2封 → 关键词：盖章、扫描件、3月25日前  
【阿里采购部】1封 → 关键词：PO号ALI-2024-772，附件缺失  

这不是幻觉输出：每条结论都标注了来源行号（如 mails.csv:row=142），点击可跳转原始邮件。

验证：三件事立刻确认是否真生效

✅ 打开 ~/.openclaw/logs/ 查看完整执行链（谁触发、调了哪个函数、输入/输出是什么）
✅ 修改 ~/.openclaw/config.yaml 中 im_protocol: wechat，重启后消息自动走微信PC版（需扫码授权）
✅ 把航班信息存成 flights.json 放进 data/ 目录，再问“明天CA123有没有延误”，它直接查本地JSON，不调任何第三方接口

常见问题

Q：能连企业微信/钉钉吗？
A：支持。只需在 config.yaml 中填入对应SDK的AppID和Secret（官方提供傻瓜式配置向导）。Telegram/WhatsApp同理，文档有逐行截图。

Q：没有编程基础，能加自己的技能吗？
A：能。比如想让AI自动归档发票PDF，只需写一个5行Python函数（示例见 skills/invoice_sorter.py），放进 ~/.openclaw/skills/，重启即生效。

Q：Mac M系列芯片跑得动吗？
A：实测M1 Pro 16GB内存下，RAG检索10万字PDF+执行邮件分析，平均响应1.8秒。比调云端API还快。

下一步

你现在已掌握OpenClaw的核心能力：本地知识+自主动作+可审计链路。接下来建议：

• ✅ 《Skills技能开发入门》：30分钟学会给AI添加“自动填报销单”“同步飞书日历”等新能力
• ✅ 《AutoClaw部署实战》：把OpenClaw打包成Windows一键安装包，给父母用
• ✅ 《RAG原理图解》：不用公式，用快递分拣站类比，搞懂为什么本地检索比联网搜索更准

OpenClaw不追求“更聪明”，只解决一个问题：让AI的每一次输出，都对应一次真实世界里的动作。你的电脑，就是它的办公室。