夜雨聆风1.1 OpenClaw 是什么
OpenClaw 是一个运行在本地设备上的 AI Gateway，支持接入企业微信、Telegram、Discord 等多个消息平台，让 AI 助手可以通过这些平台与你对话。它像一个智能中转站，将 AI 的回复路由到不同的消息渠道。
1.2 核心优势
●多平台接入：一个 AI 对接多个聊天平台
●本地运行：数据留在本地，保护隐私
●插件扩展：支持插件系统，功能可自定义
●定时任务：支持 Cron 任务和心跳检查
●记忆系统：跨会话的持久化记忆
二、安装与基础配置
2.1 系统要求
2.2 安装步骤
# 一键安装（Linux/macOS）curl -fsSL https://get.openclaw.ai | bash# 或者通过 npm 安装npm install -g openclaw# 启动 Gatewayopenclaw gateway start# 查看状态openclaw status
2.3 企业微信插件安装
openclaw plugin install @wecom/wecom-openclaw-pluginopenclaw gateway restart
安装完成后，需在企业微信后台为机器人配置「发送消息」权限，才能让 AI 主动推送消息。
2.4 权限配置
OpenClaw 的工具权限通过配置文件管理：
# 查看当前工具权限模式openclaw config get tools.profile# 如需使用企业微信消息功能，需确保 wecom_mcp 在白名单中openclaw config get tools.alsoAllow# 返回应包含 "wecom_mcp"
三、内存与记忆系统
3.1 记忆文件说明
OpenClaw 通过文件管理 AI 的记忆，每个文件有不同的用途：
3.2 最佳实践
SOUL.md 写作建议：
●用自然对话风格，不要过于正式
●定义明确的性格特点（如：幽默、简洁、实用）
●可以包含具体的行为准则
MEMORY.md 维护建议：
●定期（每1-2天）将 daily notes 提炼到 MEMORY.md
●只记录重要的决策、偏好、事件
●删除过时信息，保持精简
HEARTBEAT.md 使用技巧：
●保持简短，避免 API 调用过于频繁
●用心跳做定期检查，而非精确定时
●精确定时用 Cron，灵活检查用心跳
3.3 示例：HEARTBEAT.md
## 定期任务### XXX帖子审核- 检查文件: /tmp/alert.txt- 如果包含内容，通过 wecom_mcp 发送给 YYY- 发送后清空告警文件
四、插件生态与使用
4.1 常用插件
4.2 技能（Skill）查找
访问 ClawHub 搜索可用技能，或通过 OpenClaw 内置的 available_skills 了解当前已安装的技能。
4.3 插件更新
# 更新所有插件openclaw plugin update# 更新单个插件openclaw plugin update @wecom/wecom-openclaw-plugin# 重启生效openclaw gateway restart
五、定时任务与自动化
5.1 Cron vs 心跳
5.2 Cron 使用示例
# 设置每5分钟检查一次*/5 * * * * /path/to/check.sh >> /var/log/check.log 2>&1
5.3 Sub-agent 延迟任务
对于一次性的延迟提醒，使用 Sub-agent 比 Cron 更灵活：
sessions_spawn(mode="run", runtime="subagent", task="Wait 5 minutes, then send message...")
5.4 自动提醒示例
场景：每5分钟检查XXX待审帖子，发现违规自动推送。
方案：
1. Cron 每5分钟运行检查脚本，结果写入文件
2. Sub-agent 监控文件，发现内容则推送消息
3. HEARTBEAT.md 作为兜底检查
六、企业微信功能使用
6.1 消息发送
wecom_mcp call msg send_message '{ "chat_type": 1, "chatid": "用户ID或LaoLuo", "msgtype": "text", "text": {"content": "提醒内容"}}'
6.2 待办管理
通过 wecom-edit-todo 技能创建、分配、更新待办事项：
●创建新待办
●更新待办内容
●标记完成
●变更处理人
6.3 日程管理
通过 wecom-schedule 技能：
●查询日程列表
●创建日程并设置提醒
●分析成员空闲时间
6.4 会议管理
通过 wecom-meeting-create 技能创建会议预约。
6.5 文档协作
通过 wecom-doc-manager 管理企业微信文档：
●创建新文档
●读取文档内容
●用 Markdown 编辑文档
七、安全最佳实践
7.1 基础安全
●定期更新 OpenClaw：openclaw update
●慎用 sudo：只在必要时提权，不要长期开放
●保护 Cookie：不要在聊天中发送密码或敏感凭证
●最小权限：tools.profile 尽量不用 full 模式
7.2 Cookie 与凭证处理
●Cookie 有效期有限，需要定期更新
●发现 Cookie 失效应立即通知用户
●敏感信息优先通过文件传递，而非聊天
7.3 硬件权限管理
部分硬件功能（如读取 MSR 功耗数据）需要 root 权限：
# 仅在需要时临时开放sudo chmod 666 /dev/cpu/*/msr# 使用完毕后记得撤销sudo chmod 660 /dev/cpu/*/msr
八、常见问题排查
8.1 机器人无响应
1. 检查 Gateway 状态：openclaw gateway status
2. 查看日志：tail -f ~/.openclaw/openclaw-*.log
3. 重启 Gateway：openclaw gateway restart
8.2 企业微信消息发送失败
1. 确认机器人已在企业微信后台开通「消息」权限
2. 检查 tools.alsoAllow 是否包含 wecom_mcp
3. 重启 Gateway 后再试
8.3 Cookie 失效
定期检查 Cookie 有效性，发现失效时：
●从浏览器导出新的 Cookie
●更新脚本中的 Cookie 配置
●通知管理员更换
8.4 定时任务不执行
1. 检查 Cron 是否正常运行：systemctl status cron
2. 查看 Cron 日志：grep CRON /var/log/syslog
3. 手动执行脚本确认无报错
九、高级技巧
9.1 多 Sub-agent 协作
复杂任务可拆分给多个 Sub-agent 并行处理：
# 并行执行多个检查sessions_spawn(label="check1", task="...")sessions_spawn(label="check2", task="...")sessions_spawn(label="check3", task="...")
9.2 跨会话消息
通过 sessions_send 向其他会话发送消息，实现跨会话协作。
9.3 记忆文件模板
SOUL.md 示例：
# SOUL.md- 性格：友好、幽默、务实- 回复风格：简洁明了，不过度客套- 专长：信息查询、自动化脚本、定时提醒
USER.md 示例：
# USER.md- 姓名：luo- 时区：Asia/Shanghai- 偏好：直接沟通，不喜欢废话- 常用功能：企业微信、定时提醒、帖子审核
十、参考资料
●官方文档：https://docs.openclaw.dev
●社区论坛：https://discord.com/invite/clawd
●插件市场：https://clawhub.com
●源码地址：https://github.com/openclaw/openclaw
有问题欢迎在 Discord 社区交流！
