NanoClaw, Defapi๋ฅผ ํ†ตํ•ด ์ €๋ ดํ•œ ๋น„์šฉ์œผ๋กœ Claude API ์—ฐ๋™ ๊ฐ€๋Šฅ

โ€ขAI Tech Scout

NanoClaw๋Š” ๊ฒฉ๋ฆฌ๋œ ์ปจํ…Œ์ด๋„ˆ์—์„œ ์‹คํ–‰๋˜๋Š” ๊ฐœ์ธ์šฉ AI ์–ด์‹œ์Šคํ„ดํŠธ๋กœ, WhatsApp์„ ํ†ตํ•ด ์‚ฌ์šฉ์ž์™€ ์ƒํ˜ธ์ž‘์šฉํ•ฉ๋‹ˆ๋‹ค. ๋ณด์•ˆ์ด ์œ ์ง€๋˜๋Š” Linux ์ปจํ…Œ์ด๋„ˆ ํ™˜๊ฒฝ์—์„œ ์ž‘์—…์„ ์ˆ˜ํ–‰ํ•˜๊ณ  ํŒŒ์ผ์— ์ ‘๊ทผํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. NanoClaw๋ฅผ Defapi์— ์—ฐ๊ฒฐํ•˜๋ฉด ํ›จ์”ฌ ์ €๋ ดํ•œ ๋น„์šฉ์œผ๋กœ ๊ฐ•๋ ฅํ•œ AI ๊ธฐ๋Šฅ์„ ํ™œ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์„œ๋ก 

NanoClaw๋Š” ์ฃผ๋กœ ํ”„๋กœ์ ํŠธ ๋ฃจํŠธ ๋””๋ ‰ํ† ๋ฆฌ์˜ .env ํŒŒ์ผ์„ ํ†ตํ•ด API ์ธ์ฆ ์ •๋ณด๋ฅผ ๊ด€๋ฆฌํ•ฉ๋‹ˆ๋‹ค.

Defapi ํ”Œ๋žซํผ์˜ ์žฅ์ ์€ ๊ณต์‹ API์™€ ์™„๋ฒฝํ•˜๊ฒŒ ํ˜ธํ™˜๋˜๋Š” ์ธํ„ฐํŽ˜์ด์Šค๋ฅผ ์ œ๊ณตํ•˜๋ฉด์„œ๋„, ์‚ฌ์šฉ ๋น„์šฉ์€ ๊ณต์‹ ๊ฐ€๊ฒฉ์˜ ์•ฝ 50% ์ˆ˜์ค€์ด๋ผ๋Š” ์ ์ž…๋‹ˆ๋‹ค. ์ด๋Š” ์žฅ๊ธฐ์ ์œผ๋กœ ์‹คํ–‰๋˜๋Š” ๊ฐœ์ธ์šฉ AI ์–ด์‹œ์Šคํ„ดํŠธ์— ๋งค์šฐ ์ ํ•ฉํ•ฉ๋‹ˆ๋‹ค.

Defapi์˜ ๋ชจ๋“  ๋ชจ๋ธ์€ ๊ธฐ๋ณธ์ ์œผ๋กœ ๋‹ค์Œ ํ”„๋กœํ† ์ฝœ๊ณผ ํ˜ธํ™˜๋ฉ๋‹ˆ๋‹ค:

  • v1/chat/completions ์ธํ„ฐํŽ˜์ด์Šค
  • v1/messages ์ธํ„ฐํŽ˜์ด์Šค
  • v1beta/models/ ์ธํ„ฐํŽ˜์ด์Šค

