## Intro - OpenClaw는 Single Agent로 사용해도 할 수 있는 것이 많지만, 진짜 사람처럼 각자의 SOUL을 가지고 행동하는 Multi-Agent와 함께할 때 빛을 발하는 것 같다.✨ - 그래야 사용하는 나도 좀 더 체계적으로 일이 진행되는 상황도 확인할 수 있고 더 구체적으로 작업지시를 할 수 있어서 그렇다. (+ 그리고 재밌다.😁) - 이번 튜토리얼은 **[1편](https://peters.place/ko/post/openclaw)에서 세팅했던 Slack 세팅이 끝났다는 전제하에 진행**한다! 😎
## 1. Agent 생성하기 🪄 - 먼저 Agent는 아래 명령어로 생성해보자. ```bash openclaw agents add your_agent_name ``` - 나는 보안을 담당하는 플랑크톤🦠을 만들것이기 때문에 CISO Agent를 추가해봤다. 명령어를 실행하면 아래와 같이 workspace directory를 알아서 네이밍해준다. 이름은 바꿔도 되지만 많이 생성할수록 편의를 위해 이대로 두는 것을 추천.
![image|600](https://pub-08bdc1f395e14377951ac0c9c22ba795.r2.dev/posts/user_38T3Ty5uKeRndW9PUwTFHGYZxwP/auggrdsbi4v-image.webp) - OpenClaw는 Default로 가장 기본 Workspace로 `.openclaw/workspace`를 사용하는데, 모든 Agent는 각자의 고유한 workspace를 사용하기 때문에 `workspace-{agent}` 형태로 생성하는 것! 🏠 - 이 안에 에이전트의 정체성 담당 - `SOUL.md`,
대화할 때 말투 등의 컨셉을 담당하는 - `IDENTITY.md`
대화할 때마다 꼭 기억하고 있어햐 할 것들을 정리한 `MEMORY.md`
등의 파일들이 에이전트의 고유한 성질이 된다. :) - 다음으로 넘어가면 아래와 같이 `Copy auth profiles from "ceo"?`라고 나오는데, ceo는 가장 최초에 설치한 default agent를 의미해서 이름은 각자 다를 수 있다. - 즉, 이 부분이 의미하는 것은 **'가장 최초의 에이전트가 즉 사용하는 AI모델의 Provider(Ollama, Anthropic, Codex 같은거)의 인증정보(auth)를 복사해서 똑같이 설정하겠냐'** 는 말이다. 별도의 Provider 인증을 설정할 것이 아니라면 `Yes`. (튜토리얼의 진행 편의를 위해 Yes를 선택했다 가정하고 진행.👾) ![image|550](https://pub-08bdc1f395e14377951ac0c9c22ba795.r2.dev/posts/user_38T3Ty5uKeRndW9PUwTFHGYZxwP/aul6xw8em3t-image.webp) - 그 다음에는 나오는 질문에는 기존에 처음 설치했던 것처럼 아래와 같이 쭉쭉 진행해주자.
![image|500](https://pub-08bdc1f395e14377951ac0c9c22ba795.r2.dev/posts/user_38T3Ty5uKeRndW9PUwTFHGYZxwP/t1oci5o8e5g-image.webp) - 그 다음 아래와 같이 Configure chat chnnels는 `Yes`.
![image|450](https://pub-08bdc1f395e14377951ac0c9c22ba795.r2.dev/posts/user_38T3Ty5uKeRndW9PUwTFHGYZxwP/4ykbiydtvzg-image.webp) - 그러면 아래와 같이 channel은 `Slack (Socket Mode)`, 그 다음 질문은 `Skip`(저번 글에서 다 설정해놨으니까)을 누르면 끝!
![image|600](https://pub-08bdc1f395e14377951ac0c9c22ba795.r2.dev/posts/user_38T3Ty5uKeRndW9PUwTFHGYZxwP/5meyl0ye5uf-image.webp) - 다시 `Select a channel` 질문이 나올텐데 제일 아래에 `Finished`를 눌러주자. 아래와 같이 `Agent "your-agent" ready.`가 나왔다면 설정이 잘 된 것이다.🙌
![image|500](https://pub-08bdc1f395e14377951ac0c9c22ba795.r2.dev/posts/user_38T3Ty5uKeRndW9PUwTFHGYZxwP/hjchub5sw9v-image.webp) ### Agent 등록 결과 확인하기 🕺 - `~/.openclaw/agents/` 하위를 확인해보면, 아래와 같이 ciso라는 폴더가 생긴 것을 확인할 수 있다.agent, sessions 폴더가 보인다. 👀
- agent 폴더에는 사용하는 LLM의 auth 정보가, sessions 폴더에는 대화한 세션의 내용이 저장된다. ![image|400](https://pub-08bdc1f395e14377951ac0c9c22ba795.r2.dev/posts/user_38T3Ty5uKeRndW9PUwTFHGYZxwP/xmnm189lsie-image.webp) - 또 한가지 확인할 수 있는 변경사항은 바로, 별도의 workspace가 생겼다는 것이다.!
![image|300](https://pub-08bdc1f395e14377951ac0c9c22ba795.r2.dev/posts/user_38T3Ty5uKeRndW9PUwTFHGYZxwP/7nzdlz7nqni-image.webp) - 이 안을 살펴보면, `SOUL.md`, `IDENTITY.md` 등이 보인다. 이 파일들은 직접 작성해서 넣어줘도 좋고, 1편에서 처음으로 오픈클로 Agent를 만들었을 때 했던 것처럼, 만든 에이전트와 첫 대화를 하면서 스스로 채워넣게 만들 수도 있다. - 일단 이 튜토리얼에서는 나중에 연결을 끝내고 난 뒤 Slack에서 대화하면서 자동생성하기로 한다! ✔️ - SOUL.md, IDENTITY.md만 원하는 내용으로 수정해서 채워넣었다면, BOOTSTRAP.md는 삭제해줘야 처음 대화할 때 에이전트가 사용자에게 SOUL.md, IDENTITY.md에 넣을 내용을 질문하지 않는다. 참고..! 📜 - 마지막으로 `~/.openclaw/openclaw.json`의 **agents.list** 부분을 확인해보면 아래와 같이 자동으로 등록이 되어 있을 것이다. ~~~json ... "agents": { "list": [ ... { "id": "ciso", "name": "ciso", "workspace": "/Users/peter/.openclaw/workspace-ciso", "agentDir": "/Users/peter/.openclaw/agents/ciso/agent" } ... ~~~ ### 그럼 openclaw agent add를 계속 반복해야하나? 🤔 - 여기까지 읽었다면, 이런 생각이 들 수도 있다. ``` 'openclaw agents add 명령어를 추가하고 싶은 에이전트 수 만큼 반복할 필요없이.. 이제부터는 그냥 .openclaw/ 아래에 이렇게 파일을 생성하면 되는거네..?' ``` - 맞다. 😎 그냥 한 번 생성한 것을 내가 만들고 싶은 에이전트만큼 복사하고 이름만 바꿔서 생성해주면 된다! 요약하면 아래와 같다. > [!note] > 1. `~/.openclaw/agents/{agnet_id}` 폴더만들고, 그 아래에 agent, sessions 폴더 생성. > - agent/ 아래에 main agent의 auth-profiles.json까지 복사해서 넣기 > 2. `~/openclaw/workspace-{agnet_id}` 폴더 생성해주기. > - SOUL.md, IDENTITY.md 설정하기. - 나중에 슬랙 채팅으로 자동생성해도 됨.
## 2. Slack App 생성하기 👾 - Slack App은 [1편](https://www.peters.place/ko/post/openclaw#2-slack-bot-%EB%A7%8C%EB%93%A4%EA%B8%B0-)에서 나왔던 대로 그대로 진행하면 된다! **`xoxb-` 시작하는 봇 토큰과, `xapp-`으로 시작하는 앱 토큰값**을 잘 옮겨 적어놓고, 앱 생성을 완료하자! 😀 - 앱 생성 + Slack 채널에 설치까지 완료하자.👏
![image|500](https://pub-08bdc1f395e14377951ac0c9c22ba795.r2.dev/posts/user_38T3Ty5uKeRndW9PUwTFHGYZxwP/eb9kn5wyga8-image.webp)
## 3. openclaw.json 설정하기 🔧 - 자 이제 거의 다 왔다! ~/.openclaw/openclaw.json만 추가로 좀 더 손봐주면 된다! 👊 ### 3.1. `agents.list`에 에이전트 등록하기 ✍️ - 아래와 같이 이제 만든 agent를 등록해주자! 아래와 같이 `agents.list` 안에 만든 에이전트를 `{ "id" : "ciso", ... }`의 object로 넣어주면 된다.🧑🏻‍💻 - 이렇게 설정하면, `subagents.allowAgents` [ ] 안에 적힌 다른 에이전트를 SubAgent로 사용해서 태스크를 던지고(spawn) 태스크 완료 후 결과를 받을 수 있게 설정할 수 있다. - `"*"`를 사용하면 모든 다른 에이전트에게 위임할 수 있다는 말이고, 모두가 아니라 지정하고 싶다면 아래 예시와 같이 지정해서 선택하면 된다.✔️ ```json ... "agents": { "list": [ { "id": "ceo", "subagents": { "allowAgents": ["*"] } }, ... { "id": "cto", "subagents": { "allowAgents": ["cpo", "cro", "cqo", "ciso"] } }, { "id": "ciso", "name": "ciso", "workspace": "/Users/peter/.openclaw/workspace-ciso", "agentDir": "/Users/peter/.openclaw/agents/ciso/agent", "subagents": { "allowAgents": ["cto", "cqo"] } } ] }, ... ``` ### 3.2. `tools.agentToAgent` 등록하기 - 이번에는 `tools.agentToAgent`를 찾아보자. **이 설정을 하면, 에이전트끼리 대화를 할 수 있다.** 아래와 같이 내가 만든 에이전트의 이름을 list 안에 넣어주자!✨ ```json ... "tools": { ... "agentToAgent": { "enabled": true, "allow": ["ceo", "cpo", "cto", "cro", "cqo", "pa", "ciso"] } }, ... ``` ### 3.3. `channels.slack.accounts` 설정하기 📋 - 아래와 같이 openclaw.json에서 `channels.slack.accounts`를 찾고 accounts 안에 내가 만든 agent를 아래와 같이 등록해주자. 이때 내가 옮겨 적어놨던 봇 토큰과 앱 토큰 사용! ~~~json ... "channels": { "slack": { "accounts": { "ciso-bot": { "botToken": "xoxb-10643383597685-10749610887078-blah-blah", "appToken": "xapp-1-A0AMX6WCVD1-10751649797730-blah-blah", "userTokenReadOnly": true, "streaming": "partial", "nativeStreaming": true }, ... ~~~

.env 👉 openclaw.json 설정하기

- 원래 botToken과, appToken의 경우 아래와 같이 바로 해당하는 토큰을 적으면 되는 구조인데, ~~~json ... "ciso-bot": { "botToken": "xoxb-10643383597685-10643383597685-A0AMXBWNCNP", "appToken": "xapp-1-A0AMXBWNCNP-A0AMXBWNCNP-A0AMXBWNCNPA0AMXBWNCNP", ... } ... ~~~ - **언젠가 다른 장비로 OpenClaw 환경을 옮길 것을 대비**(~~갖고싶다 Mac mini..~~)해서, 필자는 .env파일에 각 봇 토큰, 앱 토큰을 넣고 OpenClaw가 봇 토큰을 자동으로 읽어와서 넣어주고, openclaw.json은 git에 업로드 할 수 있게 설정했다. - 그러려면, 아래 명령어인 `openclaw config set`을 실행해서 openclaw가 해당 환경변수를 읽었을 때 .env에서 읽어올 수 있도록 해야한다. ```bash openclaw config set channels.slack.accounts.ciso-bot.botToken \ --ref-provider default --ref-source env --ref-id CISO_BOT_TOKEN openclaw config set channels.slack.accounts.ciso-bot.appToken \ --ref-provider default --ref-source env --ref-id CISO_APP_TOKEN ``` - 아래처럼 실행하면 `openclaw.json` 세팅이 된다.✨ 참고하시길!
![image|600](https://pub-08bdc1f395e14377951ac0c9c22ba795.r2.dev/posts/user_38T3Ty5uKeRndW9PUwTFHGYZxwP/l1squvaidr-image.webp) - 그러면 결론적으로 이렇게 openclaw.json에는 세팅이 된다.
![image|500](https://pub-08bdc1f395e14377951ac0c9c22ba795.r2.dev/posts/user_38T3Ty5uKeRndW9PUwTFHGYZxwP/fmdc0kij0r-image.webp)

### 3.4. `bindings` 로 연결해주기 🔗 - 자, 이제 "agents"에 등록한 OpenClaw id와 Slack Channel Account로 등록한 account id를 이제 맵핑해줄 차례다! 🤠 - 아래와 같이 `bindings` list를 찾아서 그 아래에, '아까 ciso id로 등록한 친구가 slack channel에 있는 ciso-bot이에요~'라고 알려주는 object를 추가해주자. ```json ... "bindings": [ { "agentId": "ceo", "match": { "channel": "slack", "accountId": "ceo-bot" } }, { "agentId": "ciso", "match": { "channel": "slack", "accountId": "ciso-bot" } } ], ... ``` ### 3.5. `channels.slack` 설정하기 🍦 - 끝날 때까지 끝난 것이 아니다.. 여기까지해야 진짜 Multi-Agent끼리 대화하는 것을 내 슬랙 채널에서 만날 수 있다..! 조금만 더 힘을 내자.. 🫠🫠🔥🔥 - 아래와 같이 설정이 되어 있지 않으면 생성한 에이전트가 내 채널에 초대를 해도 대화를 할 수가 없다. 가장 핵심이 되는 설정은 아래와 같다! ```json ... "channels": { "slack": { "mode": "socket", "enabled": true, "userTokenReadOnly": true, "allowBots": true, "requireMention": true, "groupPolicy": "open", "replyToMode": "first", "thread": { "historyScope": "thread", "inheritParent": true, "initialHistoryLimit": 50 }, ... ``` - `allowBots` - 다른 봇이 쓴 메시지도 대화 히스토리에 포함애서 에이전트 간에 협업 시 꼭 필요하기 때문에 항상 true. - `requireMention` - `@`로 태그가 됐을 때만 응답을 하게 설정하는 옵션으로 안하면 채널의 모든 메시지에 봇이 반응하기 때문에 무한루프가 돌 수 있다. 그래서 true로 설정해줘야 한다. - `replyToMode` - 사용자가 말을 걸면 Thread를 생성해서 대화를 하게 하는 방법이다. all을 설정했더니 multiagent가 설정이 되어 있으면 서로 이야기를 하려고 해서, first로 세팅하는 것을 추천. - off — 스레드를 사용하지 않고 채널에 직접 응답. - first — 사용자의 첫 번째 메시지에 대한 스레드로 응답. - all — 모든 메시지에 대해 스레드로 응답. - `groupPolicy` - 'open'으로 설정하면 모든 채널에 다 들어갈 수 있다. 'allowlist'로 설정한다면 아래와 같이 추가로 'channels'를 하나 더 선언해줘서, 접속할 수 있는 채널을 명시를 해줘야한다. ```json ... "channels": { "slack": { ... "groupPolicy": "allowlist", "channels": { "C07XXXXXX01": { "allow": true, "requireMention": true, "allowBots": true // 👈 false 로 설정하면 }, // 다른 봇들의 메시지를 무시하고 "C07XXXXXX02": { // 사람이 @멘션 한 것만 처리 "allow": true, "requireMention": false }, ``` --- > [!note] > - 4.2 버전 이후 업데이트로 이전에 잘 되던 설정도 갑자기 안되는 이슈가 있었다. 아래와 같이 각각의 bot 설정에도 위 설정을 해줘야 제대로 작동한다..!👾 ```json ... "channels": { "slack": { ... "cto-bot": { "botToken": "${CTO_BOT_TOKEN}", "appToken": "${CTO_APP_TOKEN}", "userTokenReadOnly": true, "streaming": { "mode": "partial", "nativeTransport": true }, "allowBots": true, // 여기부터, "enabled": true, "groupPolicy": "open", "historyLimit": 20, "mode": "socket", "reactionNotifications": "all", "replyToMode": "first", "requireMention": true // 여기까지 추가하기! }, ... ```
## 4. 잘 설정됐는지 확인하기! 🥺 - 아래 명령어를 실행해보고 마지막으로 잘 연결됐는지 확인해보자..! - Gateway 재시작 후 아래 두 명령어로 확인해볼 수 있다. ```bash openclaw gateway restart openclaw agents list --bindings openclaw channels status --probe ``` - openclaw agents list --bindings 를 실행하면 아래와 같이 결과가 나온다. - 아래의 경우 ciso에 아직 `IDENTITY.md`, `SOUL.md`를 설정해주지 않아서 이모지가 나오고 있지 않다.
![image|550](https://pub-08bdc1f395e14377951ac0c9c22ba795.r2.dev/posts/user_38T3Ty5uKeRndW9PUwTFHGYZxwP/fj3yqvptpmo-image.webp) - openclaw channels status --probe 실행 결과는 아래와 같다면 잘 설정된 것이다.
![image|700](https://pub-08bdc1f395e14377951ac0c9c22ba795.r2.dev/posts/user_38T3Ty5uKeRndW9PUwTFHGYZxwP/ut0x01nnrlm-image.webp) - 자 이제 대화를 하러 슬랙으로 가보자. 🏃 ~~(둨흔둨흔)~~ - 아래와 같이 첫 번째 대화는 pairing을 위한 openclaw pairing approve slack NBLAHBLAH를 그대로 복사해서 터미널에서 실행해준다. 그 다음 말을 걸면, 필자의 경우 위에서 본 것처럼 `replyToMode`를 `first`로 해뒀기 때문에 thread로 댓글을 달아주며 대화가 시작되는데, workspace-ciso 안에 BOOTSTRAP.md 파일을 삭제하지 않았기 때문에 본인의 정체성을 물어보는 대화가 시작된 것을 알 수 있다. ![image](https://pub-08bdc1f395e14377951ac0c9c22ba795.r2.dev/posts/user_38T3Ty5uKeRndW9PUwTFHGYZxwP/pa02g5q6bsk-image.webp) - 방금의 대화로 실제로 workspace-ciso 안에 IDENTITY.md 파일이 업데이트 된 것을 확인할 수 있다.😮
![image](https://pub-08bdc1f395e14377951ac0c9c22ba795.r2.dev/posts/user_38T3Ty5uKeRndW9PUwTFHGYZxwP/6pn3c9k3cg8-image.webp) - 자 이제, 채널로가서 `/invite @your_bot` 으로 초대를 하고, 친구들에게 소개시켜주자! - ⚠️ 대화 안멈춤 주의..ㅎㅎㅎㅎㅎㅎㅎ ![image](https://pub-08bdc1f395e14377951ac0c9c22ba795.r2.dev/posts/user_38T3Ty5uKeRndW9PUwTFHGYZxwP/uq16dgtmea-image.webp)
## 5. So on.. - 혹시 설정을 하다가 이런 에러를 만난다면?? ![스크린샷 2026-03-24 오후 4.30.08|600](https://pub-08bdc1f395e14377951ac0c9c22ba795.r2.dev/posts/user_38T3Ty5uKeRndW9PUwTFHGYZxwP/8ret060g5c6------------2026-03-24------4.30.08.webp) - Session이 꼬여서 그런 것이니 해당 에이전트의 이름 이상한 이런 세션들을 날리고, gateway restart 한 번 해주면 해결된다!
![image](https://pub-08bdc1f395e14377951ac0c9c22ba795.r2.dev/posts/user_38T3Ty5uKeRndW9PUwTFHGYZxwP/o8cw7gn8s9a-image.webp)
## 마무리 🍳 - 이렇게 설정한 친구들과 안전하게 오래오래 가고 싶다. 그러기 위해서 보안🚨은 필수다. 다음 글에서는 OpenClaw 보안 설정에 대하여 알아보자!👮 - 다음 글이 나오기 전에 보안 설정에 대해서 빨리 알고 먼저 공부해서 적용하고 싶다면, [unclejobs.ai](https://www.threads.com/@unclejobs.ai/post/DWQxHITiWNi?xmt=AQF0lGmP9xr-xg80zpDegsUVgZ01SMJJB7SrwM3SScaFfw)님의 포스팅을 보고 스스로 먼저 세팅해보는 것도 추천! 👍
✨HAPPY BUILDING!👷‍♂️ ### References - [OpenClaw](https://docs.openclaw.ai/concepts/multi-agent)

OpenClaw🦞 MultiAgent!

0 comments