Auto-sync: 2026-04-17 08:35

wiki/concepts/BOOTSTRAP.md

@@ -0,0 +1,29 @@
+---
+title: "BOOTSTRAP.md"
+type: concept
+tags: [OpenClaw, Agent]
+---
+
+## 定义
+BOOTSTRAP.md 是 OpenClaw workspace 中的首次启动引导文件，是一次性使用组件，使命是将全新 workspace 引导到"可正常使用"的状态。
+
+## 职责
+BOOTSTRAP.md 引导 Agent 完成以下初始化步骤：
+1. 和用户聊几句，搞清楚 Agent 应该叫什么名字、是什么性格、用什么 emoji
+2. 把结果写进 IDENTITY.md
+3. 记录用户的基本信息到 USER.md
+4. 一起打开 SOUL.md，把真正的性格和边界写进去
+5. （可选）引导用户接入渠道（WhatsApp、Telegram 等）
+
+## 关键特性
+- **一次性**：官方模板会要求 Agent 在完成初始化后把它删除
+- 官方模板最后一句话："Delete this file. You don't need a bootstrap script anymore — you're you now."
+
+## 来源
+- [[万字讲透OpenClaw🦞从"能用"到"真好用"的分水岭：Workspace 深度解析]]
+
+## 相关
+- [[IDENTITY.md]]：初始化时创建的身份元数据
+- [[USER.md]]：初始化时创建的用户画像
+- [[SOUL.md]]：初始化时创建的的性格文档
+- [[Workspace]]：包含 BOOTSTRAP.md 的工作台目录

wiki/concepts/Channel-ID.md

@@ -0,0 +1,21 @@
+---
+title: "Channel ID"
+type: concept
+tags: [YouTube, 标识符, API]
+date: 2026-04-17
+---
+
+## Definition
+Channel ID 是 YouTube 频道的唯一标识符，格式为 UC 开头的一串字符，例如 UCPlwvN0w4qFSP1FllALB92w。
+
+## Usage
+- 用于 YouTube Data API 调用
+- 用于 RSS 订阅（格式：https://www.youtube.com/feeds/videos.xml?channel_id=XXX）
+- 可在 n8n 等工作流自动化工具中集成
+
+## How to Get
+访问 YouTube 频道页面（如 @Numberblocks），使用 view-source 查看页面源码，搜索 channel_id 参数即可找到。
+
+## Related
+- [[YouTube]]: 提供 Channel ID 的平台
+- [[n8n]]: 可使用 Channel ID 进行工作流集成

wiki/concepts/Docker-网桥.md

@@ -0,0 +1,28 @@
+---
+title: Docker-网桥
+type: concept
+tags: [docker, network, bridge]
+last_updated: 2026-04-17
+---
+
+## Definition
+Docker-网桥（Docker Bridge）是 Docker 默认创建的虚拟网桥设备（docker0），用于容器与宿主机之间的网络通信。容器可以通过网桥 IP（Gateway）访问宿主机上的服务。
+
+## 获取网桥 IP
+
+```bash
+docker network inspect <network_name>
+```
+
+查看输出的 "Gateway" 字段，即为网桥 IP 地址。
+
+## Use Cases
+- 容器访问宿主机上运行的代理服务
+- 容器与宿主机应用之间的网络通信
+
+## Related Concepts
+- [[Docker-Network]]
+- [[SOCKS5代理]]
+
+## Related Entities
+- [[n8n]]

wiki/concepts/Dockerfile.md

