배경
OpenClaw란 무엇인가요?

인공지능 에이전트를 사용해 본 적이 없다면, 가장 간단하게 설명해 드리겠습니다. ChatGPT는 유리병 속의 두뇌와 같습니다. OpenClaw는 그 두뇌에 손을 달아줍니다.

OpenClaw는 오픈 소스 기반의 자체 호스팅 AI 에이전트입니다. ChatGPT가 단순히 대화만 할 수 있는 반면, OpenClaw는 실제로 사용자와 소통할 수 있습니다. 일을 하다 파일을 읽고, 이메일을 보내고, 웹을 탐색하고, 소셜 미디어에 게시물을 올리는 등 모든 작업을 "스킬"을 통해 외부 도구에 연결하여 수행할 수 있습니다. 스킬은 컴퓨터에서 로컬로 실행되므로 데이터는 컴퓨터에 저장됩니다.

🦞
왜 하필 바닷가재 로고인가요?
OpenClaw는 2025년 11월 "Clawdbot"으로 시작하여 잠시 "Moltbot"으로 이름이 바뀌었다가 최종적으로 "OpenClaw"로 정착했습니다. 이름이 바뀌는 동안에도 바닷가재 로고는 그대로 유지되었습니다. 2026년 2월까지 GitHub에서 20만 개 이상의 스타를 획득하며 역사상 가장 빠르게 성장하는 오픈 소스 프로젝트 중 하나가 되었습니다.

이 튜토리얼에서는 OpenClaw를 사용하여 X(트위터)에 연결하고 AI 에이전트를 통해 트윗을 자동으로 게시하는 방법을 살펴보겠습니다. 튜토리얼을 마치면 OpenClaw를 사용하여 트윗을 작성, 예약 및 게시할 수 있게 됩니다.

시작하기 전에
준비물

시작하기 전에 이것들을 준비하세요. 그러면 중간에 멈추는 일을 방지할 수 있습니다.

💻
에이 맥 또는 윈도우 컴퓨터 최소 8GB RAM이 필요합니다. OpenClaw는 사용자의 컴퓨터에서 로컬로 실행됩니다.
🔧
Node.js가 설치되었습니다. (버전 18 이상). 다음에서 무료로 다운로드하세요. 노드js.org. 처음 사용하시는 경우라면 설치 프로그램을 다운로드하여 실행하기만 하면 됩니다. 별도의 설정은 필요하지 않습니다.
🤖
AI 모델 API 키 - 어느 하나 OpenAI (GPT-4) 또는 인류 (클로드). OpenClaw를 작동시키려면 두뇌가 필요합니다. 두 플랫폼 모두에서 신규 계정에는 무료 크레딧이 제공됩니다.
🐦
X / 트위터 계정 인증된 전화번호가 필요합니다. 2단계에서 API 접근 권한을 신청하려면 이 번호가 필요합니다.
에 대한 30~45분 처음 시도할 때 그렇습니다. 대부분은 X 개발자의 승인을 기다리는 시간인데, 보통 즉시 처리됩니다.
⚠️
비용 관련 유의사항: X/Twitter API 기본 요금제는 월 $100이며, 프로그램으로 트윗을 게시하려면 필수입니다. 무료 요금제는 읽기 전용이며 사용에 제한이 있습니다. 이 글에서는 트위터 API를 직접 사용하지 않고 OpenTweet(7일 무료 체험 후 월 $5.99)을 브리지로 활용하는 해결 방법을 다룹니다.
1
설치
컴퓨터에 OpenClaw를 설치하세요

OpenClaw를 설치하는 가장 빠른 방법은 다음을 이용하는 것입니다. 올라마, 이 프로그램은 전체 설정을 자동으로 처리합니다. 터미널(Mac) 또는 명령 프롬프트(Windows)를 열고 다음 명령 하나만 실행하세요.

단말기
올라마 런치 오픈클로

Ollama는 시스템에 OpenClaw가 설치되어 있지 않으면 자동으로 설치합니다. 설치가 완료되면 OpenClaw가 터미널에서 열리고 바로 채팅을 시작할 수 있습니다.

