MetaClaw

环境要求

• Python 环境并可使用 pip（项目为 Python 项目）
• 无需 GPU（README 明确说明 No GPU required）
• 使用 OpenClaw 一键安装时，本机需已安装 openclaw CLI
• RL 训练需额外安装对应后端依赖（如 rl.backend=mint 需 mindlab-toolkit，weaver 需 nex-weaver）

安装与启动步骤

1. 1安装 MetaClaw

   用 pip 从本项目安装。只做技能模式装轻量版；要 RL 训练、技能进化或日历调度，按需加对应 extra。

   pip install -e .
   pip install -e ".[rl]"
   pip install -e ".[evolve]"
   pip install -e ".[scheduler]"
   pip install -e ".[rl,evolve,scheduler]"

   复制

2. 2OpenClaw 一键安装

   OpenClaw 用户可改走插件方式：下载 v0.4.0 发布包的插件压缩包并解压到 openclaw 扩展目录。

   curl -LO https://github.com/aiming-lab/MetaClaw/releases/download/v0.4.0/metaclaw-plugin.zip
   unzip metaclaw-plugin.zip -d ~/.openclaw/extensions
   openclaw plugins enable metaclaw-openclaw && openclaw gateway restart

   复制

3. 3运行配置向导

   首次使用执行交互式向导，会生成 ~/.metaclaw/config.yaml。向导第一个问题即选择要配置的个人智能体。

   metaclaw setup

   复制

4. 4选择智能体类型

   如向导中未选或想更换，可用 config 命令随时切换，例如切到 CoPaw、IronClaw，或 none 表示手动/自定义智能体。

   metaclaw config claw_type copaw

   复制

5. 5启动 MetaClaw

   一条命令拉起本地代理、注入技能并自动接好所选智能体。默认 auto 模式，可用 --mode 临时指定 rl 或 skills_only。

   metaclaw start

   复制

6. 6验证与停止

   start 会等本地代理健康后才返回；用 status 检查代理健康、运行模式和调度状态，用 stop 结束后台进程。

   metaclaw status
   metaclaw stop

   复制

关键配置

如何确认成功

执行 metaclaw status，确认本地 proxy 健康、运行模式与调度状态正常；start 命令本身也会等代理健康后才返回。

常见问题

注意事项

• 配置统一存放在 ~/.metaclaw/config.yaml，由 metaclaw setup 生成，改配置优先用 metaclaw config KEY VALUE。
• RL 相关的 torch、transformers、tinker 等只在安装 [rl] extra 时才会装上。
• OpenClaw 一键安装还要看 extensions/metaclaw-openclaw/README.md 中的 Windows、镜像与排错说明。
• metaclaw uninstall 会删除全部 MetaClaw 数据、OpenClaw 扩展和 pip 包，执行前请确认。