Containers
ClawDock
ClawDock là một lớp trình trợ giúp shell nhỏ dành cho các bản cài đặt OpenClaw dựa trên Docker.
Nó cung cấp các lệnh ngắn như clawdock-start, clawdock-dashboard và clawdock-fix-token thay cho các lệnh gọi docker compose ... dài hơn.
Nếu bạn chưa thiết lập Docker, hãy bắt đầu với Docker.
Cài đặt
mkdir -p ~/.clawdock && curl -sL https://raw.githubusercontent.com/openclaw/openclaw/main/scripts/clawdock/clawdock-helpers.sh -o ~/.clawdock/clawdock-helpers.shecho 'source ~/.clawdock/clawdock-helpers.sh' >> ~/.zshrc && source ~/.zshrcNếu trước đây bạn đã cài đặt ClawDock từ scripts/shell-helpers/clawdock-helpers.sh, hãy cài đặt lại từ đường dẫn hiện tại scripts/clawdock/clawdock-helpers.sh; đường dẫn GitHub thô cũ đã bị xóa.
Các trình trợ giúp tự động phát hiện thư mục mã nguồn OpenClaw của bạn trong lần sử dụng đầu tiên (bằng cách kiểm tra các đường dẫn phổ biến như ~/openclaw, ~/projects/openclaw) và lưu kết quả vào bộ nhớ đệm tại ~/.clawdock/config. Hãy tự đặt CLAWDOCK_DIR nếu thư mục mã nguồn của bạn nằm ở nơi khác.
Các tính năng được cung cấp
Thao tác cơ bản
| Lệnh | Mô tả |
|---|---|
clawdock-start |
Khởi động Gateway |
clawdock-stop |
Dừng Gateway |
clawdock-restart |
Khởi động lại Gateway |
clawdock-status |
Kiểm tra trạng thái container |
clawdock-logs |
Theo dõi nhật ký Gateway |
Truy cập container
| Lệnh | Mô tả |
|---|---|
clawdock-shell |
Mở shell bên trong container Gateway |
clawdock-cli <command> |
Chạy các lệnh CLI của OpenClaw trong Docker |
clawdock-exec <command> |
Thực thi một lệnh tùy ý trong container |
Giao diện web và ghép nối
| Lệnh | Mô tả |
|---|---|
clawdock-dashboard |
Mở URL của giao diện điều khiển |
clawdock-devices |
Liệt kê các yêu cầu ghép nối thiết bị đang chờ |
clawdock-approve <id> |
Phê duyệt một yêu cầu ghép nối |
Thiết lập và bảo trì
| Lệnh | Mô tả |
|---|---|
clawdock-fix-token |
Ghi token Gateway vào cấu hình container |
clawdock-update |
Kéo bản mới, dựng lại và khởi động lại |
clawdock-rebuild |
Chỉ dựng lại ảnh Docker |
clawdock-clean |
Xóa các container và ổ đĩa |
Tiện ích
| Lệnh | Mô tả |
|---|---|
clawdock-health |
Chạy kiểm tra tình trạng Gateway |
clawdock-token |
In token Gateway |
clawdock-cd |
Chuyển đến thư mục dự án OpenClaw |
clawdock-config |
Mở ~/.openclaw |
clawdock-show-config |
In các tệp cấu hình với những giá trị đã được che |
clawdock-workspace |
Mở thư mục không gian làm việc |
clawdock-help |
Liệt kê tất cả lệnh ClawDock |
Quy trình lần đầu
clawdock-startclawdock-fix-tokenclawdock-dashboardNếu trình duyệt thông báo rằng cần ghép nối:
clawdock-devicesclawdock-approve <request-id>Cấu hình và thông tin bí mật
ClawDock đọc hai tệp .env riêng biệt, tương ứng với cách phân chia được mô tả trong Docker:
- Tệp
.envcủa dự án nằm cạnhdocker-compose.yml: các giá trị dành riêng cho Docker như tên ảnh, cổng vàOPENCLAW_GATEWAY_TOKEN.clawdock-tokenđọc token từ đây. ~/.openclaw/.env(được gắn vào container): các thông tin bí mật dựa trên biến môi trường do chính OpenClaw quản lý, cùng vớiopenclaw.jsonvàagents/<agentId>/agent/auth-profiles.json.
clawdock-fix-token sao chép token từ tệp .env của dự án vào các giá trị cấu hình gateway.remote.token và gateway.auth.token của container, sau đó khởi động lại Gateway.
Sử dụng clawdock-show-config để kiểm tra nhanh openclaw.json và cả hai tệp .env; lệnh này che các giá trị .env trong đầu ra được in.