아직 Ollama가 설치되어 있지 않다면 먼저 설치하세요. 올라마닷컴 — 원클릭 설치 프로그램입니다. 설치 후 위의 명령어를 실행하세요.

설치 후 OpenClaw는 사용자에게 다음을 요청합니다. 모델을 구성하세요. 요청 메시지가 나타나면 AI API 키를 입력하십시오.

OpenClaw 설정 프롬프트
# OpenClaw에서 모델 API 키를 요청할 때: OpenAI용 #(GPT-4): OPENAI_API_KEY=여기에 AI 키를 입력하세요# 또는 Anthropic(Claude - 추천)용: ANTHROPIC_API_KEY=여기에 당신의 인류학적 열쇠를 새겨넣으세요

설정이 완료되면 다음과 같은 간단한 메시지를 입력하여 모든 것이 제대로 작동하는지 테스트하십시오. 안녕하세요 터미널에 명령어를 입력하세요. OpenClaw가 응답하면 2단계로 넘어갈 준비가 된 것입니다.

💡
OpenClaw는 모든 것을 로컬에 저장합니다. ~/.openclaw/ 컴퓨터의 이 폴더에 대화 내용, 추억, 설정 등이 모두 저장됩니다. 클라우드에는 아무것도 저장되지 않습니다.
2
API 액세스
X/트위터 API 액세스 설정

X의 $100/월 API를 직접 사용하는 대신, 우리는 다른 방법을 사용하겠습니다. 오픈트윗 OpenTweet은 OpenClaw 에이전트에 트윗을 게시할 수 있는 간단한 API 키를 제공하는 다리 역할을 합니다. 실제 트위터 계정 정보는 OpenTweet 서버를 벗어나지 않으므로 훨씬 안전합니다.

1
로 가다 오픈트윗.io 무료 계정을 만드세요. 7일 무료 체험 기간 동안 모든 기능을 이용할 수 있으며, 신용카드 정보는 사전 입력할 필요가 없습니다.
2
온보딩 중에 클릭하세요 “X 계정에 연결하세요.” 그러면 공식 X OAuth 흐름이 열립니다. 이는 어떤 앱이든 트위터에 연결할 때 보게 되는 것과 동일한 로그인 화면입니다. X 자격 증명으로 로그인하세요. 이것이 바로 그겁니다. 오직 이제 트위터 비밀번호를 직접 사용하게 될 것입니다.
3
연결 후, 다음으로 이동하세요. OpenTweet 대시보드 → API 키 → 새 키 생성.
4
API 키를 복사하세요. (키는 다음과 같습니다.) ot_a1b2c3d4e5f6... (48자). 안전한 곳에 보관하세요. 한 번만 나옵니다.
⚠️
페이지를 닫지 마세요 API 키를 복사하기 전까지는 이 방법을 사용할 수 있습니다. API 키를 분실한 경우에는 OpenTweet 대시보드에서 새 API 키를 생성해야 합니다.
3
스킬 설치
ClawHub를 통해 Twitter 스킬을 설치하세요.

OpenClaw는 외부 서비스에 연결하기 위해 "스킬"을 사용합니다. 마치 스마트폰에 설치하는 앱과 같다고 생각하면 됩니다. ClawHub는 공식 스킬 마켓플레이스입니다. 여기서는 OpenClaw가 X와 통신하는 방법을 알려주는 OpenTweet 스킬을 설치하겠습니다.

터미널에서 다음 명령어를 실행하세요:

터미널 — 트위터 스킬 설치
clawhub install openclaw/skills/twitter

ClawHub는 스킬을 자동으로 다운로드하고 설치합니다. 설치가 완료되면 확인 메시지가 표시됩니다. 새 스킬을 로드하려면 OpenClaw를 다시 시작하세요.

단말기
오픈클로 재시작
수동 설정을 선호하시나요? 다음 위치에 폴더를 생성하세요: ~/.openclaw/skills/twitter/, 추가하세요 스킬.md OpenTweet API 문서가 포함된 파일을 생성한 다음 OpenClaw를 재시작하십시오. 위의 ClawHub 메서드는 이 작업을 자동으로 수행합니다.
4
구성
OpenTweet API 키를 OpenClaw에 추가하세요