๊ตฌ์ฒด์ ์ธ ์ž‘์—… ๋ฐฉ๋ฒ•

  1. API ์ž๊ฒฉ ์ฆ๋ช… ํš๋“
    Defapi ํ”Œ๋žซํผ์—์„œ ๊ณ„์ •์„ ๋“ฑ๋กํ•˜๊ณ  ์ „์šฉ API Key๋ฅผ ๋ฐ›์œผ์„ธ์š”.

  2. ํ™˜๊ฒฝ ๋ณ€์ˆ˜ ์„ค์ •
    NanoClaw ํ”„๋กœ์ ํŠธ ๋ฃจํŠธ ๋””๋ ‰ํ† ๋ฆฌ์˜ .env ํŒŒ์ผ์„ ์—ฝ๋‹ˆ๋‹ค. API ์š”์ฒญ ์ฃผ์†Œ๋ฅผ Defapi๋กœ ์ง€์ •ํ•˜๊ณ  API Key๋ฅผ ์ž…๋ ฅํ•˜๋„๋ก ๋‹ค์Œ ์„ค์ •์„ ์ˆ˜์ •ํ•˜๊ฑฐ๋‚˜ ์ถ”๊ฐ€ํ•ฉ๋‹ˆ๋‹ค:

    ANTHROPIC_API_KEY=your-defapi-api-key
    ANTHROPIC_BASE_URL=https://api.defapi.com/v1
    
  3. ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ์„œ๋น„์Šค ์žฌ์‹œ์ž‘
    ์„ค์ • ํŒŒ์ผ์„ ์ €์žฅํ•œ ํ›„, ์ƒˆ๋กœ์šด ํ™˜๊ฒฝ ๋ณ€์ˆ˜๊ฐ€ ์ ์šฉ๋˜๋„๋ก NanoClaw ์„œ๋น„์Šค๋ฅผ ์žฌ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค.

    • ๋ฐ๋ชฌ ํ”„๋กœ์„ธ์Šค(์˜ˆ: macOS์˜ launchctl)๋ฅผ ์‚ฌ์šฉํ•˜๋Š” ๊ฒฝ์šฐ ์„œ๋น„์Šค๋ฅผ ๋‹ค์‹œ ๋กœ๋“œํ•ฉ๋‹ˆ๋‹ค:
      launchctl unload ~/Library/LaunchAgents/com.nanoclaw.plist
      launchctl load ~/Library/LaunchAgents/com.nanoclaw.plist
      
    • ๊ฐœ๋ฐœ ๋ชจ๋“œ์ธ ๊ฒฝ์šฐ npm run dev๋ฅผ ๋‹ค์‹œ ์‹คํ–‰ํ•˜๋ฉด ๋ฉ๋‹ˆ๋‹ค.

NanoClaw ์ž‘๋™ ์—ฌ๋ถ€ ํ™•์ธ

๋ฐฉ๋ฒ• 1: ๋ฉ”์‹œ์ง€ ์ง์ ‘ ์ „์†ก ํ…Œ์ŠคํŠธ

์„œ๋น„์Šค๊ฐ€ ์„ฑ๊ณต์ ์œผ๋กœ ์‹œ์ž‘๋˜์—ˆ๋Š”์ง€ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค. WhatsApp์„ ์—ด๊ณ  ๋“ฑ๋ก๋œ ๊ทธ๋ฃน์ด๋‚˜ ์–ด์‹œ์Šคํ„ดํŠธ์™€์˜ ๊ฐœ์ธ ์ฑ„ํŒ…์—์„œ ๋‹ค์Œ๊ณผ ๊ฐ™์€ ํ…Œ์ŠคํŠธ ๋ฉ”์‹œ์ง€๋ฅผ ๋ณด๋ƒ…๋‹ˆ๋‹ค:

@Andy ์•ˆ๋…•ํ•˜์„ธ์š”, ์—ฐ๊ฒฐ์ด ์ •์ƒ์ธ์ง€ ํ™•์ธํ•˜๊ธฐ ์œ„ํ•ด ์ด ๋ฉ”์‹œ์ง€์— ๋‹ต์žฅํ•ด ์ฃผ์„ธ์š”.

์„ค์ •์ด ์˜ฌ๋ฐ”๋ฅด๋‹ค๋ฉด ์–ด์‹œ์Šคํ„ดํŠธ๊ฐ€ ๋ช‡ ์ดˆ ๋‚ด์— ๋‹ต์žฅ์„ ๋ณด๋‚ผ ๊ฒƒ์ž…๋‹ˆ๋‹ค.

๋ฐฉ๋ฒ• 2: ์‹คํ–‰ ๋กœ๊ทธ ํ™•์ธ

์‹œ์Šคํ…œ์˜ ์‹ค์‹œ๊ฐ„ ๋กœ๊ทธ๋ฅผ ํ™•์ธํ•˜์—ฌ API ์š”์ฒญ์ด ์„ฑ๊ณตํ•˜๊ณ  ์ธ์ฆ ์˜ค๋ฅ˜๊ฐ€ ์—†๋Š”์ง€ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค:

tail -f logs/nanoclaw.log
tail -f logs/nanoclaw.error.log

401 Unauthorized์™€ ๊ฐ™์€ ์˜ค๋ฅ˜ ๋ฉ”์‹œ์ง€๊ฐ€ ๋‚˜ํƒ€๋‚˜์ง€ ์•Š๋Š”๋‹ค๋ฉด ์ธํ„ฐํŽ˜์ด์Šค๊ฐ€ ์ •์ƒ์ ์œผ๋กœ ์—ฐ๊ฒฐ๋œ ๊ฒƒ์ž…๋‹ˆ๋‹ค.

