Sign In

๐Ÿฆž Clawdbot ๋ฌธ์„œ

๋ฒ„์ „: v2026.1.25
์ž‘์„ฑ์ผ: 2026๋…„ 1์›” 26์ผ
๋ผ์ด์„ ์Šค: MIT

๋ฌธ์„œ ์ด์šฉ ์•ˆ๋‚ด

์—ฐ๊ฒฐ์ด ํ™•์ธ๋œ ์‚ฌ์ดํŠธ ๋ฌธ์„œ๋Š” ๋งํฌ๋กœ ์—ด ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
โ€˜์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธโ€™ ํ•ญ๋ชฉ์€
์›๋ณธ ํŒŒ์ผ ๊ฒฝ๋กœ๋งŒ ๋ณด์กดํ–ˆ์Šต๋‹ˆ๋‹ค.

๐Ÿ“‹ ๋ชฉ์ฐจ

๐Ÿ  ์‹œ์ž‘ํ•˜๊ธฐ

๐Ÿ— ์•„ํ‚คํ…์ฒ˜

โ€ข
์‹œ์Šคํ…œ ์•„ํ‚คํ…์ฒ˜ ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (architecture/system.md)
โ€ข
๋ฐ์ดํ„ฐ ํ๋ฆ„ ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (architecture/data-flow.md)
โ€ข
ํ†ต์‹  ํ”„๋กœํ† ์ฝœ ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (architecture/protocol.md)

๐Ÿ”ง ํ•ต์‹ฌ ์ปดํฌ๋„ŒํŠธ

โ€ข
Gateway ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (components/gateway.md)
โ€ข
Pi Agent Runtime ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (components/pi-agent.md)
โ€ข
์„ธ์…˜ ๊ด€๋ฆฌ ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (components/sessions.md)
โ€ข
์ด๋ฒคํŠธ ์‹œ์Šคํ…œ ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (components/events.md)

๐Ÿ“จ ์ฑ„๋„ ์‹œ์Šคํ…œ

โ€ข
WhatsApp ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (channels/whatsapp.md)
โ€ข
Telegram ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (channels/telegram.md)
โ€ข
Slack ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (channels/slack.md)
โ€ข
Discord ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (channels/discord.md)
โ€ข
๊ธฐํƒ€ ์ฑ„๋„ ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (channels/others.md)

๐Ÿ›  ๋„๊ตฌ(Tools) ์‹œ์Šคํ…œ

โ€ข
๋ธŒ๋ผ์šฐ์ € ์ œ์–ด ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (tools/browser.md)
โ€ข
Canvas/A2UI ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (tools/canvas.md)
โ€ข
๋””๋ฐ”์ด์Šค ๋…ธ๋“œ ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (tools/nodes.md)
โ€ข
Cron & ์›นํ›… ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (tools/automation.md)
โ€ข
์„ธ์…˜ ๋„๊ตฌ ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (tools/sessions-tool.md)

โš™ CLI ๋ฐ ์„ค์ •

โ€ข
์Šคํ‚ฌ ์‹œ์Šคํ…œ ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (cli-config/skills.md)

๐Ÿ”’ ๋ณด์•ˆ ๋ฐ ์ƒŒ๋“œ๋ฐ•์‹ฑ

โ€ข
DM ์ •์ฑ… ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (security/dm-policy.md)
โ€ข
Docker ์ƒŒ๋“œ๋ฐ•์Šค ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (security/sandbox.md)
โ€ข
์ธ์ฆ ๋ฐ ๊ถŒํ•œ ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (security/auth-permissions.md)

๐Ÿ’ป ๊ฐœ๋ฐœ ๋ฐ ํ…Œ์ŠคํŠธ

โ€ข
๊ฐœ๋ฐœ ํ™˜๊ฒฝ ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (development/README.md)
โ€ข
ํ…Œ์ŠคํŠธ ๊ฐ€์ด๋“œ ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (development/testing.md)
โ€ข
์ฝ”๋“œ ์Šคํƒ€์ผ ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (development/code-style.md)
โ€ข
๊ธฐ์—ฌ ๊ฐ€์ด๋“œ ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (development/contributing.md)

