🎯 AI Agent 项目感知插件管理指南

1
# 1. 在项目目录创建 .openclaw 插件目录
2

3
mkdir -p ~/my-project/.openclaw/plugins
4

5
# 2. 放入项目专属插件（.ts 文件）
6

7
cp my-custom-plugin.ts ~/my-project/.openclaw/plugins/
8

9
# 3. 启动时指定 workspace 为该项目
10

11
openclaw --workspace ~/my-project
12

13
# 或在配置中设置
14

15
openclaw config set agents.defaults.workspace "~/my-project"  # 官方默认工作区为 ~/clawd；字段路径请以 openclaw config 为准

1
# 创建项目级配置文件
2

3
mkdir -p ~/my-web-project/profiles
4

5
cat > ~/my-web-project/profiles/openclaw.yml << 'EOF'
6

7
# ===== 项目：Web 前端开发 =====
8

9
name: web-frontend-dev
10

11
description: "Web 前端开发项目，启用浏览器和前端相关插件"
12

13
# 插件白名单：只启用这些插件（其他全局插件自动禁用）
14

15
plugins:
16

17
allow:
18

19
- "@openclaw/browser"       # 浏览器自动化（前端调试必需）
20

21
- "@openclaw/feishu"         # 飞书文档协作
22

23
- "tavily-search"             # 网页搜索（查文档）
24

25
- "coding-agent"              # 编程增强
26

27
deny:
28

29
- "openclaw-weixin"           # 写代码不需要微信
30

31
- "@openclaw/whatsapp"        # 不需要 WhatsApp
32

33
- "@openclaw/signal"          # 不需要 Signal
34

35
- "memory-core"                # 短期项目不需要跨会话记忆
36

37
# 逐个插件的精细控制
38

39
entries:
40

41
"@openclaw/browser":
42

43
enabled: true
44

45
config:
46

47
headless: false            # 前端调试需要有头浏览器
48

49
"coding-agent":
50

51
enabled: true
52

53
config:
54

55
language: "typescript"     # 项目用 TypeScript
56

57
EOF
58

59
# 启动时 OpenClaw 自动发现 profiles/openclaw.yml
60

61
cd ~/my-web-project && openclaw

1
# 创建项目级技能目录
2

3
mkdir -p ~/my-data-project/.hermes/skills/data-analyzer
4

5
# 创建技能描述文件
6

7
cat > ~/my-data-project/.hermes/skills/data-analyzer/SKILL.md << 'EOF'
8

9
---
10

11
name: data-analyzer
12

13
description: "数据分析专用技能，支持 Pandas/Matplotlib，自动生成数据报告"
14

15
version: 1.0.0
16

17
requires_toolsets: ["python", "file"]    # 条件式激活：只有python和file工具可用时才显示
18

19
---
20

21
# 数据分析技能
22

23
当用户需要分析数据时使用本技能。
24

25
1. 先用 pandas 读取数据文件
26

27
2. 进行描述性统计
28

29
3. 用 matplotlib 生成图表
30

31
4. 输出分析报告
32

33
EOF
34

35
# 进入项目目录，Hermes 自动发现该技能
36

37
cd ~/my-data-project && hermes

1
cat > ~/my-writing-project/.hermes.md << 'EOF'
2

3
# 项目：技术博客写作
4

5
---
6

7
## 项目规则
8

9
- 本项目只写技术博客，不写代码
10

11
- 语言：中文，风格：通俗易懂
12

13
- 每篇博客包含：标题、引言、正文、总结
14

15
---
16

17
## 启用的技能
18

19
- web-search（查资料）
20

21
- postproxy（发布到社交媒体）
22

23
- markdown-formatter（格式化 Markdown）
24

25
---
26

27
## 禁用的工具/技能
28

29
- 不要使用代码执行工具（bash/python）
30

31
- 不要使用浏览器自动化工具
32

33
- 不要调用微信/钉钉相关功能
34

35
- 不要自主创建技能（本项目规则固定）
36

37
---
38

39
## 输出规范
40

41
- 直接输出 Markdown 格式
42

43
- 代码块用 ``` 包裹
44

45
- 不超过 3000 字
46

47
EOF
48

49
# Hermes 进入该目录时自动加载 .hermes.md
50

51
cd ~/my-writing-project && hermes

1
# 1. 查看已有 Profile
2

3
dsh profile list
4

5
# 2. 创建新项目 Profile（如"前端开发"）
6

7
dsh profile create frontend-dev
8

9
# 3. 编辑该 Profile 的 cordis.patch.yml（dsh 启动时按 bundle → cordis.patch.yml → home patch → --patch 顺序分层组装）
10

11
cat > ~/.dsh/profiles/frontend-dev/cordis.patch.yml << 'EOF'
12

13
# ===== Profile: 前端开发 =====
14

15
# 只启用前端开发需要的插件
16

17
plugins:
18

19
# 启用的插件
20

21
"@dsh/model-deepseek": { enabled: true }
22

23
"@dsh/tool-bash": { enabled: true }
24

25
"@dsh/tool-editor": { enabled: true }
26

27
"@dsh/tool-search": { enabled: true }
28

29
"@dsh/tool-skills": { enabled: true }
30

31
"@dsh/agent-subagent": { enabled: true }
32

33
"@dsh/mode-code": { enabled: true }
34

35
# 禁用的插件（前端开发不需要）
36

37
"@dsh/agent-workflow": { enabled: false }
38

39
"@dsh/agent-captain": { enabled: false }
40

41
"dsh-wx-bridge": { enabled: false }
42

43
"dsh-feishu-gateway": { enabled: false }
44

45
"harness-gateway": { enabled: false }
46

47
EOF
48

49
# 4. 用该 Profile 启动 dsh
50

51
dsh --profile frontend-dev
52

53
dsh --profile frontend-dev --dump-config   # 打印分层组装后实际生效的配置，便于核对
54

55
# 或在 Web UI 中切换 Profile（右上角下拉）
56

57
# 或在 VS Code 扩展中使用独立 Profile

1
mkdir -p ~/my-api-project/.dsh/skills/api-tester
2

3
cat > ~/my-api-project/.dsh/skills/api-tester/SKILL.md << 'EOF'
4

5
---
6

7
name: api-tester
8

9
description: "API 测试技能，自动生成 curl 命令和测试用例"
10

11
---
12

13
# API 测试技能
14

15
当用户需要测试 API 时使用。自动生成 curl 命令、Postman 集合、pytest 测试用例。
16

17
EOF
18

19
# dsh 进入该目录时自动发现
20

21
cd ~/my-api-project && dsh

1
# 安装项目级 MCP 管理插件
2

3
dsh plugin --profile <方案名> add dsh-project-mcp-manager
4

5
# 在项目目录创建 .dsh/mcp.yml 定义项目专属 MCP
6

7
cat > ~/my-db-project/.dsh/mcp.yml << 'EOF'
8

9
mcpServers:
10

11
postgres:
12

13
command: "npx"
14

15
args: ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
16

17
redis:
18

19
command: "npx"
20

21
args: ["-y", "@modelcontextprotocol/server-redis"]
22

23
EOF
24

25
# 进入该项目目录时，dsh-project-mcp-manager 自动挂载 postgres 和 redis MCP
26

27
# 离开该目录时自动卸载，不会污染其他项目