- 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 - 一键设置脚本
完整设置流程，自动完成以下步骤：
- 添加 Agent 配置到 openclaw.json
- 在 Matrix 服务器注册账号
- 将账号添加到 openclaw.json 配置
- 绑定 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 调用)