๐Ÿš€ ์„ค์น˜ ๋ฐ ๋ฐฐํฌ

โ€ข
๋ฐฑ๊ทธ๋ผ์šด๋“œ ์„œ๋น„์Šค ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (deployment/background-service.md)
โ€ข
Docker ๋ฐฐํฌ ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (deployment/docker.md)
โ€ข
์›๊ฒฉ ์ ‘์† ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (deployment/remote-access.md)
โ€ข
์šด์˜ ๊ฐ€์ด๋“œ ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (deployment/operations.md)

๐Ÿ“š ์ฝ”๋“œ ์˜ˆ์‹œ

โ€ข
CLI ์‚ฌ์šฉ ์˜ˆ์‹œ ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (examples/cli.md)
โ€ข
WebSocket ํ”„๋กœํ† ์ฝœ ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (examples/websocket.md)
โ€ข
์„ค์ • ์˜ˆ์‹œ ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (examples/configuration.md)
โ€ข
์Šคํ‚ฌ ๊ฐœ๋ฐœ ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (examples/skill-development.md)
โ€ข
์ฑ„๋„ ์–ด๋Œ‘ํ„ฐ ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (examples/channel-adapter.md)

๐ŸŽฏ ์‚ฌ์šฉ ๊ฐ€์ด๋“œ

โ€ข
ํŒ๊ณผ ํŠธ๋ฆญ ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (usage/tips-tricks.md)

โšก ์„ฑ๋Šฅ ์ตœ์ ํ™”

โ€ข
์„ฑ๋Šฅ ํŠœ๋‹ ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (performance/tuning.md)
โ€ข
๋ฉ”๋ชจ๋ฆฌ ๊ด€๋ฆฌ ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (performance/memory.md)
โ€ข
๋ฆฌ์†Œ์Šค ์ตœ์ ํ™” ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (performance/resources.md)
โ€ข
ํ™•์žฅ์„ฑ ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (performance/scalability.md)

๐Ÿ“Š ๋น„๊ต ๋ถ„์„

โ€ข
์žฅ๋‹จ์  ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (comparison/pros-cons.md)
โ€ข
์„ ํƒ ๊ฐ€์ด๋“œ ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (comparison/selection.md)

๐Ÿ“ˆ ๋‹ค์ด์–ด๊ทธ๋žจ

โ€ข
๋ฐ์ดํ„ฐ ํ๋ฆ„ ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (diagrams/data-flow.md)
โ€ข
๋ฐฐํฌ ์•„ํ‚คํ…์ฒ˜ ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (diagrams/deployment.md)
โ€ข
์‹œ์Šคํ…œ ERD ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (diagrams/erd.md)

๐Ÿ” ๋น ๋ฅธ ๊ฒ€์ƒ‰

์ฃผ์ œ๋ณ„ ๋ฌธ์„œ ์ฐพ๊ธฐ

์ฃผ์ œ
๋ฌธ์„œ
์„ค๋ช…
์„ค์น˜ ๋ฐฉ๋ฒ•
NPM, Docker, ๋ฐฑ๊ทธ๋ผ์šด๋“œ ์„œ๋น„์Šค ์„ค์น˜
์•„ํ‚คํ…์ฒ˜ ์ดํ•ด
์ „์ฒด ์‹œ์Šคํ…œ ๊ตฌ์กฐ ์ดํ•ด
์ฑ„๋„ ์„ค์ •
๊ฐ ๋ฉ”์‹ ์ €๋ณ„ ์„ค์ • ๋ฐฉ๋ฒ•
๋„๊ตฌ ์‚ฌ์šฉ
๋ธŒ๋ผ์šฐ์ €, Canvas, ๋…ธ๋“œ ์‚ฌ์šฉ๋ฒ•
๋ณด์•ˆ ์„ค์ •
DM ์ •์ฑ…, ์ƒŒ๋“œ๋ฐ•์Šค, ์ธ์ฆ ์„ค์ •
๊ฐœ๋ฐœ ์‹œ์ž‘
๊ฐœ๋ฐœ ํ™˜๊ฒฝ ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (development/README.md)
๋กœ์ปฌ ๊ฐœ๋ฐœ ํ™˜๊ฒฝ ๊ตฌ์„ฑ
๋ฌธ์ œ ํ•ด๊ฒฐ
์ผ๋ฐ˜์ ์ธ ๋ฌธ์ œ ํ•ด๊ฒฐ ๋ฐฉ๋ฒ•

