Hello Claw: Hướng dẫn nhập môn OpenClaw

#Phụ lục A: Bảng mã lệnh

OpenClaw cung cấp rất nhiều công cụ dòng lệnh. Phụ lục này tổ chức tất cả các lệnh thường được sử dụng dựa trên tài liệu chính thức.

Nguồn tham khảo: OpenClaw CLI Reference

Điều hướng nhanh

安装与更新
初始化与配置
网关管理
Agent 管理
技能管理
记忆管理
设备管理
诊断与调试
配置操作
消息发送
模型管理
系统管理

Tùy chọn toàn cầu

bash

openclaw [--dev] [--profile <name>] <command>

--dev              # 隔离状态到 ~/.openclaw-dev，并偏移默认端口
--profile <name>   # 隔离状态到 ~/.openclaw-<name>
--no-color         # 禁用 ANSI 颜色
--update           # 简写为 openclaw update（仅源码安装）
-V, --version, -v  # 打印版本并退出

Cài đặt và cập nhật

Cài đặt OpenClaw

bash

# 通过 npm 安装（推荐）
npm install -g openclaw@latest

# 或通过 pnpm
pnpm add -g openclaw@latest

Cập nhật OpenClaw

bash

# 检查并更新到最新版本
openclaw update

# 切换到特定频道
openclaw update --channel stable|beta|dev

# 查看当前版本
openclaw --version

Gỡ cài đặt OpenClaw

bash

# 卸载网关服务和本地数据（CLI 保留）
openclaw uninstall

# 指定范围卸载
openclaw uninstall --service --state --workspace --app --all

# 重置配置和状态（保留 CLI）
openclaw reset
openclaw reset --scope config+creds+sessions --yes

Khởi tạo và cấu hình

Trình hướng dẫn khởi tạo

bash

# 交互式设置向导（推荐）
openclaw onboard

# 初始化并安装守护进程
openclaw onboard --install-daemon

# 非交互式模式
openclaw onboard --non-interactive --mode local

# 重置后重新初始化
openclaw onboard --reset

Trình hướng dẫn cấu hình

bash

# 交互式配置向导
openclaw configure

# 验证配置
openclaw doctor
openclaw doctor --fix          # 自动修复
openclaw doctor --deep         # 深度扫描

Mở bảng điều khiển

bash

# 启动 Web Dashboard
openclaw dashboard

Quản lý cổng

Gateway là dịch vụ cốt lõi của OpenClaw và chạy ở địa chỉ ws://127.0.0.1:18789 theo mặc định.

Cổng khởi động

bash

# 前台运行（调试模式）
openclaw gateway --port 18789 --verbose

# 指定绑定地址
openclaw gateway --bind loopback|lan|tailnet|auto|custom

# 使用 Token 认证
openclaw gateway --auth token --token <token>

# 使用密码认证
openclaw gateway --auth password --password <password>

# Tailscale 集成
openclaw gateway --tailscale serve|funnel

# 开发模式
openclaw gateway --dev

Quản lý dịch vụ cổng

bash

# 查看网关服务状态
openclaw gateway status

# 安装为系统服务
openclaw gateway install

# 卸载服务
openclaw gateway uninstall

# 启动/停止/重启服务
openclaw gateway start
openclaw gateway stop
openclaw gateway restart

# 查看日志
openclaw logs
openclaw logs --limit 100

Kiểm tra tình trạng cổng

bash

# 获取网关健康状态
openclaw health
openclaw health --json
openclaw health --verbose

# 网关调用（RPC）
openclaw gateway call <method> --params '<json>'

Quản lý đại lý

Liệt kê tất cả Đại lý

bash

openclaw agents list
openclaw agents list --json
openclaw agents list --bindings

Thêm đại lý

bash

# 交互式添加
openclaw agents add

# 指定名称添加
openclaw agents add [name]

# 非交互式添加
openclaw agents add my-agent \
  --workspace ~/.openclaw/workspace-my-agent \
  --model anthropic/claude-sonnet-4-5 \
  --bind whatsapp:personal \
  --non-interactive

Quản lý ràng buộc

bash

# 查看绑定
openclaw agents bindings
openclaw agents bindings --agent <id>

# 添加绑定
openclaw agents bind --agent <id> --bind <channel[:accountId]>

# 移除绑定
openclaw agents unbind --agent <id> --bind <channel[:accountId]>
openclaw agents unbind --agent <id> --all

Xóa tác nhân

bash

openclaw agents delete <id>
openclaw agents delete <id> --force

Chạy đại lý

bash

