BETA 플러그인 워크플로
공유 onemind 플러그인은 모든 지원 호스트에서 BETA를 우선합니다. 상태, 동기화, 승인된 메모리 외에도 프로젝트, Matrix 파일과 교체 승인, 프로젝트 스킬, 제안, 분석, 서버 측 Mind Check, 지침 파일 백업과 Mind 동기화 복원 지점, 통합 관리, 서비스 제어, 서명된 업데이트 안내를 다룹니다. Alpha는 기존 버전으로 유지되며 플러그인이나 CLI 업데이트가 Alpha 앱을 교체하지 않습니다.
OpenClaw, Pi, Hermes는 기존 onemind_status, onemind_sync, onemind_memory와 함께 onemind_read, onemind_action을 제공합니다. operation을 선택하고 arguments에 각 인수를 별도 문자열로 전달하며 workingDirectory에 정확한 대상 프로젝트의 절대 디렉터리를 지정합니다. 읽기와 작업의 구분이 권한을 부여하지는 않습니다. 작업은 사용자의 명시적인 요청 범위에 따라야 합니다. 다른 호스트는 공유 스킬과 지원되는 MCP 또는 터미널 도구를 사용하며 수동 준비 및 Matrix 할당 전용 제한도 유지됩니다.
files.check는 승인을 요청할 수 있고 mind-check는 선택한 증거를 업로드하므로 둘 다 수동적인 읽기가 아닙니다. 검사하고 명시적으로 선택한 백업만 복원하세요. 진행 상황을 출력한 뒤 실패해도 표준 오류와 실패 상태를 유지합니다. 시간 초과나 일부 출력은 성공을 증명하지 않습니다. 공개 CLI/MCP 작업이 없는 관리 기능은 BETA 웹 또는 앱에서 수행합니다.
onemind 에이전트
onemind 에이전트는 모든 활성 계정의 Matrix에서 사용할 수 있는 클라우드 전용 팀 에이전트입니다. 임의의 Matrix 작업에서 대화를 시작하면 작업을 만들고, AI 도구에 작업을 할당하고, 대기 중인 도구 인터랙션에 답변하고, Mind를 관리하고, 동기화를 요청할 수 있습니다. 에이전트는 기기에서 코드를 실행하거나 파일을 편집하거나 명령을 실행하지 않으며 모든 작업은 배정된 도구에서 이루어집니다.
에이전트는 작업, Project, 메모리, Mind, 동기화, 분석을 다루는 28개의 카탈로그 작업을 제공합니다. interactions.answer 작업을 사용하면 기기 소유자(또한 작업 생성자)가 실행 중인 작업을 중단하지 않고 대기 중인 도구 질문이나 권한 요청에 답변할 수 있습니다. 레코드를 지정하는 작업은 제안 바인딩 방식으로 처리됩니다. 에이전트는 검토를 위한 작업 카드를 제공하기 전에 정확한 레코드를 해결합니다. Matrix 작성기에서 /answer를 사용하면 interactions.answer에 바로 접근할 수 있습니다. 전체 참조는 onemind 에이전트를 참고하세요.
BETA Mind 생성 및 업데이트
onemind minds list --json과 onemind minds show MIND_ID --json으로 Mind를 확인합니다. 생성 명령은 onemind minds create --id ID --name NAME --key KEY --purpose TEXT --file PATH --idempotency-key KEY [--project PROJECT_ID] --json입니다. 관리자가 생성한 콘텐츠는 즉시 활성화되며 프로젝트를 생략하면 미할당 상태로 유지됩니다.
업데이트 명령은 onemind minds update MIND_ID --file PATH --title TEXT --expected-version N --expected-source-hash HASH --json이며 읽기 결과의 mind.headVersion.version과 mind.headVersion.sourceHash를 그대로 사용해야 합니다. 선택 사항인 --details와 --file-name은 제안 설명과 후보 파일명을 지정합니다. 프로젝트에 연결된 Mind가 필요하며 Safe Check와 검토에 제출할 뿐 게시하지 않습니다. 결과가 불확실하면 동일한 생성 키와 업데이트 내용을 재사용하고 기준 버전 충돌 시 중단하여 해결하세요. UTF-8 파일을 사용하며 생성 README는 8,000자, 업데이트는 512 KiB로 제한됩니다.
플러그인은 minds.list, minds.show, minds.create, minds.update를 제공합니다. 대응하는 MCP 도구는 one_mind_list_minds, one_mind_get_mind, one_mind_create_mind, one_mind_update_mind이며 onemind.minds.read와 onemind.minds.write의 별도 동의가 필요합니다. 기존 설치에서 사용하려면 대응하는 서버·CLI·플러그인의 게시 및 재연결이 필요합니다.
BETA 0.4.15의 15개 MCP 소스 도구 목록에 이 4개 Mind 도구가 포함됩니다. 기존 연결에는 onemind.minds.read / onemind.minds.write의 새 동의가 필요합니다. 호스트가 목록을 갱신하지 않거나 권한 부족을 보고하면 다시 연결하세요. 릴리스 게시만으로 현재 세션 상태를 증명할 수는 없습니다.
MCP 도구 및 권한
onemind MCP 서버는 연결된 AI 도구가 상태와 메모리를 읽고, 동기화를 요청하고, 프로젝트를 관리하고, 프로젝트 파일 할당을 확인할 수 있는 도구를 제공합니다. 각 도구에는 동의 권한이 하나씩 필요하며, 워크플로에 필요한 권한만 부여하세요. 인증 단계는 로그인 및 계정 > CLI 또는 AI 도구 인증을 참고하세요.
| 도구 | 기능 | 필요 권한 |
|---|---|---|
| 동기화 상태 가져오기 | 현재 기기 동기화 및 서비스 상태를 읽음 | 기기 및 AI 도구 동기화 상태 읽기 |
| 메모리 가져오기 | 승인된 공유 팀 메모리를 읽음 | Matrix에서 승인한 AI 메모리 읽기 |
| 동기화 요청 | 연결된 기기에 동기화를 요청함 | 연결된 기기에 동기화 요청 |
| 프로젝트 목록 가져오기 / 프로젝트 가져오기 | 프로젝트를 목록 조회하거나 세부 정보를 읽음 | Matrix 프로젝트 및 대기 중인 편집 읽기 |
| 프로젝트 생성 / 프로젝트 업데이트 | 프로젝트를 생성하거나 업데이트 제안을 제출함 | 프로젝트 생성 및 프로젝트 편집 제출 |
| 프로젝트 업데이트 결정 | 대기 중인 프로젝트 업데이트 제안을 승인하거나 거부함 | 대기 중인 프로젝트 편집 승인 또는 거부 |
| Mind 목록 가져오기 / Mind 가져오기 | Mind 세부 정보 및 버전을 목록 조회하거나 읽음 | BETA Mind, 승인된 콘텐츠 및 대기 중인 업데이트 읽기 |
| Mind 생성 / Mind 업데이트 | Mind를 생성하거나 Mind 업데이트 제안을 제출함 | 활성 BETA Mind를 즉시 생성하고 콘텐츠 업데이트를 검토에 제출 |
| 프로젝트 파일 최신 상태 확인 | 로컬 파일의 해시를 원격 할당과 비교함 | 할당된 프로젝트 파일의 최신 상태 및 새로 고침 상태 확인 |
| 프로젝트 파일 새로 고침 상태 가져오기 | 대기 중인 새로 고침 요청의 관리 상태를 읽음 | 할당된 프로젝트 파일의 최신 상태 및 새로 고침 상태 확인 |
| 프로젝트 파일 새로 고침 요청 | 오래된 파일을 교체하기 위한 기기 범위 승인 요청을 생성함 | 할당된 프로젝트 파일 새로 고침 승인 요청 |
이러한 MCP 도구 중 어느 것도 로컬 파일을 직접 기록하지 않습니다. 파일 교체는 대상 기기의 별도 승인된 워크플로를 통해 이루어집니다.
OpenClaw, Pi, Hermes Agent용 플러그인 작업
OpenClaw, Pi, Hermes Agent는 모든 OneMind 작업을 두 가지 플러그인 도구인 읽기 작업용 onemind_read와 실행 작업용 onemind_action을 통해 처리합니다. operation을 이름으로 선택하고, arguments에 각 인수를 별도 문자열로 전달하며, workingDirectory에 정확한 절대 경로를 지정합니다. 읽기와 실행의 구분이 권한을 부여하지는 않습니다. 실행 작업은 사용자의 명시적인 요청 범위에 따라야 합니다.
플러그인은 읽기 작업 23개와 실행 작업 34개로 총 57개의 작업을 제공합니다.
읽기 작업 (23개): 도움말 및 버전 정보, 기기 상태, 세션 상태, 팀 메모리, 검토 대기열, 업데이트 확인, 업데이트 안내, 서비스 상태, 동기화 분석 상태, 기기 및 팀 동기화 상태, 프로젝트 목록 및 세부 정보, 파일 목록, 스킬 상태 및 해결, Mind 백업 목록, 동기화 백업 목록, 통합 목록 및 상태, Mind 목록 및 세부 정보를 포함합니다.
실행 작업 (34개): 동기화, 분석 제어(켜기, 끄기, 지금), 서비스 관리(설치, 시작, 중지, 제거), 프로젝트 생성·편집·승인·거부, 파일 확인·업로드·다운로드·삭제, 스킬 설치·업데이트·제거, 백업에서 Mind 복원, 동기화 백업 복원, 서버 측 Mind Check를 위한 증거 업로드, 이벤트 제안, 제안 승인 및 거부, 일반 Project 대상 감지(OneMind에서 선택하기 전까지 비활성 상태 유지), 세션 검증, 통합 설치·업데이트·복구·제거, Mind 생성 및 업데이트를 포함합니다.
files.check는 서버 측 승인 요청을 생성하거나 재사용할 수 있고, mind-check는 선택한 증거를 업로드하므로 둘 다 수동적인 읽기가 아닙니다. 검사하고 명시적으로 선택한 백업만 복원하세요. 공개 CLI, MCP, 플러그인 작업이 없는 관리 기능은 BETA 웹 또는 앱에서 수행합니다.