BlueRoseNote/07-Other/AI/AI Agent/OpenClaw.md

# 前言
- https://github.com/openclaw/openclaw
- 教程
	- [ ] Clawdbot 完整配置指南 - Sylearn的文章 - 知乎 https://zhuanlan.zhihu.com/p/1999437992549447616
	- [ ] 【OpenClaw 烧钱避坑指南：3个策略教你省下 80% 的 Token】 https://www.bilibili.com/video/BV1TNZjBTEAp/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e
	- [ ] 【Clawdbot为什么能记住你说过的话? AI记忆系统拆解】 https://www.bilibili.com/video/BV1fv61B4EQ5/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e
	- 【claude官方揭秘：为啥不需要多Agent架构？《Building multi-agent systems: when and how to use 》①】 https://www.bilibili.com/video/BV13KzqBHEPw/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e
	- [ ] ***[【🚀解锁OpenClaw多Agent高级玩法！Token消耗直接减半，这才是正确的使用方式！不同任务分配不同模型，独立Session、独立记忆，独立工作空间](https://www.bilibili.com/video/BV1dqffBMEcg/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e) 
	- [ ] [【4种方法将 OpenClaw 成本降低10倍 ｜直降95%+ Token 消耗！【保姆教程】】](https://www.bilibili.com/video/BV1ejADzsEUm/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e) 简单步骤参考 [[#OpenClaw节约成本的方式]]
	- [ ] [【🚀【OpenClaw教程】OpenClaw高级玩法：记忆蒸馏+Skill固化+模型降级！Token成本直降40%，效率倍增！便宜模型也能完成复杂任务！龙虾教程】](https://www.bilibili.com/video/BV1WbPTzHEaa/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e)
	- [x] 【Mac mini 64G部署Clawdbot + 本地大模型。无限tokens，拥有真正7*24免费私人助手！】 https://www.bilibili.com/video/BV1KE61BuEAk/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e
- Skill
	1. https://github.com/VoltAgent/awesome-openclaw-skills
	2. [【50个 skills 让你的 OpenClaw 脱胎换骨】 ](https://www.bilibili.com/video/BV1fDA8z6E9n/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e)
- 其他Bot框架
	- 【我厌倦了 OpenClaw，用回了 AstrBot【AstrBot 年度更新】】 https://www.bilibili.com/video/BV1FmZMBiEs9/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e

# WY Gitlab Token
2fwpCjzAM7T6ZsXVtr67
- RedmineSkill
	- 2Bt5SqsyBfbVAp31-k17

# TODO
![[工作计划]]

# OpenClaw架构构思
https://clawhub.ai/ Skill推荐：
- Common
	- [x] ***find-skills***：在20万+Skills里自动找到所需工具。 #导航员
	- [x] skill-creator：把你的工作流打包成可复用能力。 #工厂
	- [x] ***self-improving-agent***： 记录经验教训、错误和纠正措施，以实现持续改进。
	- [x] Summarize：使用 summarize CLI 对 URL 或文件进行汇总（网页、PDF、图像、音频、YouTube）。
- 文档类	
	- [x] pdf：合并、拆分、提取复杂PDF，无手动头疼。 #文档专家
	- [x] pptx：生成完整专业幻灯片，再也不用移动文本框。 #演示专家
	- [x] docx：创建结构化Word文档，直接用于官方用途。 #文书
	- [x] xlsx：带复杂公式和图表的Excel文件。 #数据分析师
- 搜索相关
	- [x] GitHub 官方 MCP:claude mcp add github -- npx -y @modelcontextprotocol/server-github
	- [x] 搜索引擎类：输出的结果质量以及Token消耗量都不理想。
		- jina-reader:
			- https://clawhub.ai/ericsantos/jina-reader
			- https://skills.sh/sundial-org/awesome-openclaw-skills/jina-reader
		- Tavily
			- https://skills.sh/tavily-ai/skills/search: `npx skills add https://github.com/tavily-ai/skills --skill search`
			- https://skills.sh/tavily-ai/skills/research: `npx skills add https://github.com/tavily-ai/skills --skill research`
			- https://skills.sh/tavily-ai/skills/extract: `npx skills add https://github.com/tavily-ai/skills --skill extract`
			- https://skills.sh/veithly/tavily-search/tavily-search: `npx skills add https://github.com/veithly/tavily-search --skill tavily-search`
- 编程类
	- [x] ***using-superpowers***：强制Agent真正发挥高级能力。 #优化器
	- [x] **acpx**：外部工具桥接器，可以用来控制ClaudeCode等编程工具，还需要额外配置。  #编程
 - 优化类
	- [ ] [openclaw-workspace](https://github.com/win4r/openclaw-workspace)：优化OpenClaw工作区。提示词：帮我用 openclaw-workspace 这个 skill 做一次 workspace审计/精简 AGENTS.md/ 优化 TOOLS.md"等。可以创建定时任务让他每周执行。
- 控制中心(都处于质量存疑阶段)
	- [ ] https://github.com/TianyiDataScience/openclaw-control-center
	- [ ] https://github.com/abhi1693/openclaw-mission-control
## Agent & Memory
在默认工作区可以到以下文件，这些都是Agent提示词的主程部分：

| 文件                     | 用途                                    | 加载时机                    | 子 Agent 可见？ |
| ---------------------- | ------------------------------------- | ----------------------- | ----------- |
| `AGENTS.md`            | 启动序列、操作清单、行为规则                        | 每次轮次（所有 Agent）          | 是           |
| `SOUL.md`              | 人格、语气、价值观、连续性哲学                       | 每次轮次（所有 Agent）          | 是           |
| `TOOLS.md`             | 环境特定信息（SSH、TTS、摄像头、设备）                | 每次轮次（主 Agent + 子 Agent） | 是           |
| `USER.md`              | 用户画像、偏好、关系背景                          | 每次轮次（仅主会话）              | 否           |
| `IDENTITY.md`          | 名称、Emoji、头像、自我描述                      | 每次轮次                    | 是           |
| `HEARTBEAT.md`         | 周期性检查任务和健康例程                          | 每次心跳轮次                  | 视情况而定       |
| `BOOT.md`              | 启动时执行的操作（需要 `hooks.internal.enabled`） | 网关启动时                   | 否           |
| `BOOTSTRAP.md`         | 首次初始化脚本——用完即删                         | 仅新工作区                   | 否           |
| `MEMORY.md`            | 长期精华事实与铁律规则                           | 仅主会话                    | **永不**      |
| `memory/YYYY-MM-DD.md` | 每日会话日志                                | 按 AGENTS.md 启动序列加载      | 否           |
| `checklists/*.md`      | 高风险操作的逐步指南                            | 按需加载（从 AGENTS.md 引用）    | 否           |
### 各文件详解
#### AGENTS.md — 操作手册
这是每次会话中最先塑造 Agent 行为的文件（基础系统提示词之后）。它包含：
- **启动序列**：有序列出需要在会话开始时读取的文件（SOUL → USER → MEMORY → 日志）
- **清单路由表**：高风险操作 → 对应清单文件路径的映射
- **安全规则**：哪些操作需要确认、哪些可以自主执行
- **群聊规则**：在群聊中不应分享什么

**注意**：AGENTS.md 是规程文件，不是身份文件。人格和价值观属于 SOUL.md。

#### SOUL.md — 灵魂
用第二人称书写（"你不是一个聊天机器人，你正在成为某个人"），Agent 读取后将其内化为自我描述。
包含：核心价值观、边界与底线、语气风格、关于连续性的哲学（每次会话都是全新开始，工作区文件就是记忆）。

#### TOOLS.md — 本地环境备忘录
这是工作区中最容易被误用的文件。它应该是**当前机器的环境专属速查表**：SSH 主机、TTS 声音 ID、摄像头设备名称等。
子 Agent 也会收到此文件——这是它们唯一的环境知识来源。请保持简洁，50 行以内为佳。

#### USER.md — 用户画像
包含影响每次对话的人物相关事实：姓名、时区、语言偏好、沟通风格。
仅在主会话中加载——绝不在群聊或子 Agent 会话中加载。

#### MEMORY.md — 铁律规则
只保存"遗忘了就会出严重问题"的规则。每条规则要短且原子化，具有明确的行动指导意义。
定期精炼（每月一次）。已经几个月没有出过问题的规则，可以考虑迁移到技能的 `SKILL.md` 文件中（更合适的归宿）。

#### checklists / * .md — 操作清单
高风险操作（部署、网关重启、配置变更）的逐步指南。Agent 执行操作前主动读取对应清单。
 **正确模式** ：AGENTS.md 只保留一行路由表条目，完整清单放在 `checklists/` 目录中（按需加载，不占用每轮 Token 预算）。
---

### 2. 调用逻辑与顺序
按优先级读取顺序：
AGENTS.md → SOUL.md → TOOLS.md → IDENTITY.md → USER.md
#### Skill 加载（SKILL.md 注入）
三个来源，优先级从高到低：
① < workspace >/skills（agent 独有）
② ~/.openclaw/skills（全局共享）
③ bundled skills（内置）
同名 skill 高优先级覆盖低优先级

####  建议：
如果你想把记忆用法精炼，推荐这样分层：
1. 通用行为规范 → AGENTS.md / SOUL.md（所有会话都加载）
2. 工具使用指南 → Skill 的 SKILL.md（按需触发加载）
3. 持久事实/偏好 → MEMORY.md（长期记忆）
4. 需要代码逻辑的 → Plugin（如自动 Token 管理、MCP 代理）

以 Redmine 为例的最佳实践：
• Skill：SKILL.md 写"怎么调用、什么时候触发、参数格式"
• Plugin：如果要做自动 Token 刷新、webhook 监听等，写成 Plugin
• MEMORY.md：只存"loujiajie 有权限的项目是 H78"这种事实

不建议把所有东西都塞进 MEMORY.md，

### 记忆移植方法

### 将记忆移植到Skill
【Skill】= 教 agent "怎么做某件事"
• 本质是 SKILL.md（Markdown 指令）+ 可选脚本
• 注入到 agent 的上下文中，agent 按指令执行
• 适合：工具使用说明、操作流程、触发规则
• 例：RedmineSkill 告诉 agent 如何调用 MCP 查工单
## Muti-Agent
按照日常功能分出几个额外Agent，并让他们使用不同的Workspace。

# ~~Docker 部署~~(推荐虚拟机部署)
1. https://docs.openclaw.ai/install/docker
2. git clone https://github.com/openclaw/openclaw.git
3. ./docker-setup.sh

## 2025.2.24错误解决
**问题1：**
># Error: EACCES: permission denied, open '/home/node/.openclaw/openclaw.json.7.2ede223b-aa90-4aa5-8f0d-97049696b626.tmp

此时在docker-setup.sh的以下两行：
mkdir -p "$OPENCLAW_CONFIG_DIR"  
mkdir -p "$OPENCLAW_WORKSPACE_DIR"

之后添加这一行即可解决问题。
>chown -R 1000:1000 "$OPENCLAW_CONFIG_DIR"

**问题2：** Gateway无法启动
在docker-compose.yml的environment下面添加  `GATEWAY_CONTROLUI_DANGEROUSLYALLOWHOSTHEADERORIGINFALLBACK: true`：
```yml
services:
  openclaw-gateway:
    image: ${OPENCLAW_IMAGE:-openclaw:local}
    environment:
      HOME: /home/node
      TERM: xterm-256color
	   ...
      GATEWAY_CONTROLUI_DANGEROUSLYALLOWHOSTHEADERORIGINFALLBACK: true
```

# OpenClaw Skill
安装命令行：
- npx clawhub@latest install XXX
- npx clawhub install XXX

# OpenClaw Agent命令
- 🛠️ 核心交互指令
	- /new：立即结束当前会话，并启动一个完全干净的新会话。
	- /clear：清理当前对话的上下文。
	- /help：显示当前环境下所有可用的指令列表及简要说明。
	- /compact：手动触发上下文压缩。这在对话过长、Token 消耗过高时非常有用，它会将之前的讨论总结为摘要，以腾出更多上下文空间。
	- /undo：撤销上一步操作。它会回滚最后一次的用户输入以及 AI 的响应。
	- /exit 或 /quit：安全退出当前的 Agent 会话。
- 🧩 技能与 MCP 管理（重点）
	- /skills：列出当前 Agent 已经加载并激活的所有技能。你可以通过此指令确认你的自定义技能（如 RAG 驱动的哲学库）是否被正确识别。
	- /mcp：查看当前连接的 MCP 服务器状态。它会显示通过 stdio 或 sse 传输协议挂载的服务是否在线。
	- /reload：重新加载配置文件和技能定义。当你修改了 skills 目录下的逻辑或更新了 MCP 配置后，无需重启整个程序，使用此指令即可生效。
- 📊 系统与状态监控
	- /stats：显示当前会话的统计信息，包括已消耗的 Token 数量、预计成本以及上下文窗口的使用百分比。
	- /config：查看当前运行时的配置信息（如当前指向的 LLM 模型、温度参数等）。
	- /debug：切换调试模式。开启后，你可以看到工具调用的原始 JSON 数据，这对于排查 jina_search 或数据库查询的返回值非常关键。
# OpenClaw本地操作命令
- openclaw onboard
- openclaw gateway
- openclaw gateway status
- openclaw configure
修改模型：
```
openclaw models set <provider/model>
```

## 连接Ollamav本地部署模型
>ollama launch openclaw

之后选择指定模型即可。
## 查看日志
openclaw logs --follow
```

# OpenClaw Docker
```c++
docker pull alpine/openclaw:main

```

1. git clone https://github.com/openclaw/openclaw.git
2. cd openclaw
3. 核心步骤：构建并启动 Docker 镜像（约 5–30 分钟）
	1. （可选）加速：使用预构建镜像。如果不想本地构建（build 过程可能下载依赖较慢），设置环境变量跳过：`bash export OPENCLAW_IMAGE=alpine/openclaw   # 或官方其他镜像（视最新可用）`

## 克隆 OpenClaw 仓库
bash 运行
```
git clone https://github.com/openclaw/openclaw.git
cd openclaw
```

github还需要添加一下代理。

git config --global --list

git config --global http.https://github.com.proxy http://192.168.50.151:2081
git config --global https.https://github.com.proxy http://192.168.50.151:2081
~~git config --global http.https://github.com.proxy http://192.168.50.100:20171
git config --global https.https://github.com.proxy http://192.168.50.100:20171
~~
git config --global --unset http.https://github.com.proxy
git config --global --unset https.https://github.com.proxy

git config --global --unset http.proxy 
git config --global --unset https.proxy

export https_proxy="http://192.168.50.100:20171"
export http_proxy="http://192.168.50.100:20171"
export https_proxy="http://192.168.50.151:2081"
export http_proxy="http://192.168.50.151:2081"


取消代理
unset http_proxy https_proxy
unset http_proxy https_proxy all_proxy

Docker添加代理
https://zhuanlan.zhihu.com/p/703839288

## 核心步骤：构建并启动 Docker 镜像（约 5–30 分钟）
### （可选）加速：使用预构建镜像
如果不想本地构建（build 过程可能下载依赖较慢），设置环境变量跳过：
bash运行
```
export OPENCLAW_IMAGE=alpine/openclaw   # 或官方其他镜像（视最新可用）

unset OPENCLAW_IMAGE
```

### 运行官方 setup 脚本
bash运行
```
./docker-setup.sh   # 明确用新 bash 执行
```
脚本会完成以下操作：
- 拉取 / 构建镜像（openclaw:local）
- 创建～/.openclaw（配置）和～/openclaw/workspace（沙箱目录）
- 启动 docker-compose 服务

构建过程会输出进度，如果卡在 100%，耐心等或检查网络 / 代理。

## 常见坑点处理
1. 报 `declare -A: invalid option` → 确认用 bash 5.x 执行（上文已解决）
2. 报 `Cannot connect to the Docker daemon` → 启动 Docker Desktop，或执行 `docker context use desktop-linux`
3. 权限问题 → 执行 `sudo chown -R $USER ~/.openclaw ~/openclaw/workspace`

## 配置与首次使用（Onboarding）
### 启动 onboarding wizard
bash运行
```
docker compose run --rm openclaw-cli wizard
```
1. 选择 QuickStart（推荐，新手友好，后续可手动调整）
2. 阅读安全警告 → 输入 Yes 继续
3. 输入模型 API Key（推荐 Groq、Claude、OpenAI 等）
4. 配置通道（Telegram/Discord 推荐先用一个）
5. 生成 pairing code → 在对应平台发给 bot 配对

### 批准配对（以 Discord 为例）
bash运行
```
docker compose run --rm openclaw-cli pairing approve discord <你的配对码>
```

### 验证
bash运行
```
docker compose run --rm openclaw-cli devices list
```

## 测试
1. 在 Discord/Telegram 发消息给 bot（如 “你好”）
2. 查看日志确认：

bash运行
```
docker compose logs -f
```

## 日常管理命令
- 启动 / 重启：`docker compose up -d` / `docker compose restart`
- 停止：`docker compose down`
- 查看状态：`docker compose ps`
- 打开 Web Dashboard：`docker compose run --rm openclaw-cli dashboard`（通常 [localhost:18789](https://localhost:18789)）
- 安全审计：`docker compose exec openclaw-gateway openclaw security audit --deep`

## 安全提醒
1. Docker 提供隔离，但仍需谨慎开启工具（如文件读写、shell 执行）。
2. 不要把高危权限给 bot，启用 allowlist、mention gating。
3. 定期运行 `openclaw security audit --fix`。
4. API Key 等敏感信息存储在～/.openclaw/，备份好。

## 总结
在 macOS 上通过 Docker 安装 OpenClaw 非常可靠，整体流程为：
**准备（Homebrew + bash 升级 + Docker）→ 克隆仓库 → bash ./docker-setup.sh → wizard 配置 → pairing 批准 → 测试聊天**
整个过程 30–60 分钟就能跑起本地个人 AI 助手，强烈推荐 Docker 方式，避免直接污染系统。


# Channel
- 添加命令:openclaw channels add
## 飞书
- 【【小白入门教程】openclaw(clawdbot)安装部署教程，接入飞书/钉钉/QQ等聊天工具，5分钟学会，详细教程】 https://www.bilibili.com/video/BV1jBcaz6E6P/?share_source=copy_web&vd_source=fe8142e8e12816535feaeabd6f6cdc8e

AppID:cli_a90596306738dcc7
AppSecret:JZfGrXKRkwCE4a5yYvKZ2bSrOM1jZsDV

## QQ
https://github.com/sliverp/qqbot

## IMessage
https://cloud.tencent.com/developer/article/2626310

## PoPo
- 相关文章:
	- [OpenClaw(原Clawdbot)对接POPO机器人教程](https://docs.popo.netease.com/lingxi/173a627a791b4372aa50318bfdfb5204?appVersion=4.28.0&deviceType=4&popo_hidenativebar=1&popo_noindicator=1&appVersion=4.40.0&deviceType=0&popo_hidenativebar=1&popo_noindicator=1&disposable_login_token=1)
	- https://km.netease.com/v4/detail/blog/258877
- 插件文档:https://docs.popo.netease.com/lingxi/173a627a791b4372aa50318bfdfb5204

## 企业微信
- https://github.com/pawastation/wechat-kf
- Token信息
	- AgentId:1000002
	- Secret:pO0No5pwv8hV9jugSi9xmOZZad72Wei3E4ODsZj4WoM
	- 企业ID:wwe0397ed29188a4f0
	- 客服相关信息
		- 客服ID:
			- kfc7eeb057fe05d99d2
			- kfc4a55884d560c1c61
		- 回调URL:https://institutional-search-louisiana-studio.trycloudflare.com/wechat-kf
		- Token:IpeMUlsfK
		- EncodingAESKey:NCYt4eJauOIb6faxnHAokQOj2LtOIyGAtXG2i5JF1gV
		- Secret:CkwXJs7hJiofO7L1XPZZcxKM7Z5VQEwfR8T4IOfeZYk
		- 客服测试链接:https://work.weixin.qq.com/kfid/kfc4a55884d560c1c61
	- ~~消息接收（创建的App中）~~