# 单次对话
openclaw agent --message "Hello" --to <dest>

# 指定会话
openclaw agent --message "Hello" --session-id <id>

# 指定思考级别
openclaw agent --message "Hello" --thinking high

# 本地模式（不通过网关）
openclaw agent --message "Hello" --local

# 指定渠道回复
openclaw agent --message "Hello" --channel whatsapp --deliver

Quản lý kỹ năng

Liệt kê các kỹ năng

bash

openclaw skills list
openclaw skills list --eligible    # 仅显示就绪技能
openclaw skills list --json
openclaw skills list -v            # 显示缺失需求详情

Xem chi tiết kỹ năng

bash

openclaw skills info <name>

Kiểm tra trạng thái kỹ năng

bash

openclaw skills check

Mẹo: Sử dụng npx clawhub để tìm kiếm, cài đặt và đồng bộ kỹ năng.

Quản lý trình cắm

Liệt kê các plugin

bash

openclaw plugins list
openclaw plugins list --json

Xem chi tiết plugin

bash

openclaw plugins info <id>

Cài đặt plugin

bash

openclaw plugins install <path|.tgz|npm-spec>

Bật/tắt plugin

bash

openclaw plugins enable <id>
openclaw plugins disable <id>

Chẩn đoán trình cắm

bash

openclaw plugins doctor

Quản lý bộ nhớ

Xem trạng thái bộ nhớ

bash

openclaw memory status

Bộ nhớ chỉ mục

bash

openclaw memory index

Bộ nhớ tìm kiếm

bash

openclaw memory search "<query>"
openclaw memory search --query "<query>"

Quản lý thiết bị

Liệt kê các thiết bị

bash

openclaw devices list
openclaw devices list --json

Thiết bị phê duyệt

bash

openclaw devices approve [requestId]
openclaw devices approve --latest

Từ chối thiết bị

bash

openclaw devices reject <requestId>

Xóa thiết bị

bash

openclaw devices remove <deviceId>

Xóa thiết bị

bash

openclaw devices clear --yes
openclaw devices clear --yes --pending

Quản lý ghép nối

Liệt kê các yêu cầu ghép nối

bash

openclaw pairing list
openclaw pairing list [channel] --channel <channel> --account <id>

Phê duyệt ghép nối

bash

openclaw pairing approve <channel> <code>
openclaw pairing approve --channel <channel> <code> --notify

Quản lý kênh

Liệt kê các kênh

bash

openclaw channels list
openclaw channels list --json

Kiểm tra trạng thái kênh

bash

openclaw channels status
openclaw channels status --probe

Xem nhật ký kênh

bash

openclaw channels logs
openclaw channels logs --channel <name> --limit 200

Thêm kênh

bash

# 交互式添加
openclaw channels add

# 非交互式添加 Telegram
openclaw channels add \
  --channel telegram \
  --account alerts \
  --name "Alerts Bot" \
  --token $TELEGRAM_BOT_TOKEN

# 非交互式添加 Discord
openclaw channels add \
  --channel discord \
  --account work \
  --name "Work Bot" \
  --token $DISCORD_BOT_TOKEN

Xóa kênh

bash

openclaw channels remove --channel <channel> --account <id>
openclaw channels remove --channel <channel> --account <id> --delete

Đăng nhập/Đăng xuất

bash

# WhatsApp Web 登录
openclaw channels login
openclaw channels login --channel whatsapp --account <id> --verbose

# 登出
openclaw channels logout
openclaw channels logout --channel <channel> --account <id>

Gửi tin nhắn

bash

openclaw message send --target +15555550123 --message "Hello"

Gửi phiếu bầu

bash

openclaw message poll \
  --channel discord \
  --target channel:123 \
  --poll-question "Snack?" \
  --poll-option Pizza \
  --poll-option Sushi

Các thao tác nhắn tin khác

bash

openclaw message react
openclaw message reactions
openclaw message read
openclaw message edit
openclaw message delete
openclaw message pin
openclaw message unpin

##Quản lý mô hình

Danh sách mô hình

bash

openclaw models list
openclaw models status

Thiết lập mô hình

bash

openclaw models set <model>
openclaw models set-image <model>

Bí danh mẫu

bash

openclaw models aliases list
openclaw models aliases add <alias> <model>
openclaw models aliases remove <alias>

Khôi phục mô hình

bash

openclaw models fallbacks list
openclaw models fallbacks add <model>
openclaw models fallbacks remove <model>
openclaw models fallbacks clear

Chứng nhận mẫu

bash

