MetaClaw

(โ˜… 3,492)

๐Ÿฆž Just talk to your agent โ€” it learns and EVOLVES ๐Ÿงฌ.

ํŒŒ์ผ ํƒ์ƒ‰๊ธฐ

  • .gitignore
  • LICENSE
  • pyproject.toml
  • README.md
  • requirements.txt

# ์„ค์น˜ ๊ฐ€์ด๋“œ

python
์‚ฌ์ „ ์ค€๋น„๋ฌผ

์„ค์น˜ ๋ฐ ์‹คํ–‰ ์ ˆ์ฐจ

curl -LO https://github.com/aiming-lab/MetaClaw/releases/download/v0.4.0/metaclaw-plugin.zip

MetaClaw OpenClaw ํ”Œ๋Ÿฌ๊ทธ์ธ ํŒจํ‚ค์ง€๋ฅผ ๋‹ค์šด๋กœ๋“œํ•ฉ๋‹ˆ๋‹ค.

unzip metaclaw-plugin.zip -d ~/.openclaw/extensions

๋‹ค์šด๋กœ๋“œํ•œ ํ”Œ๋Ÿฌ๊ทธ์ธ์„ OpenClaw ํ™•์žฅ ๋””๋ ‰ํ† ๋ฆฌ์— ์••์ถ• ํ•ด์ œํ•ฉ๋‹ˆ๋‹ค.

openclaw plugins enable metaclaw-openclaw && openclaw gateway restart

ํ”Œ๋Ÿฌ๊ทธ์ธ์„ ํ™œ์„ฑํ™”ํ•˜๊ณ  ๊ฒŒ์ดํŠธ์›จ์ด๋ฅผ ์žฌ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค.

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

์ „์ฒด ๊ธฐ๋Šฅ(RL, ์ง„ํ™”, ์Šค์ผ€์ค„๋Ÿฌ ํฌํ•จ)์„ ์œ„ํ•ด Python ํŒจํ‚ค์ง€๋ฅผ ์„ค์น˜ํ•ฉ๋‹ˆ๋‹ค.

metaclaw setup

๋Œ€ํ™”ํ˜• ์„ค์ • ๋งˆ๋ฒ•์‚ฌ๋ฅผ ์‹คํ–‰ํ•˜์—ฌ ์—์ด์ „ํŠธ์™€ ์ธ์ฆ ์ •๋ณด๋ฅผ ๊ตฌ์„ฑํ•ฉ๋‹ˆ๋‹ค.

metaclaw start

๊ธฐ๋ณธ ์ž๋™ ๋ชจ๋“œ(์Šคํ‚ฌ ๋ฐ ์Šค์ผ€์ค„๋ง๋œ RL ํ›ˆ๋ จ)๋กœ MetaClaw๋ฅผ ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค.

ํ•ต์‹ฌ ๋ช…๋ น์–ด

pip install -e .

๊ฐ€๋ฒผ์šด skills_only ๋ชจ๋“œ๋กœ ํŒจํ‚ค์ง€๋ฅผ ์„ค์น˜ํ•ฉ๋‹ˆ๋‹ค.

pip install -e ".[rl]"

RL ํ›ˆ๋ จ ์ง€์› ๊ธฐ๋Šฅ๊ณผ ํ•จ๊ป˜ ํŒจํ‚ค์ง€๋ฅผ ์„ค์น˜ํ•ฉ๋‹ˆ๋‹ค.

metaclaw setup

MetaClaw ์ดˆ๊ธฐ ์„ค์ • ๋งˆ๋ฒ•์‚ฌ๋ฅผ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.

metaclaw start

๊ธฐ๋ณธ ์ž๋™ ๋ชจ๋“œ๋กœ MetaClaw๋ฅผ ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค.

metaclaw start --mode rl

์Šค์ผ€์ค„๋Ÿฌ ์—†์ด ์ฆ‰์‹œ ์ „์ฒด ๋ฐฐ์น˜๋กœ RL ํ›ˆ๋ จ์„ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.

metaclaw start --mode skills_only

RL ์—†์ด ์Šคํ‚ฌ ๊ธฐ๋Šฅ๋งŒ ํ™œ์„ฑํ™”ํ•˜์—ฌ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค.

metaclaw config wechat.enabled true

WeChat ํ†ตํ•ฉ ๊ธฐ๋Šฅ์„ ํ™œ์„ฑํ™”ํ•ฉ๋‹ˆ๋‹ค.

์‹คํ–‰ ์ „ OpenAI ํ˜ธํ™˜ LLM API ํ‚ค ๋˜๋Š” ํ•„์š”ํ•œ OAuth ํ† ํฐ์„ ์ค€๋น„ํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.

# CDN์œผ๋กœ ์‚ฌ์šฉํ•˜๊ธฐ

jsDelivr