이제 OpenClaw에 트위터 API 자격 증명의 위치를 알려주세요. OpenClaw 설정 파일을 엽니다.

터미널 — 설정 파일 열기
# 맥/리눅스: 나노 ~/.openclaw/openclaw.json# 윈도우: 메모장 %USERPROFILE%\.openclaw\openclaw.json

찾으세요 ""기미"" 해당 섹션을 추가하고(없으면 추가) OpenTweet API 키를 입력하세요.

~/.openclaw/openclaw.json
{ ""모델"": ""클로드-3-5-소네트"", ""기미"": { ""OPENTWEET_API_KEY"": ""ot_a1b2c3d4e5f6여기에 키를 입력하세요"" } }

파일을 저장하고 OpenClaw를 다시 시작하십시오. 자격 증명이 제대로 작동하는지 확인하려면 인증 확인 명령을 실행하십시오.

터미널 — 연결 확인
twclaw 인증 확인

초록색으로 확인 메시지가 표시될 것입니다. ✓ @yourusername으로 X에 연결되었습니다. 오류가 발생하면 API 키를 공백 없이 정확하게 복사했는지 다시 확인하십시오.

💡
그만큼 기미 openclaw.json 파일의 해당 섹션은 어떤 AI 모델로도 전송되지 않고, 사용자의 컴퓨터에 저장됩니다. API 키는 트윗을 게시할 때 OpenTweet 서버와의 인증에만 사용됩니다.
5
첫 번째 트윗
OpenClaw로 첫 트윗을 올려보세요

연결되었습니다. 이제 게시글을 작성해 보겠습니다. OpenClaw 터미널에서 자연어를 사용하거나 다음 명령어를 사용할 수 있습니다. 트워클로 직접 명령하세요.

옵션 A — 자연어 처리(가장 쉬움): OpenClaw에게 무엇을 해야 할지 알려주기만 하면 됩니다.

오픈클로 채팅
"AI 에이전트를 설정해서 X에 자동으로 게시글을 올리도록 했습니다. 미래는 이미 여기에 있습니다. 🤖"라고 트윗하세요."

OpenClaw는 게시하기 전에 확인합니다. 입력하세요. 확인하겠습니다.

옵션 B — 직접 명령:

터미널 — 바로 게시
twclaw님이 "AI 에이전트를 설정해서 X에 자동으로 글을 올리도록 했습니다. 미래는 이미 여기에 있습니다. 🤖"라고 게시했습니다."

X 프로필을 확인하세요. 트윗은 몇 초 안에 나타날 것입니다.

타임라인을 읽고, 트윗을 검색하고, 멘션을 확인할 수도 있습니다.

터미널 - 기타 명령
# 홈 타임라인(최근 20개 트윗)을 읽어보세요 트워클로 홈 -n 20# 멘션을 확인하세요 twclaw는 -n 10을 언급합니다.# 키워드로 트윗 검색 트워클로 검색 ""AI 영화 제작"" --최근의# 다른 사람의 프로필 보기 twclaw 사용자 @핸들# 특정 트윗 읽기 트워클로 읽기 트윗 URL 또는 ID
6
오토메이션
OpenClaw를 사용하여 자동 트윗 예약하기

OpenClaw의 진정한 강점은 일회성 트윗이 아니라 게시 일정을 완벽하게 자동화하는 데 있습니다. 반복적인 콘텐츠 워크플로를 설정하는 방법을 알아보겠습니다.

특정 시간에 트윗을 게시하도록 예약하세요:

오픈클로 채팅
내일 오전 9시에 "새 블로그 게시물이 올라왔습니다. 프로필 링크를 확인하세요 🔗"라는 트윗을 예약 게시하세요."

매일 콘텐츠를 시청하는 루틴을 설정하세요: 편집하기 소울.md 파일 — 이 파일은 OpenClaw가 시작될 때마다 읽는 파일로, 마치 고정된 지침 문서와 같습니다.