์‚ฌ์šฉ์ž ๋ ˆ๋ฒจ๋ณ„ ์ถ”์ฒœ ๋ฌธ์„œ

๋ ˆ๋ฒจ
์ถ”์ฒœ ๋ฌธ์„œ
์„ค๋ช…
์ž…๋ฌธ์ž
๊ธฐ๋ณธ ์„ค์น˜๋ถ€ํ„ฐ ์ฒซ ์‚ฌ์šฉ๊นŒ์ง€
์ค‘๊ธ‰ ์‚ฌ์šฉ์ž
์‹ค์ œ ์‚ฌ์šฉ ์‹œ๋‚˜๋ฆฌ์˜ค์™€ ๊ณ ๊ธ‰ ๊ธฐ๋Šฅ
๊ฐœ๋ฐœ์ž
๊ฐœ๋ฐœ ํ™˜๊ฒฝ ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (development/README.md), ์ฝ”๋“œ ์˜ˆ์‹œ ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (examples/cli.md)
์†Œ์Šค ์ฝ”๋“œ ์ˆ˜์ •, ๊ธฐ๋Šฅ ํ™•์žฅ
์šด์˜์ž
์šด์˜ ๊ฐ€์ด๋“œ ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (deployment/operations.md), ์„ฑ๋Šฅ ํŠœ๋‹ ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (performance/tuning.md)
ํ”„๋กœ๋•์…˜ ๋ฐฐํฌ ๋ฐ ์šด์˜
๋ณด์•ˆ ์ „๋ฌธ๊ฐ€
๋ณด์•ˆ ๊ฐœ์š”, Docker ์ƒŒ๋“œ๋ฐ•์Šค ยท ์—ฐ๊ฒฐ ๋Œ€์ƒ ๋ฏธํ™•์ธ (security/sandbox.md)
๋ณด์•ˆ ๋ชจ๋ธ ์‹ฌ์ธต ์ดํ•ด

๐ŸŒ ์™ธ๋ถ€ ์ž๋ฃŒ

๊ณต์‹ ๋ฌธ์„œ

์ปค๋ฎค๋‹ˆํ‹ฐ

โ€ข
โ€ข

๐Ÿ“ ๋ฌธ์„œ ์—…๋ฐ์ดํŠธ

โ€ข
๋ฒ„์ „: v2026.1.25
โ€ข
๋งˆ์ง€๋ง‰ ์—…๋ฐ์ดํŠธ: 2026๋…„ 1์›” 26์ผ
โ€ข
๋ผ์ด์„ ์Šค: MIT
์ด ๋ฌธ์„œ๋Š” Clawdbot v2026.1.25 ๋ฒ„์ „์„ ๊ธฐ์ค€์œผ๋กœ ์ž‘์„ฑ๋˜์—ˆ์Šต๋‹ˆ๋‹ค. ๋ฒ„์ „์— ๋”ฐ๋ผ ์ผ๋ถ€ ๊ธฐ๋Šฅ์ด ๋‹ค๋ฅผ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

๐Ÿ“‹ ๋น ๋ฅธ ์‹œ์ž‘ ๊ฐ€์ด๋“œ

1. ์„ค์น˜

# ๊ธ€๋กœ๋ฒŒ ์„ค์น˜ (๊ถŒ์žฅ)
npm install -g clawdbot@latest

# ์„ค์น˜ ํ™•์ธ
clawdbot --version

2. ์˜จ๋ณด๋”ฉ

# ์˜จ๋ณด๋”ฉ ์œ„์ €๋“œ ์‹คํ–‰
clawdbot onboard --install-daemon

3. ์ฑ„๋„ ๋กœ๊ทธ์ธ