jsDelivr๋Š” ๊ณต๊ฐœ GitHub ๋ฆฌํฌ์ง€ํ† ๋ฆฌ๋ฅผ ๋ณ„๋„ ์„ค์ • ์—†์ด CDN์œผ๋กœ ์ฆ‰์‹œ ์„œ๋น™ํ•ฉ๋‹ˆ๋‹ค. ๋ฒ„์ „๊ณผ ํŒŒ์ผ์„ ๊ณ ๋ฅด๋ฉด ์›นํŽ˜์ด์ง€์— ๋ฐ”๋กœ ๋ถ™์ผ ์ˆ˜ ์žˆ๋Š” ๋งํฌ์™€ ์˜ˆ์‹œ ์ฝ”๋“œ๊ฐ€ ๋งŒ๋“ค์–ด์ง‘๋‹ˆ๋‹ค.

๋ช…๋ น์–ด ์šฉ์–ด์ง‘

์ด ๋ฌธ์„œ์—์„œ ์‚ฌ์šฉ๋œ ๋ช…๋ น์–ด๋ฅผ ๋ชจ์•„๋ดค์Šต๋‹ˆ๋‹ค. ๋‚ฏ์„  ๋ช…๋ น์–ด๊ฐ€ ์žˆ๋‹ค๋ฉด ํŽผ์ณ์„œ ํ™•์ธํ•ด๋ณด์„ธ์š”.

๐Ÿ”

npx

์„ค๋ช… ๋ณด๊ธฐ โ–ผ

์ด ๋ช…๋ น์€ `npm exec`์˜ ๋ณ„์นญ์ž…๋‹ˆ๋‹ค.

tldr npm exec

์ž์„ธํ•œ ๋‚ด์šฉ์€ ์›๋ณธ ๋ช…๋ น์„ ์ฐธ๊ณ ํ•˜์„ธ์š”:

๐Ÿ”

openclaw

์„ค๋ช… ๋ณด๊ธฐ โ–ผ

๊ฐœ์ธ ๊ธฐ๊ธฐ์—์„œ ์‹คํ–‰๋˜๋Š” ๊ฐœ์ธ AI ์–ด์‹œ์Šคํ„ดํŠธ.
`onboard`, `agent`, `doctor`์™€ ๊ฐ™์€ ์ผ๋ถ€ ํ•˜์œ„ ๋ช…๋ น์–ด๋Š” ๋ณ„๋„์˜ ์‚ฌ์šฉ๋ฒ• ๋ฌธ์„œ๋ฅผ ๊ฐ€์ง.
๊ด€๋ จ ํ•ญ๋ชฉ: `zeroclaw`.
๋” ๋งŽ์€ ์ •๋ณด: <https://docs.openclaw.ai/cli>.

openclaw onboard --install-daemon

๊ฒŒ์ดํŠธ์›จ์ด ๋ฐ ์ฑ„๋„ ์„ค์ •์„ ์œ„ํ•œ ์˜จ๋ณด๋”ฉ ์‹คํ–‰:

openclaw gateway --allow-unconfigured --port {{18789}} --verbose

๊ฒŒ์ดํŠธ์›จ์ด ์„œ๋ฒ„ ์‹œ์ž‘:

openclaw message send {{[-t|--target]}} {{+1234567890}} {{[-m|--message]}} "{{Hello}}"

์—ฐ๋ฝ์ฒ˜์— ๋ฉ”์‹œ์ง€ ์ „์†ก:

๐Ÿ”

pip install

์„ค๋ช… ๋ณด๊ธฐ โ–ผ

Install Python packages.

pip install {{package1 package2 ...}}

Install one or more packages:

pip install {{package1 package2 ...}} {{[-U|--upgrade]}}

Upgrade all specified packages to the latest version, installing any that are not already present:

pip install {{package}}=={{version}}

Install a specific version of a package:

๐Ÿ”

unzip

์„ค๋ช… ๋ณด๊ธฐ โ–ผ

Zip ์•„์นด์ด๋ธŒ์—์„œ ํŒŒ์ผ/๋””๋ ‰ํ† ๋ฆฌ๋ฅผ ์ถ”์ถœ.
๊ด€๋ จ ํ•ญ๋ชฉ: `zip`.
๋” ๋งŽ์€ ์ •๋ณด: <https://manned.org/unzip>.

unzip {{path/to/archive1.zip path/to/archive2.zip ...}}

ํŠน์ • ์•„์นด์ด๋ธŒ์—์„œ ๋ชจ๋“  ํŒŒ์ผ/๋””๋ ‰ํ† ๋ฆฌ๋ฅผ ํ˜„์žฌ ๋””๋ ‰ํ† ๋ฆฌ์— ์ถ”์ถœ:

unzip {{path/to/archive1.zip path/to/archive2.zip ...}} -d {{path/to/output}}

์•„์นด์ด๋ธŒ์—์„œ ํŒŒ์ผ/๋””๋ ‰ํ† ๋ฆฌ๋ฅผ ํŠน์ • ๊ฒฝ๋กœ๋กœ ์ถ”์ถœ:

unzip -c {{path/to/archive1.zip path/to/archive2.zip ...}}

์•„์นด์ด๋ธŒ์—์„œ ํŒŒ์ผ/๋””๋ ‰ํ† ๋ฆฌ๋ฅผ ์ถ”์ถœํ•˜๊ณ  ์ถ”์ถœ๋œ ํŒŒ์ผ ์ด๋ฆ„๊ณผ ํ•จ๊ป˜ `stdout`์œผ๋กœ ์ถœ๋ ฅ:

๐Ÿ”

zeroclaw service

์„ค๋ช… ๋ณด๊ธฐ โ–ผ

Manage the ZeroClaw background service (launchd/systemd user service).

zeroclaw service install

Install the daemon service:

zeroclaw service start

Start the daemon service:

zeroclaw service stop

Stop the daemon service:

๐Ÿ”

zeroclaw

์„ค๋ช… ๋ณด๊ธฐ โ–ผ

Fast, small, and fully autonomous AI assistant infrastructure.
Some subcommands such as `onboard`, `models`, `service`, etc have their own usage documentation.
See also: `openclaw`.

zeroclaw onboard --api-key {{api_key}} --provider {{openrouter|anthropic|openai|...}}

Initialize workspace and configuration (quick setup):

zeroclaw onboard --interactive

Run the full interactive onboarding wizard:

zeroclaw agent {{[-m|--message]}} "{{Hello, ZeroClaw!}}"

Send a single message to the AI agent:

๐Ÿ”

systemctl

์„ค๋ช… ๋ณด๊ธฐ โ–ผ

systemd ์‹œ์Šคํ…œ ๋ฐ ์„œ๋น„์Šค ๊ด€๋ฆฌ์ž๋ฅผ ์ œ์–ดํ•ฉ๋‹ˆ๋‹ค.
๋” ๋งŽ์€ ์ •๋ณด: <https://www.freedesktop.org/software/systemd/man/latest/systemctl.html>.

systemctl status

์‹คํ–‰ ์ค‘์ธ ์„œ๋น„์Šค ๋ชจ๋‘ ํ‘œ์‹œ:

systemctl --failed

์‹คํŒจํ•œ ์œ ๋‹› ๋‚˜์—ด:

systemctl {{start|stop|restart|reload|status}} {{unit}}

์„œ๋น„์Šค ์‹œ์ž‘/์ค‘์ง€/์žฌ์‹œ์ž‘/์žฌ๋กœ๋“œ/์ƒํƒœ ํ‘œ์‹œ:

๐Ÿ”

launchctl

์„ค๋ช… ๋ณด๊ธฐ โ–ผ

Apple์˜ `launchd` ๊ด€๋ฆฌ์ž์—์„œ ์‹œ์Šคํ…œ ์ „์—ญ ์„œ๋น„์Šค์ธ ์‹œ์ž‘ ๋ฐ๋ชฌ๊ณผ ์‚ฌ์šฉ์ž๋ณ„ ํ”„๋กœ๊ทธ๋žจ์ธ ์‹œ์ž‘ ์—์ด์ „ํŠธ๋ฅผ ์ œ์–ด.
`launchd`๋Š” ์ ์ ˆํ•œ ์œ„์น˜์— ๋ฐฐ์น˜๋œ XML ๊ธฐ๋ฐ˜ `*.plist` ํŒŒ์ผ์„ ๋กœ๋“œํ•˜๊ณ , ์ •์˜๋œ ์ผ์ •์— ๋”ฐ๋ผ ํ•ด๋‹น ๋ช…๋ น์„ ์‹คํ–‰.
๋” ๋งŽ์€ ์ •๋ณด: <https://keith.github.io/xcode-man-pages/launchctl.1.html>.

launchctl load ~/Library/LaunchAgents/{{my_script}}.plist

์‚ฌ์šฉ์ž๊ฐ€ ๋กœ๊ทธ์ธํ•  ๋•Œ๋งˆ๋‹ค `launchd`์— ๋กœ๋“œ๋  ์‚ฌ์šฉ์ž๋ณ„ ์—์ด์ „ํŠธ๋ฅผ ํ™œ์„ฑํ™”:

sudo launchctl load /Library/LaunchAgents/{{root_script}}.plist

๋ฃจํŠธ ๊ถŒํ•œ์ด ํ•„์š”ํ•˜๊ฑฐ๋‚˜ ๋ชจ๋“  ์‚ฌ์šฉ์ž๊ฐ€ ๋กœ๊ทธ์ธํ•  ๋•Œ๋งˆ๋‹ค ๋กœ๋“œ๋˜์–ด์•ผ ํ•˜๋Š” ์—์ด์ „ํŠธ๋ฅผ ํ™œ์„ฑํ™” (๊ฒฝ๋กœ์— `~` ์—†์Œ์— ์œ ์˜):

sudo launchctl load /Library/LaunchDaemons/{{system_daemon}}.plist

์‹œ์Šคํ…œ์ด ๋ถ€ํŒ…๋  ๋•Œ๋งˆ๋‹ค (์‚ฌ์šฉ์ž๊ฐ€ ๋กœ๊ทธ์ธํ•˜์ง€ ์•Š์•„๋„) ๋กœ๋“œ๋  ์‹œ์Šคํ…œ ์ „์—ญ ๋ฐ๋ชฌ์„ ํ™œ์„ฑํ™”:

// repository documentation