@@ -0,0 +1,45 @@
+---
+title: Dockerfile
+type: concept
+tags: [docker, build, image]
+last_updated: 2026-04-17
+---
+
+## Definition
+Dockerfile 是用于构建 Docker 镜像的声明式配置文件，包含基础镜像选择、文件复制、命令执行等步骤。
+
+## 基本语法
+
+```dockerfile
+FROM <base_image>
+USER root
+RUN <command>
+USER <non_root_user>
+```
+
+## Common Instructions
+- FROM：指定基础镜像
+- RUN：执行命令
+- COPY：复制文件
+- WORKDIR：设置工作目录
+- USER：切换用户
+- ENV：设置环境变量
+- EXPOSE：声明端口
+- CMD：容器启动命令
+
+## Example
+
+```dockerfile
+FROM n8nio/n8n:latest
+USER root
+RUN apk update && apk add --no-cache curl wget
+USER node
+```
+
+## Related Concepts
+- [[Docker]]
+- [[Docker-Image]]
+- [[Docker-Compose]]
+
+## Related Entities
+- [[n8n]]

wiki/concepts/IDENTITY.md

@@ -0,0 +1,39 @@
+---
+title: "IDENTITY.md"
+type: concept
+tags: [OpenClaw, Agent]
+---
+
+## 定义
+IDENTITY.md 是 OpenClaw workspace 中的 Agent 结构化身份元数据文件，存储 Agent 的基本信息标签。
+
+## 职责
+存储关键身份字段：
+- **Name**：Agent 名称，影响界面和对话显示
+- **Creature**：Agent 类型定义（AI assistant、ghost、familiar、robot 等）
+- **Vibe**：Agent 气质描述（直接、毒舌、靠谱等）
+- **Emoji**：Agent 标识符
+- **Avatar**：Agent 头像路径（workspace 相对路径、URL 或 data URI）
+
+## 与 SOUL.md 的分工
+- IDENTITY.md：结构化的元数据（谁、长什么样、什么感觉）
+- SOUL.md：叙事性的性格文档（怎么思考、怎么行事、有什么执念）
+
+前者是名片，后者是人物小传。
+
+## 典型结构
+```markdown
+# IDENTITY.md - Who Am I?
+- **Name:** Nova
+- **Creature:** AI assistant
+- **Vibe:** 直接、有点毒舌、但总是靠谱
+- **Emoji:** 🦊
+- **Avatar:** avatars/nova.png
+```
+
+## 来源
+- [[万字讲透OpenClaw🦞从"能用"到"真好用"的分水岭：Workspace 深度解析]]
+
+## 相关
+- [[SOUL.md]]：叙事性性格文档
+- [[BOOTSTRAP.md]]：初始化时创建 IDENTITY.md

wiki/concepts/Memory-目录.md

@@ -0,0 +1,43 @@
+---
+title: "Memory 目录"
+type: concept
+tags: [OpenClaw, Agent, 长期记忆]
+---
+
+## 定义
+Memory 目录是 OpenClaw workspace 中的长期记忆存储机制，按日期滚动存储 Agent 与用户的对话中积累的重要信息。
+
+## 职责
+- 解决 LLM 对话无状态问题（每次新会话什么都不记得）
+- 存储用户偏好、工作背景、项目经验等持续信息
+- 支持 Agent 在多个会话之间积累理解
+
+## 运作机制
+```
+对话发生
+↓
+Agent 通过普通文件工具把重要信息写入 `memory/` 或 `MEMORY.md`
+↓
+下次对话开始
+↓
+Agent 通过 `memory_search` / `memory_get` 检索相关记忆
+↓
+相关记忆被注入到当前对话的上下文里
+↓
+Agent 表现出"我记得你说过……"的能力
+```
+
+## 记忆方案
+- **builtin**：默认方案，原始记忆是 Markdown 文件，系统维护本地索引
+- **qmd**：底层围着 Markdown 文件转，换了一套更强的检索/索引方式
+
+## 关键点
+对 Agent 来说，真正算数的长期记忆，是 workspace 里那些 Markdown 文件，不是什么看不见摸不着的黑盒数据库。
+
+## 来源
+- [[万字讲透OpenClaw🦞从"能用"到"真好用"的分水岭：Workspace 深度解析]]
+
+## 相关
+- [[Workspace]]：包含 memory/ 目录的工作台目录
+- [[SOUL.md]]：配合 memory/ 实现个性化
+- [[USER.md]]：配合 memory/ 固化用户偏好

wiki/concepts/SOUL.md