# WhatsApp ๋กœ๊ทธ์ธ
clawdbot channels login whatsapp

# Telegram ๋กœ๊ทธ์ธ
clawdbot channels login telegram

4. ์ฒซ ์‚ฌ์šฉ

# ๋ฉ”์‹œ์ง€ ์ „์†ก
clawdbot send --to whatsapp:+1234567890 --message "์•ˆ๋…•ํ•˜์„ธ์š”!"

# ์ƒํƒœ ํ™•์ธ
clawdbot status

๐ŸŽฏ ํ•ต์‹ฌ ํŠน์ง• ์š”์•ฝ

โœ… ๋กœ์ปฌ ์šฐ์„ 

โ€ข
๋ชจ๋“  ๋ฐ์ดํ„ฐ๊ฐ€ ์‚ฌ์šฉ์ž ์žฅ์น˜์— ์ €์žฅ๋จ
โ€ข
ํด๋ผ์šฐ๋“œ API ํ˜ธ์ถœ์„ ์ œ์™ธํ•˜๊ณ  ๋ฐ์ดํ„ฐ ์œ ์ถœ ์—†์Œ
โ€ข
LLM ๊ณต๊ธ‰์ž์™€ ์ง์ ‘ ํ†ต์‹  (์ค‘๊ฐ„ ์„œ๋ฒ„ ์—†์Œ)

โœ… ๋‹ค์ค‘ ์ฑ„๋„ ์ง€์›

โ€ข
13๊ฐœ ์ด์ƒ์˜ ๋ฉ”์‹ ์ € ํ”Œ๋žซํผ ํ†ตํ•ฉ
โ€ข
WhatsApp, Telegram, Slack, Discord, Google Chat, Signal, iMessage ๋“ฑ

โœ… WebSocket ์ œ์–ด ํ‰๋ฉด

โ€ข
๋‹จ์ผ Gateway๊ฐ€ ๋ชจ๋“  ์—ฐ๊ฒฐ์„ ๊ด€๋ฆฌ
โ€ข
๊ธฐ๋ณธ ํฌํŠธ: ws://127.0.0.1:18789

โœ… ๋‹ค์ค‘ ์—์ด์ „ํŠธ ๋ผ์šฐํŒ…

โ€ข
์ฑ„๋„/๊ณ„์ •/ํ”ผ์–ด๋ณ„๋กœ ์„ธ์…˜ ๊ฒฉ๋ฆฌ
โ€ข
๋‹ค์ค‘ ์›Œํฌ์ŠคํŽ˜์ด์Šค ์ง€์›
โ€ข
์—์ด์ „ํŠธ ๊ฐ„ ํ†ต์‹  ๊ฐ€๋Šฅ

โœ… ๋ธŒ๋ผ์šฐ์ € ์ž๋™ํ™”

โ€ข
Playwright Core ๊ธฐ๋ฐ˜ ๋‚ด์žฅ ๋ธŒ๋ผ์šฐ์ €
โ€ข
Canvas/A2UI๋ฅผ ํ†ตํ•œ ์‹œ๊ฐ ์ž‘์—…๊ณต๊ฐ„

โœ… ๋ณด์•ˆ ๋ชจ๋ธ

โ€ข
DM ํŽ˜์–ด๋ง (์ƒˆ๋กœ์šด ์—ฐ๊ฒฐ์ž ์Šน์ธ)
โ€ข
Docker ์ƒŒ๋“œ๋ฐ•์Šค (๋น„-main ์„ธ์…˜ ๊ฒฉ๋ฆฌ)
โ€ข
๊ถŒํ•œ ๊ด€๋ฆฌ (๋„๊ตฌ๋ณ„ ํ—ˆ์šฉ/๊ฑฐ๋ถ€)

โœ… ํ™•์žฅ์„ฑ

โ€ข
ํ”Œ๋Ÿฌ๊ทธ์ธ ์‹œ์Šคํ…œ
โ€ข
์Šคํ‚ฌ ๊ฐœ๋ฐœ SDK
โ€ข
์ฑ„๋„ ์–ด๋Œ‘ํ„ฐ ์ธํ„ฐํŽ˜์ด์Šค