---

name: agent-manager description: 管理 OpenClaw 系统中的 Agent 生命周期，包括 Agent 配置、Matrix 账号注册、账号绑定等操作。

Agent Manager

用于管理 OpenClaw 系统中 Agent 的完整生命周期，包括 Agent 配置、Matrix 账号注册、账号绑定等操作。

功能概述

• Agent 配置管理: 添加、移除、列出 Agent 配置
• Matrix 账号管理: 注册新账号、添加、移除 Matrix 账号
• 绑定管理: 建立 Agent 与 Matrix 账号的关联
• 一键设置: 自动化完成整个 Agent 设置流程

脚本说明

1. setup_agent.sh - 一键设置脚本

完整设置流程，自动完成以下步骤：

1. 添加 Agent 配置到 openclaw.json
2. 在 Matrix 服务器注册账号
3. 将账号添加到 openclaw.json 配置
4. 绑定 Agent 与 Matrix 账号

用法:

bash scripts/setup_agent.sh <agent_id> <agent_name>

参数:

• agent_id: Agent 的唯一标识（如: juezhi）
• agent_name: Agent 的显示名称（如: 货绝知）

环境变量:

• HOMESERVER_URL: Matrix 服务器地址（默认: http://localhost:8008）
• CONFIG_PATH: openclaw.json 配置文件路径（默认: ~/.openclaw/openclaw.json）

示例:

# 默认设置
bash scripts/setup_agent.sh "huojuezhi" "货绝知"

# 指定 Matrix 服务器
HOMESERVER_URL=http://192.168.1.100:8008 bash scripts/setup_agent.sh "huojuezhi" "货绝知"

---

2. config_manager.py - 配置管理器

用于直接管理 openclaw.json 配置文件。

用法:

python3 scripts/config_manager.py <command> [options]

Agent 管理

# 列出所有 Agent
python3 scripts/config_manager.py agents list

# 添加 Agent
python3 scripts/config_manager.py agents add <name> [id] [workspace] [model]

# 移除 Agent
python3 scripts/config_manager.py agents remove <name>

Matrix 账号管理

# 列出所有 Matrix 账号
python3 scripts/config_manager.py accounts list

# 添加 Matrix 账号
python3 scripts/config_manager.py accounts add <name> <accesstoken> [id] [homeserver] [userId] [dm_policy]

# 移除 Matrix 账号
python3 scripts/config_manager.py accounts remove <name>

绑定管理

# 列出所有绑定
python3 scripts/config_manager.py bindings list

# 添加绑定
python3 scripts/config_manager.py bindings add <agentId> <accountId> [channel]

# 移除绑定
python3 scripts/config_manager.py bindings remove <agentId> <accountId>

---

3. matrix_register.sh - Matrix 账号注册

用于在 Matrix 服务器上注册新账号并获取 Access Token。

用法:

bash scripts/matrix_register.sh <username> <password>

环境变量:

• HOMESERVER_URL: Matrix 服务器地址（默认: http://localhost:8008）

输出格式:

RESULT_USER_ID: @username:homeserver
RESULT_ACCESS_TOKEN: syt_xxxxx...

示例:

# 注册账号
HOMESERVER_URL=http://192.168.1.100:8008 bash scripts/matrix_register.sh "huojuezhi" "password123"

---

配置文件

配置文件默认路径: ~/.openclaw/openclaw.json

配置文件结构:

• agents: Agent 列表配置
• channels.matrix.accounts: Matrix 账号配置
• bindings: Agent 与账号的绑定关系

依赖

• Python 3
• pypinyin (用于将中文名转为拼音 ID)
• curl (用于 Matrix API 调用)