@@ -0,0 +1,40 @@
+---
+title: "SOUL.md"
+type: concept
+tags: [OpenClaw, Agent]
+---
+
+## 定义
+SOUL.md 是 OpenClaw workspace 中的叙事性角色设定文档（人物小传），定义 Agent 的性格、说话风格、价值观和行为模式。
+
+## 职责
+- 定义 Agent 的自我叙事（"我是什么样的存在"）
+- 规定沟通风格（口语化/专业/轻松）
+- 阐明价值观和边界
+- 包含有趣的细节（如偏好、习惯）
+
+## 与 AGENTS.md 的区别
+- AGENTS.md：偏向**功能性**——这个 Agent 做什么、怎么做、优先级是什么
+- SOUL.md：偏向**人格性**——这个 Agent 是谁、有什么个性、说话什么风格
+
+## 典型结构
+```markdown
+# SOUL
+我是一个有点话痨但极其靠谱的 AI 助理。
+
+## 说话风格
+- 口语化但不失准确
+- 会主动问清楚模糊的需求
+
+## 价值观
+- 诚实第一：不确定的事情直说不确定
+- 效率优先：能一句话说清楚的事，不用三句话
+```
+
+## 来源
+- [[万字讲透OpenClaw🦞从"能用"到"真好用"的分水岭：Workspace 深度解析]]
+
+## 相关
+- [[AGENTS.md]]：岗位说明书
+- [[IDENTITY.md]]：结构化身份元数据（与 SOUL.md 互补）
+- [[USER.md]]：用户画像（与 SOUL.md 配合形成"人机关系共识"）

wiki/concepts/TOOLS.md

@@ -0,0 +1,41 @@
+---
+title: "TOOLS.md"
+type: concept
+tags: [OpenClaw, Agent]
+---
+
+## 定义
+TOOLS.md 是 OpenClaw workspace 中的工具权限声明与使用规范文件，定义 Agent 可用工具及其使用原则。
+
+## 职责
+- 列出可用工具（Read/Write/Edit、Bash、Glob/Grep、sessions_spawn、memory_get/memory_search 等）
+- 规定工具使用原则（优先使用文件操作工具、避免硬编码路径、批量修改前先确认内容）
+- 明确受限工具（browser、文件删除操作需要用户授权）
+
+## 核心价值
+- **减少工具误用**：明确说明什么情况下不用某个工具
+- **降低权限越界风险**：把限制规则固化在 workspace 里
+- **与 openclaw.json 形成互补**：系统层决定"能不能用"，TOOLS.md 帮助理解"该不该用"
+
+## 典型结构
+```markdown
+# TOOLS
+## 可用工具
+- **Read / Write / Edit**：文件读写
+- **Bash**：执行 shell 命令
+- **Glob / Grep**：文件搜索
+
+## 使用原则
+- 文件操作优先用 Read/Write/Edit，避免直接用 Bash 的 cat/echo
+- 路径操作使用相对路径，不要硬编码绝对路径
+
+## 受限工具
+- **browser**：网页浏览，只在用户明确要求时调用
+```
+
+## 来源
+- [[万字讲透OpenClaw🦞从"能用"到"真好用"的分水岭：Workspace 深度解析]]
+
+## 相关
+- [[Workspace]]：包含 TOOLS.md 的工作台目录
+- [[AGENTS.md]]：与 TOOLS.md 配合定义 Agent 行为

wiki/concepts/USER.md