openclaw models auth add
openclaw models auth setup-token
openclaw models auth paste-token
openclaw models auth order get|set|clear

Thao tác cấu hình

Nhận cấu hình

bash

openclaw config get <path>
openclaw config get agents.defaults.workspace

Đặt cấu hình

bash

openclaw config set <path> <value>
openclaw config set agents.defaults.heartbeat.every "2h"

Xóa cấu hình

bash

openclaw config unset <path>

Đường dẫn file cấu hình

bash

openclaw config file

Xác minh cấu hình

bash

openclaw config validate
openclaw config validate --json

##Quản lý hệ thống

Sự kiện hệ thống

bash

openclaw system event

Quản lý nhịp tim

bash

openclaw system heartbeat last
openclaw system heartbeat enable
openclaw system heartbeat disable

Trạng thái trực tuyến

bash

openclaw system presence

Quản lý bảo mật

Kiểm tra bảo mật

bash

openclaw security audit
openclaw security audit --deep
openclaw security audit --fix

Quản lý khóa

bash

openclaw secrets reload
openclaw secrets audit
openclaw secrets configure
openclaw secrets apply --from <plan.json>

Quản lý phiên

Liệt kê các phiên

bash

openclaw sessions list
openclaw sessions --json
openclaw sessions --verbose

Kiểm tra trạng thái

bash

openclaw status
openclaw status --json
openclaw status --deep
openclaw status --usage

Quản lý trình duyệt

bash

openclaw browser status
openclaw browser start
openclaw browser stop
openclaw browser reset-profile
openclaw browser tabs
openclaw browser open <url>
openclaw browser screenshot
openclaw browser navigate <url>

Nhiệm vụ theo lịch trình

bash

openclaw cron status
openclaw cron list
openclaw cron add
openclaw cron edit <id>
openclaw cron rm <id>
openclaw cron enable <id>
openclaw cron disable <id>
openclaw cron runs
openclaw cron run <id>

Bí danh lệnh tắt

Để nâng cao hiệu quả, bạn có thể đặt bí danh cho các lệnh thường dùng:

bash

# 添加到 ~/.bashrc 或 ~/.zshrc
alias oc='openclaw'
alias ocg='openclaw gateway'
alias ocs='openclaw skills'
alias oca='openclaw agents'
alias ocd='openclaw dashboard'
alias ocdr='openclaw doctor'
alias occh='openclaw channels'

# 快速启动别名
alias ocstart='openclaw gateway start && openclaw dashboard'
alias ocstop='openclaw gateway stop'
alias ocrestart='openclaw gateway restart'

Kiểm tra nhanh sự cố

Vấn đề	Lệnh chẩn đoán	Giải pháp
Cổng không thể khởi động được	`openclaw doctor`	Kiểm tra tỷ lệ sử dụng cổng và xem nhật ký
Không thể truy cập bảng điều khiển	`openclaw gateway status`	Xác nhận rằng cổng đang chạy và kiểm tra tường lửa
Kết nối kênh không thành công	`openclaw channels status --probe`	Kiểm tra cấu hình và xác thực kênh
Kết nối mô hình không thành công	`openclaw models status`	Xác minh cấu hình mô hình và khóa API
Ghép nối thiết bị không thành công	`openclaw devices list`	Phê duyệt thiết bị đang chờ xử lý
Xác minh cấu hình không thành công	`openclaw config validate`	Sửa chữa cấu hình theo thông báo lỗi

Trợ giúp thêm

bash

# 查看全局帮助
openclaw --help

# 查看子命令帮助
openclaw <command> --help

# 查看具体命令帮助
openclaw gateway --help
openclaw channels add --help

Mẹo: Bảng cheat này dựa trên tài liệu chính thức của OpenClaw. Bạn nên truy cập docs.openclaw.ai để biết thông tin mới nhất.

Điều hướng nhanh ​

Tùy chọn toàn cầu ​

Cài đặt và cập nhật ​

Cài đặt OpenClaw ​

Cập nhật OpenClaw ​

Gỡ cài đặt OpenClaw ​

Khởi tạo và cấu hình ​

Trình hướng dẫn khởi tạo ​

Trình hướng dẫn cấu hình ​

Mở bảng điều khiển ​

Quản lý cổng ​

Cổng khởi động ​

Quản lý dịch vụ cổng ​

Kiểm tra tình trạng cổng ​

Quản lý đại lý ​

Liệt kê tất cả Đại lý ​

Thêm đại lý ​

Quản lý ràng buộc ​

Xóa tác nhân ​

Chạy đại lý ​

Quản lý kỹ năng ​

