← Back to Skills Marketplace
279
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install agent-manager-hxx
Description
管理 OpenClaw 系统中的 Agent 生命周期，包括 Agent 配置、Matrix 账号注册、账号绑定等操作。
README (SKILL.md)
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 \x3Cagent_id> \x3Cagent_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 \x3Ccommand> [options]
Agent 管理
# 列出所有 Agent
python3 scripts/config_manager.py agents list
# 添加 Agent
python3 scripts/config_manager.py agents add \x3Cname> [id] [workspace] [model]
# 移除 Agent
python3 scripts/config_manager.py agents remove \x3Cname>
Matrix 账号管理
# 列出所有 Matrix 账号
python3 scripts/config_manager.py accounts list
# 添加 Matrix 账号
python3 scripts/config_manager.py accounts add \x3Cname> \x3Caccesstoken> [id] [homeserver] [userId] [dm_policy]
# 移除 Matrix 账号
python3 scripts/config_manager.py accounts remove \x3Cname>
绑定管理
# 列出所有绑定
python3 scripts/config_manager.py bindings list
# 添加绑定
python3 scripts/config_manager.py bindings add \x3CagentId> \x3CaccountId> [channel]
# 移除绑定
python3 scripts/config_manager.py bindings remove \x3CagentId> \x3CaccountId>
3. matrix_register.sh - Matrix 账号注册
用于在 Matrix 服务器上注册新账号并获取 Access Token。
用法:
bash scripts/matrix_register.sh \x3Cusername> \x3Cpassword>
环境变量:
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 调用)
Usage Guidance
This skill appears to do what it says: create/manage agents, register Matrix accounts, store tokens and bind agents. Before running it: (1) verify the HOMESERVER_URL points to a trusted Matrix server; (2) inspect ~/.openclaw/tmp-workspace (and any files it will copy) to avoid installing unwanted files; (3) be aware that Matrix access tokens will be written in plaintext to your openclaw.json—restrict file permissions or encrypt the file if needed; (4) consider overriding the default predictable password used by setup_agent.sh with a stronger secret; and (5) back up your openclaw.json before mass changes. If you need the skill to avoid persisting secrets, request or modify the scripts to use a secure credential store instead of plain JSON.
Capability Analysis
Type: OpenClaw Skill
Name: agent-manager-hxx
Version: 1.0.0
The skill bundle automates OpenClaw agent setup and Matrix account management but contains security vulnerabilities. Specifically, `setup_agent.sh` implements a predictable hardcoded password pattern for account registration, and `matrix_register.sh` uses brittle JSON parsing via `sed` (lack of input sanitization). While the scripts' behaviors are aligned with the stated purpose of managing agent lifecycles, the combination of weak authentication defaults and the handling of sensitive Matrix access tokens in plaintext configuration files constitutes a high-risk profile.
Capability Assessment
Purpose & Capability
Name/description (agent lifecycle, Matrix account registration, bindings) match the included scripts and SKILL.md: scripts add/remove agents, register/login to Matrix, write accounts and bindings into openclaw.json. No unrelated services or credentials are requested.
Instruction Scope
Instructions operate on the OpenClaw config (default ~/.openclaw/openclaw.json) and a Matrix homeserver (HOMESERVER_URL). They read/write local config and call the Matrix API only; SKILL.md mentions HOMESERVER_URL and CONFIG_PATH although the registry metadata declared no required env vars (these are optional). The one-scripts flow (setup_agent.sh) copies a local tmp-workspace into a new workspace which could introduce unwanted files if that directory is untrusted—user should inspect tmp-workspace before running.
Install Mechanism
No install spec; this is a script/python-based bundle. No network-based installers or third-party package downloads are performed by the skill itself. Dependencies are standard (python3, curl, pypinyin).
Credentials
The skill handles Matrix access tokens (it obtains them via the homeserver and writes them into openclaw.json). Although no required secrets are declared in registry metadata, this behavior is expected for a manager that stores account credentials. Important security note: access tokens are persisted in plaintext within the JSON config file and the setup script generates a predictable password pattern (agent_id + fixed suffix). Users should be aware and may want to supply stronger passwords and secure the config file (filesystem permissions, encryption).
Persistence & Privilege
The skill does not request always:true and does not modify other skills or system-wide agent settings. It writes to its own application config (openclaw.json) and creates agent workspace directories—this is expected for its purpose.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install agent-manager-hxx - After installation, invoke the skill by name or use
/agent-manager-hxx - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of agent-manager skill for OpenClaw system.
- Manage the full lifecycle of Agents, including configuration, Matrix account registration, and account binding.
- Provides one-click setup with setup_agent.sh for automating Agent configuration and Matrix integration.
- Includes config_manager.py for direct management of openclaw.json: add/remove/list Agents, Matrix accounts, and bindings.
- Adds matrix_register.sh for registering new Matrix accounts via command line.
- Supports environment variables for server address and config file location.
- Requires Python 3, pypinyin, and curl.
Metadata
Frequently Asked Questions
What is agent-manager?
管理 OpenClaw 系统中的 Agent 生命周期，包括 Agent 配置、Matrix 账号注册、账号绑定等操作。 It is an AI Agent Skill for Claude Code / OpenClaw, with 279 downloads so far.
How do I install agent-manager?
Run "/install agent-manager-hxx" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is agent-manager free?
Yes, agent-manager is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does agent-manager support?
agent-manager is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created agent-manager?
It is built and maintained by 货又星 (@cxlhyx); the current version is v1.0.0.
More Skills