OpenProse

OpenProse là một định dạng quy trình làm việc di động, ưu tiên Markdown để điều phối các phiên AI. Trong OpenClaw, định dạng này được cung cấp dưới dạng một Plugin cài đặt gói Skills OpenProse và lệnh gạch chéo /prose. Các chương trình nằm trong tệp .prose và có thể khởi tạo nhiều tác tử con với luồng điều khiển tường minh.

Cài đặt

Bật Plugin OpenProse và khởi động lại Gateway.

Chạy chương trình

Dùng /prose run để thực thi tệp .prose hoặc chương trình từ xa.

Viết chương trình

Xây dựng quy trình làm việc đa tác tử với các bước song song và tuần tự.

​

Cài đặt

1. Bật Plugin

   OpenProse được đóng gói sẵn nhưng mặc định bị tắt. Bật Plugin này:

   openclaw plugins enable open-prose
   
2. Khởi động lại Gateway

   openclaw gateway restart
   
3. Xác minh

   openclaw plugins list | grep prose
   

   Bạn sẽ thấy open-prose đã được bật. Lệnh Skills /prose hiện đã khả dụng trong cuộc trò chuyện.

Từ một bản sao làm việc của kho mã, bạn có thể cài đặt trực tiếp Plugin: openclaw plugins install ./extensions/open-prose

​

Lệnh gạch chéo

OpenProse đăng ký /prose làm lệnh Skills mà người dùng có thể gọi:

/prose help
/prose run <file.prose>
/prose run <handle/slug>
/prose run <https://example.com/file.prose>
/prose compile <file.prose>
/prose examples
/prose update

/prose run <handle/slug> được phân giải thành https://p.prose.md/<handle>/<slug>. Các URL trực tiếp được truy xuất nguyên trạng bằng công cụ web_fetch.

Các lần chạy từ xa ở cấp cao nhất phải được chỉ định tường minh. Các lệnh nhập từ xa bên trong chương trình .prose là những phần phụ thuộc mã có tính bắc cầu: trước khi OpenProse truy xuất bất kỳ đích use từ xa nào, hệ thống sẽ hiển thị danh sách lệnh nhập đã phân giải và yêu cầu người vận hành trả lời chính xác approve remote prose imports cho lần chạy đó.

​

Khả năng

• Nghiên cứu và tổng hợp đa tác tử với cơ chế song song tường minh.
• Quy trình làm việc có thể lặp lại và an toàn nhờ cơ chế phê duyệt (đánh giá mã, phân loại sự cố, quy trình nội dung).
• Các chương trình .prose có thể tái sử dụng và chạy trên nhiều môi trường thực thi tác tử được hỗ trợ.

​

Ví dụ: nghiên cứu và tổng hợp song song

# Research + synthesis with two agents running in parallel.

input topic: "What should we research?"

agent researcher:
  model: sonnet
  prompt: "You research thoroughly and cite sources."

agent writer:
  model: opus
  prompt: "You write a concise summary."

parallel:
  findings = session: researcher
    prompt: "Research {topic}."
  draft = session: writer
    prompt: "Summarize {topic}."

session "Merge the findings + draft into a final answer."
  context: { findings, draft }

​

Ánh xạ môi trường thực thi OpenClaw

Các chương trình OpenProse ánh xạ tới những thành phần cơ bản của OpenClaw:

Khái niệm OpenProse	Công cụ OpenClaw
Khởi tạo phiên / Công cụ tác vụ	sessions_spawn
Đọc / ghi tệp	read / write
Truy xuất web	web_fetch (exec + curl khi cần POST)

Nếu danh sách cho phép công cụ của bạn chặn sessions_spawn, read, write hoặc web_fetch, các chương trình OpenProse sẽ thất bại. Hãy kiểm tra cấu hình danh sách cho phép công cụ.

​

Vị trí tệp

OpenProse lưu trạng thái trong .prose/ thuộc không gian làm việc của bạn:

.prose/
├── .env                      # config (key=value), e.g. OPENPROSE_POSTGRES_URL
├── runs/
│   └── {YYYYMMDD}-{HHMMSS}-{random}/
│       ├── program.prose     # copy of the running program
│       ├── state.md          # execution state
│       ├── bindings/
│       ├── imports/          # nested remote program runs
│       └── agents/
└── agents/                   # project-scoped persistent agents

Các tác tử lưu bền ở cấp người dùng (dùng chung giữa các dự án) nằm tại:

~/.prose/agents/

​

Phần phụ trợ trạng thái

hệ thống tệp (mặc định)

Trạng thái được ghi vào .prose/runs/... trong không gian làm việc. Không yêu cầu phần phụ thuộc bổ sung.

trong ngữ cảnh

Trạng thái tạm thời được giữ trong cửa sổ ngữ cảnh; chọn bằng --in-context. Phù hợp với các chương trình nhỏ, thời gian chạy ngắn.

sqlite (thử nghiệm)

Chọn bằng --state=sqlite. Yêu cầu tệp nhị phân sqlite3 có trong PATH (chuyển về hệ thống tệp khi không tìm thấy); trạng thái được lưu vào .prose/runs/{id}/state.db.

postgres (thử nghiệm)

Chọn bằng --state=postgres. Yêu cầu psql và chuỗi kết nối trong OPENPROSE_POSTGRES_URL (đặt trong .prose/.env).

Thông tin xác thực Postgres sẽ được truyền vào nhật ký của tác tử con. Hãy dùng cơ sở dữ liệu chuyên dụng với đặc quyền tối thiểu.

​

Bảo mật

Hãy coi các tệp .prose như mã nguồn. Xem xét chúng trước khi chạy, bao gồm cả các lệnh nhập use từ xa. Các yêu cầu /prose run https://... cấp cao nhất phải được chỉ định tường minh, nhưng các lệnh nhập từ xa có tính bắc cầu cần được phê duyệt riêng cho từng lần chạy trước khi được truy xuất hoặc thực thi. Sử dụng danh sách cho phép công cụ và các cổng phê duyệt của OpenClaw để kiểm soát tác dụng phụ. Đối với quy trình làm việc có tính tất định và chịu sự kiểm soát của cơ chế phê duyệt, hãy so sánh với Lobster.

​

Liên quan

Tài liệu tham khảo về Skills

Cách gói Skills của OpenProse được tải và các cổng kiểm soát được áp dụng.

Tác tử con

Lớp điều phối đa tác tử nguyên bản của OpenClaw.

Chuyển văn bản thành giọng nói

Thêm đầu ra âm thanh vào quy trình làm việc của bạn.

Lệnh gạch chéo

Tất cả lệnh trò chuyện khả dụng, bao gồm /prose.

Trang web chính thức: https://www.prose.md