Liệt kê các kỹ năng ​

Xem chi tiết kỹ năng ​

Kiểm tra trạng thái kỹ năng ​

Quản lý trình cắm ​

Liệt kê các plugin ​

Xem chi tiết plugin ​

Cài đặt plugin ​

Bật/tắt plugin ​

Chẩn đoán trình cắm ​

Quản lý bộ nhớ ​

Xem trạng thái bộ nhớ ​

Bộ nhớ chỉ mục ​

Bộ nhớ tìm kiếm ​

Quản lý thiết bị ​

Liệt kê các thiết bị ​

Thiết bị phê duyệt ​

Từ chối thiết bị ​

Xóa thiết bị ​

Xóa thiết bị ​

Quản lý ghép nối ​

Liệt kê các yêu cầu ghép nối ​

Phê duyệt ghép nối ​

Quản lý kênh ​

Liệt kê các kênh ​

Kiểm tra trạng thái kênh ​

Xem nhật ký kênh ​

Thêm kênh ​

Xóa kênh ​

Đăng nhập/Đăng xuất ​

Gửi tin nhắn ​

Gửi tin nhắn ​

Gửi phiếu bầu ​

Các thao tác nhắn tin khác ​

Danh sách mô hình ​

Thiết lập mô hình ​

Bí danh mẫu ​

Khôi phục mô hình ​

Chứng nhận mẫu ​

Thao tác cấu hình ​

Nhận cấu hình ​

Đặt cấu hình ​

Xóa cấu hình ​

Đường dẫn file cấu hình ​

Xác minh cấu hình ​

Sự kiện hệ thống ​

Quản lý nhịp tim ​

Trạng thái trực tuyến ​

Quản lý bảo mật ​

Kiểm tra bảo mật ​

Quản lý khóa ​

Quản lý phiên ​

Liệt kê các phiên ​

Kiểm tra trạng thái ​

Quản lý trình duyệt ​

Nhiệm vụ theo lịch trình ​

Bí danh lệnh tắt ​

Kiểm tra nhanh sự cố ​

Trợ giúp thêm ​

Điều hướng nhanh

Tùy chọn toàn cầu

Cài đặt và cập nhật

Cài đặt OpenClaw

Cập nhật OpenClaw

Gỡ cài đặt OpenClaw

Khởi tạo và cấu hình

Trình hướng dẫn khởi tạo

Trình hướng dẫn cấu hình

Mở bảng điều khiển

Quản lý cổng

Cổng khởi động

Quản lý dịch vụ cổng

Kiểm tra tình trạng cổng

Quản lý đại lý

Liệt kê tất cả Đại lý

Thêm đại lý

Quản lý ràng buộc

Xóa tác nhân

Chạy đại lý

Quản lý kỹ năng

Liệt kê các kỹ năng

Xem chi tiết kỹ năng

Kiểm tra trạng thái kỹ năng

Quản lý trình cắm

Liệt kê các plugin

Xem chi tiết plugin

Cài đặt plugin

Bật/tắt plugin

Chẩn đoán trình cắm

Quản lý bộ nhớ

Xem trạng thái bộ nhớ

Bộ nhớ chỉ mục

Bộ nhớ tìm kiếm

Quản lý thiết bị

Liệt kê các thiết bị

Thiết bị phê duyệt

Từ chối thiết bị

Xóa thiết bị

Xóa thiết bị

Quản lý ghép nối

Liệt kê các yêu cầu ghép nối

Phê duyệt ghép nối

Quản lý kênh

Liệt kê các kênh

Kiểm tra trạng thái kênh

Xem nhật ký kênh

Thêm kênh

Xóa kênh

Đăng nhập/Đăng xuất

Gửi tin nhắn

Gửi tin nhắn

Gửi phiếu bầu

Các thao tác nhắn tin khác

Danh sách mô hình

Thiết lập mô hình

Bí danh mẫu

Khôi phục mô hình

Chứng nhận mẫu

Thao tác cấu hình

Nhận cấu hình

Đặt cấu hình

Xóa cấu hình

Đường dẫn file cấu hình

Xác minh cấu hình

Sự kiện hệ thống

Quản lý nhịp tim

Trạng thái trực tuyến

Quản lý bảo mật

Kiểm tra bảo mật

Quản lý khóa

Quản lý phiên

Liệt kê các phiên

Kiểm tra trạng thái

Quản lý trình duyệt

Nhiệm vụ theo lịch trình

Bí danh lệnh tắt

Kiểm tra nhanh sự cố

Trợ giúp thêm