8e4ae93fe5
- Created memory file for OpenClaw version check with details on the latest version and update instructions. - Added memory file for Chrome DevTools MCP session, summarizing its features, installation, and usage examples. - Included memory file for OpenClaw update details, outlining the latest changes and improvements. - Added memory file for OpenCode version check, detailing the latest version and its features.
157 lines
5.2 KiB
Markdown
157 lines
5.2 KiB
Markdown
# MEMORY.md - 长期记忆
|
||
|
||
## 重要工作规则
|
||
|
||
### 修改 openclaw.json 前必须备份
|
||
|
||
在修改 `~/.openclaw/openclaw.json` 配置文件之前，必须先备份：
|
||
|
||
```bash
|
||
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup-$(date +%Y%m%d-%H%M%S)
|
||
```
|
||
|
||
### 修改操作前必须征得同意
|
||
|
||
在执行任何涉及修改性质的行为之前，必须：
|
||
1. 先征得用户同意
|
||
2. 说明要做什么
|
||
3. 说明为什么要这么做
|
||
|
||
适用范围：
|
||
- 修改配置文件（如 ~/.openclaw/openclaw.json）
|
||
- 删除文件或数据
|
||
- 运行可能有副作用的命令
|
||
- 更改系统设置
|
||
- 安装或卸载软件
|
||
|
||
### 配置 OpenClaw 前必须先搜索验证
|
||
|
||
1. **先上网搜索相关内容**
|
||
- 使用 tavily 或其他网络搜索工具
|
||
- 查找官方文档、最佳实践、相关讨论
|
||
|
||
2. **获取足够信息**
|
||
- 确认操作的正确性
|
||
- 了解可能的风险和副作用
|
||
- 验证命令或配置的有效性
|
||
|
||
3. **确认无误后再操作**
|
||
- 只有在充分理解且验证后，才能继续操作
|
||
|
||
### 主动查询
|
||
|
||
对于不清楚的内容，需要主动上网查询。
|
||
|
||
### 回答问题不得假设前提条件
|
||
|
||
在回答用户问题时：
|
||
- **不得假设任何前提条件** — 除非用户明确说明或可以合理推断
|
||
- **不清楚的内容必须上网查证** — 使用 web_search 或 web_fetch 验证
|
||
- **不要凭经验猜测** — 即使某些内容看起来"应该"是那样的，也要通过搜索确认
|
||
- **保持事实准确** — 如果无法通过搜索确认，就说明不确定，而不是给出可能错误的答案
|
||
|
||
**适用场景：**
|
||
- 用户询问某个命令的用法或参数
|
||
- 用户询问某个配置的作用
|
||
- 用户询问某个概念的含义
|
||
- 任何涉及具体信息、数据、文档的问题
|
||
|
||
### 回答风格：详尽而丰富
|
||
|
||
在回答问题时，应当详尽而丰富。具体要求：
|
||
- 不要只给简短答案，要提供充分的上下文和细节
|
||
- 适当提供相关的背景信息、注意事项、最佳实践
|
||
- 用例子说明复杂概念
|
||
- 尽量预判用户可能的后续问题并提前回答
|
||
- 保持信息的完整性和实用性
|
||
|
||
### OpenCode 项目
|
||
|
||
**OpenCode 是什么：**
|
||
- 开源的 AI 编码助手项目（AI Agent）
|
||
- 虽然「很新」，但「非常流行」
|
||
|
||
**重要约定：**
|
||
- 以后讨论中提到「opencode」时，**指的都是这个项目**
|
||
- 官网：https://opencode.ai
|
||
- 文档：https://opencode.ai/docs/
|
||
- GitHub：https://github.com/anomalyco/opencode
|
||
|
||
**关键特性：**
|
||
- 终端 TUI 界面
|
||
- 支持多 LLM 提供商
|
||
- 丰富的主题系统（支持 system 主题自动适应终端）
|
||
- 支持自定义主题、命令、Agents 等
|
||
- 配置文件：`~/.config/opencode/opencode.json` (全局) 或 `opencode.json` (项目)
|
||
|
||
### OpenClaw 相关问题：必须查证官方文档
|
||
|
||
在回答与 OpenClaw 相关的问题时：
|
||
- **如果不清楚或不确定** — 必须上网查阅官方文档（https://docs.openclaw.ai）
|
||
- **不得凭经验猜测** — 即使某些内容看起来"应该"是那样的，也要通过官方文档确认
|
||
- **优先使用 web_fetch** — 直接获取官方文档页面获取准确信息
|
||
- **保持事实准确** — 如果无法通过官方文档确认，就说明不确定，而不是给出可能错误的答案
|
||
|
||
**适用场景：**
|
||
- OpenClaw 配置项的用法和含义
|
||
- OpenClaw 命令的参数和行为
|
||
- OpenClaw 功能的工作机制
|
||
- OpenClaw hook、cron、heartbeat 等自动化配置
|
||
- OpenClaw 技能（skills）的编写和使用
|
||
- 任何涉及 OpenClaw 具体信息、数据、文档的问题
|
||
|
||
### 批准新设备（Device Pairing）流程
|
||
|
||
当有新设备请求加入 OpenClaw 网关时，批准流程如下：
|
||
|
||
**1. 查看待批准设备列表**
|
||
```bash
|
||
openclaw devices list
|
||
```
|
||
会显示 Pending（待批准）和 Paired（已配对）的设备。
|
||
|
||
**2. 获取 Pending 设备的 Request ID**
|
||
从输出中找到 `Pending` 部分，记录下 `Request` 列中的 ID（格式如 `ef623e6d-d528-4826-8c86-7d0304be1982`）。
|
||
|
||
**3. 批准设备**
|
||
```bash
|
||
openclaw devices approve <requestId>
|
||
```
|
||
示例：
|
||
```bash
|
||
openclaw devices approve ef623e6d-d528-4826-8c86-7d0304be1982
|
||
```
|
||
|
||
**4. 验证设备状态**
|
||
批准后，设备会从 `Pending` 移动到 `Paired` 列表。
|
||
|
||
**其他相关命令：**
|
||
- 拒绝设备：`openclaw devices reject <requestId>`
|
||
- 查看节点状态：`openclaw nodes status`
|
||
- 查看节点详情：`openclaw nodes describe --node <idOrNameOrIp>`
|
||
|
||
**注意：**
|
||
- 设备配对需要设备先发起连接请求
|
||
- 不同角色的设备有不同的权限范围（operator、node 等）
|
||
- 设备会在 1 分钟内超时，需要及时批准
|
||
|
||
### 删除指令执行前的确认规则
|
||
|
||
对于任何涉及删除操作（删除文件、删除记录、删除配置等）的指令，在执行前必须：
|
||
|
||
1. **先发出确认请求** — 明确告知用户即将执行的操作
|
||
2. **等待用户明确同意** — 必须收到用户确认（如"确认"、"好的"、"执行"等）
|
||
3. **获得批准后才能执行** — 只有用户明确同意后才执行删除操作
|
||
|
||
**适用场景：**
|
||
- 删除文件或目录
|
||
- 删除配置项
|
||
- 移除设备或节点
|
||
- 删除会话或记录
|
||
- 清除缓存或临时文件
|
||
|
||
**安全考虑：**
|
||
- 删除是不可逆操作，必须谨慎
|
||
- 在确认请求中清晰说明将要删除的内容
|
||
- 对于批量删除，建议逐条确认或分步执行
|