๋Œ€ํ‘œ์ ์ธ 5๊ฐ€์ง€ ํ™œ์šฉ ์‚ฌ๋ก€

  1. ์—ฐ์ค‘๋ฌดํœด ํฌ๋กœ์Šค ํ”Œ๋žซํผ ์ปค๋ฎค๋‹ˆ์ผ€์ด์…˜ ์–ด์‹œ์Šคํ„ดํŠธ
    ํŠน์ • ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ์—ด ํ•„์š” ์—†์ด WhatsApp ์ธํ„ฐํŽ˜์ด์Šค๋ฅผ ํ†ตํ•ด ์–ธ์ œ๋“ ์ง€ ์ผ๋ฐ˜ ์ง€์‹, ํ”„๋กœ๊ทธ๋ž˜๋ฐ ๋ฌธ์ œ ๋˜๋Š” ๋ฌธ๊ตฌ ์ž‘์„ฑ์— ๋Œ€ํ•ด ์งˆ๋ฌธํ•˜๊ณ  ๋‹ต๋ณ€์„ ์–ป์„ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

  2. ์ž๋™ํ™”๋œ ์ผ์ƒ ์—…๋ฌด ๊ณ„ํš
    ์ฃผ๊ธฐ์ ์ธ ๋ช…๋ น์„ ์„ค์ •ํ•˜์—ฌ NanoClaw๊ฐ€ ๋งค์ผ ์•„์นจ ์ผ๊ธฐ ์˜ˆ๋ณด์™€ ์ผ์ •์„ ๋ณด๋‚ด๊ฒŒ ํ•˜๊ฑฐ๋‚˜, ๋งค์ฃผ ๋ง์— ์—…๋ฌด ์š”์•ฝ์„ ์ž๋™์œผ๋กœ ์ •๋ฆฌํ•˜๊ฒŒ ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

  3. ๋กœ์ปฌ ํ”„๋กœ์ ํŠธ์˜ ์ง€๋Šฅํ˜• ํ˜‘์—…์ž
    ์ปจํ…Œ์ด๋„ˆ ๋‚ด๋ถ€์˜ AI ์–ด์‹œ์Šคํ„ดํŠธ๊ฐ€ ์ง€์ •๋œ ์ž‘์—… ๋””๋ ‰ํ† ๋ฆฌ๋ฅผ ์•ˆ์ „ํ•˜๊ฒŒ ์ฝ๋„๋ก ํ—ˆ์šฉํ•˜์—ฌ ์ฝ”๋“œ ๋ฆฌ๋ทฐ, ํ”„๋กœ์ ํŠธ ์˜ค๋ฅ˜ ํƒ์ƒ‰ ๋˜๋Š” ๊ธด ๋ฌธ์„œ์˜ ํ•ต์‹ฌ ๋‚ด์šฉ ์š”์•ฝ์„ ๋•๊ฒŒ ํ•ฉ๋‹ˆ๋‹ค.

  4. ์‹ค์‹œ๊ฐ„ ์›น ์ •๋ณด ๊ฒ€์ƒ‰
    ์›น ํŽ˜์ด์ง€ ๋งํฌ๋ฅผ ๋ณด๋‚ด ์–ด์‹œ์Šคํ„ดํŠธ์—๊ฒŒ ํŽ˜์ด์ง€ ๋‚ด์šฉ์„ ์ถ”์ถœํ•˜๊ณ  ์ฃผ์š” ์š”์•ฝ์„ ์ƒ์„ฑํ•˜๋„๋ก ์š”์ฒญํ•˜๊ฑฐ๋‚˜, ์›น์—์„œ ํŠน์ • ๋‰ด์Šค ์‚ฌ๊ฑด์ด๋‚˜ ์‹œ์žฅ ๋™ํ–ฅ์„ ๊ฒ€์ƒ‰ํ•˜๊ฒŒ ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

  5. ๋ธŒ๋ผ์šฐ์ € ์ƒํ˜ธ์ž‘์šฉ ์‹คํ–‰์ž
    ๋ธŒ๋ผ์šฐ์ € ์ž๋™ํ™” ๋„๊ตฌ์™€ ๊ฒฐํ•ฉํ•˜์—ฌ ์–ด์‹œ์Šคํ„ดํŠธ๊ฐ€ ์ž์œจ์ ์œผ๋กœ ์›น์‚ฌ์ดํŠธ์— ์ ‘์†ํ•ด ๋ณต์žกํ•œ ์ž‘์—…์„ ์ˆ˜ํ–‰ํ•˜๋„๋ก ๋ช…๋ นํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์˜ˆ๋ฅผ ๋“ค์–ด ์ด์ปค๋จธ์Šค ํ”Œ๋žซํผ์—์„œ ์ œํ’ˆ ๊ฐ€๊ฒฉ์„ ๋น„๊ตํ•˜๊ฑฐ๋‚˜ ํ•ญ๊ณตํŽธ ์ •๋ณด ์กฐํšŒ๋ฅผ ๋„์šธ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

NanoClaw, Defapi๋ฅผ ํ†ตํ•ด ์ €๋ ดํ•œ ๋น„์šฉ์œผ๋กœ Claude API ์—ฐ๋™ ๊ฐ€๋Šฅ