乐于分享
好东西不私藏

OpenClaw 最佳实践指南

OpenClaw 最佳实践指南
一、认识 OpenClaw

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 社区交流!

相关学习资料