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.sh
echo 'source ~/.clawdock/clawdock-helpers.sh' >> ~/.zshrc && source ~/.zshrc

Nế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-start
clawdock-fix-token
clawdock-dashboard

Nếu trình duyệt thông báo rằng cần ghép nối:

clawdock-devices
clawdock-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 .env của dự án nằm cạnh docker-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ới openclaw.json và 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.

​

Liên quan

Docker

Quy trình cài đặt Docker chính thức cho OpenClaw.

Môi trường chạy máy ảo Docker

Môi trường chạy máy ảo do Docker quản lý để tăng cường khả năng cô lập.

Cập nhật

Cập nhật gói OpenClaw và các dịch vụ được quản lý.