~/.openclaw/SOUL.md — 다음 줄을 추가하세요
## 일일 트위터 루틴매일 아침 9시: - AI 창의성 또는 영화 제작에 관한 독창적인 트윗 하나를 게시합니다. - 200자 이내로 작성합니다. - 대화체로 호기심 어린 어조를 사용합니다. - 주제가 트렌드인 경우를 제외하고는 해시태그를 포함하지 않습니다. 매주 금요일 오후 5시: - 이번 주에 만든 콘텐츠를 요약한 짧은 주간 회고 트윗을 게시합니다.

파일을 저장하세요. 이제부터 OpenClaw가 실행될 때마다 이 지침이 자동으로 적용됩니다.

꿀팁: SOUL.md 파일에 구체적인 지침을 입력할수록 결과물의 정확도가 높아집니다. 브랜드 보이스, 관심 있는 주제, 절대 게시하고 싶지 않은 내용, 그리고 원하는 서식 등을 포함해 주세요. OpenClaw는 매 세션마다 이 파일을 새로 읽어들입니다.

스레드를 생성하고 게시하세요:

오픈클로 채팅
2026년 인공지능이 인디 영화 제작에 어떤 변화를 가져올지에 대한 5개의 트윗으로 구성된 스레드를 작성하세요. 대화체로 쓰고, 흥미로운 내용을 먼저 제시하며, 지금 바로 게시하세요.

OpenClaw는 전체 스레드 초안을 작성하여 검토를 위해 사용자에게 보여주고, 사용자가 확인하면 X에 게시합니다.

일반적인 문제점
문제 해결

대부분의 문제는 다음 세 가지 문제 중 하나로 귀결됩니다.

twclaw auth-check에서 "잘못된 API 키"가 반환됩니다.“
OpenTweet API 키가 올바르게 저장되지 않았습니다. 열기 ~/.openclaw/openclaw.json 다음 사항을 확인하십시오. (1) 키가 따옴표 안에 있는지, (2) 불필요한 공백이 없는지, (3) 키가 ~로 시작하는지 ot_. 필요한 경우 OpenTweet 대시보드에서 새 키를 생성하세요.
OpenClaw는 twclaw 명령어를 알지 못합니다.
트위터 스킬이 로드되지 않았습니다. 실행하세요. clawhub install openclaw/skills/twitter 다시 한번 확인하고 OpenClaw가 재시작되었는지 확인하십시오. 오픈클로 재시작. 설치된 스킬은 다음을 통해 확인할 수 있습니다. 오픈클로 스킬 목록.
트윗은 게시되었지만 X 프로필에는 나타나지 않았습니다.
OpenTweet 대시보드를 확인해 보세요. 게시물이 대기열에 있을 수 있습니다. 또한 X 계정이 제한 모드가 아닌지 확인하세요(설정 → 개인정보 및 보안 → 대상 및 태그). 새 계정의 경우 X에서 첫 API 게시물 업로드가 몇 분 정도 지연될 수 있습니다.
OpenClaw에서 예약 트윗이 실행되지 않습니다.
예약된 작업은 OpenClaw가 활발하게 실행 중일 때만 실행됩니다. OpenClaw 프로세스가 백그라운드에서 계속 실행되도록 하세요. Mac에서는 다음 명령어를 사용할 수 있습니다. 브루 서비스 시작 오픈클로 로그인 시 자동으로 시작되는 백그라운드 서비스로 실행합니다.
twclaw 홈을 사용할 때 X 피드가 비어 있는 것처럼 보입니다.
X의 타임라인은 JavaScript로 렌더링되고 로그인해야 접근할 수 있도록 설계되어 있어 간단한 API 읽기가 불가능합니다. 실시간 피드를 보려면 OpenClaw 브라우저 릴레이를 사용하세요. Chrome 확장 프로그램을 설치하면 됩니다. docs.openclaw.ai/tools/chrome-extension, 로그인한 상태에서 x.com을 열고 OpenClaw 확장 프로그램 아이콘을 클릭하여 해당 탭에 연결하세요.