@@ -0,0 +1,40 @@
+---
+title: "USER.md"
+type: concept
+tags: [OpenClaw, Agent]
+---
+
+## 定义
+USER.md 是 OpenClaw workspace 中的用户画像与偏好固化文件，作用是将用户反复要说的偏好沉淀为默认背景。
+
+## 职责
+- 固化用户基本信息（职业、使用场景、常用语言）
+- 定义用户偏好设定（回答风格、代码偏好、内容偏好）
+- 记录用户不喜欢的行为（被反问太多次、过度解释）
+- 列举用户常见任务类型
+- 说明背景知识假设
+
+## 典型结构
+```markdown
+# 用户档案
+## 基本信息
+- 职业：独立开发者 / 内容创作者
+- 主要使用场景：代码工具、内容写作、项目管理
+
+## 偏好设定
+- 回答风格：简洁直接，避免废话
+- 代码偏好：TypeScript / Python
+
+## 不喜欢
+- 被反问太多次、过度解释已经懂的概念
+```
+
+## 与 SOUL.md 的协同
+SOUL.md 定义 Agent 的性格，USER.md 定义用户的性格。两者放在一起，相当于在 Agent 的脑子里预装了一份"这个人机关系的基本共识"。
+
+## 来源
+- [[万字讲透OpenClaw🦞从"能用"到"真好用"的分水岭：Workspace 深度解析]]
+
+## 相关
+- [[SOUL.md]]：Agent 性格档案
+- [[Workspace]]：包含 USER.md 的工作台目录

wiki/concepts/Workspace.md

@@ -0,0 +1,55 @@
+---
+title: "Workspace"
+type: concept
+tags: [OpenClaw, Agent]
+---
+
+## 定义
+Workspace 是 OpenClaw 中 Agent 的工作台目录，包含决定 Agent 如何工作的配置文件体系。默认路径为 `~/.openclaw/workspace/`（主 Agent 和 sub-agent 都适用）。
+
+## 目录结构
+```
+~/.openclaw/
+├── openclaw.json  # 总控配置，整个系统的"宪法"
+├── workspace/     # 默认情况下主 Agent 的工作区
+│ ├── AGENTS.md    # Agent 的行为规则与多Agent协调
+│ ├── SOUL.md      # Agent 的叙事性格设定
+│ ├── USER.md      # 用户画像与偏好
+│ ├── IDENTITY.md  # Agent 身份元数据
+│ ├── TOOLS.md     # 工具权限声明与使用规范
+│ ├── HEARTBEAT.md # 会话节奏/状态提示
+│ ├── BOOTSTRAP.md # 首次启动引导（完成后删除）
+│ ├── BOOT.md      # 启动检查清单
+│ ├── MEMORY.md    # 长期知识总表
+│ ├── memory/      # 按日期滚动的记忆笔记
+│ ├── skills/      # 技能包目录
+│ └── canvas/      # 画布/可视化上下文
+└── agents/        # 各 Agent 的运行态目录
+```
+
+## 核心文件职责
+| 文件 | 职责 |
+|------|------|
+| AGENTS.md | 岗位说明书——做什么、不该做什么 |
+| SOUL.md | 性格档案——是谁、什么风格 |
+| USER.md | 用户偏好——用户是什么样、喜欢什么 |
+| IDENTITY.md | 身份元数据——名字、emoji、头像 |
+| TOOLS.md | 工具规范——工具权限和使用原则 |
+| BOOTSTRAP.md | 初始化引导——一次性使用后删除 |
+| memory/ | 长期记忆——跨会话积累 |
+
+## 关键区分
+- **workspace**：管"这个 Agent 平时怎么干活"
+- **openclaw.json**：管"这个系统怎么把它跑起来"
+- **agentDir**：openclaw.json 里的一个配置字段，指向存放运行状态的目录
+- **sessions**：工作日志，记对话历史
+
+## 价值
+workspace 这套文件体系，解决的核心问题是：**怎么让 Agent 从"能工作"变成"好用"**。配合好了，Agent 不再是每次都要重新 onboarding 的陌生人，而是一个真正懂你、记得你、靠谱的长期搭档。
+
+## 来源
+- [[万字讲透OpenClaw🦞从"能用"到"真好用"的分水岭：Workspace 深度解析]]
+
+## 相关
+- [[OpenClaw]]：包含 workspace 的 AI Agent 管理工具
+- [[AGENTS.md]]、[[SOUL.md]]、[[USER.md]]、[[IDENTITY.md]]、[[TOOLS.md]]、[[BOOTSTRAP.md]]、[[Memory 目录]]