# 全局安装 OpenClawnpm install -g @openclaw/cli# 或者使用 yarnyarn global add @openclaw/cli# 或者使用 pnpmpnpm add -g @openclaw/cli# 验证安装openclaw --version# 输出: 🦞 OpenClaw 2026.2.26

# 查看版本信息openclaw --version# 输出示例：# 🦞 OpenClaw 2026.2.26 (unknown) — Gateway online# 查看帮助信息openclaw --help# 输出所有可用命令和全局选项# 查看详细系统信息openclaw doctor# 执行系统诊断，检查所有依赖项

# 开发模式启动 Gatewayopenclaw --dev gateway run# 指定日志级别openclaw --log-level debug gateway status# 使用命名配置openclaw --profile production gateway start

# 前台运行（开发调试）openclaw gateway run# 后台启动系统服务openclaw gateway start# 指定端口和认证模式openclaw gateway run --port 18789 --auth token --token my-secret-token# 强制启动（杀死占用端口的进程）openclaw gateway run --force# 开发模式（隔离配置）openclaw --dev gateway run# 绑定到局域网openclaw gateway run --bind lan# 通过 Tailscale 暴露openclaw gateway run --tailscale serve

# 停止网关服务openclaw gateway stop# 重启网关服务openclaw gateway restart# 查看服务状态openclaw gateway status

# 查看系统状态openclaw status# 输出示例：# Gateway: online# Channels: telegram ✓, feishu ✓, discord ✗# Sessions: 3 active# Model: gpt-4o-mini (default)

# 完整诊断（只读，可粘贴分享）openclaw status --all# 深度探测消息渠道openclaw status --deep# 显示模型使用配额openclaw status --usage# 以 JSON 格式输出openclaw status --json# 设置探测超时openclaw status --deep --timeout 5000

# 获取 Gateway 状态openclaw status --json | jq '.gateway.status'# 获取活跃会话数openclaw status --json | jq '.sessions.active'

# OpenClaw 配置文件示例{  "gateway": {    "mode": "local",    "port": 18789,    "bind": "loopback",    "auth": "token"  },  "model": {    "default": "gpt-4o-mini",    "reasoning": "o1-mini"  },  "channels": {    "telegram": {      "enabled": true,      "botToken": "${TELEGRAM_BOT_TOKEN}"    },    "feishu": {      "enabled": true,      "appId": "${FEISHU_APP_ID}",      "appSecret": "${FEISHU_APP_SECRET}"    }  },  "agents": {    "defaults": {      "workspace": "~/.openclaw/workspace"    }  }}

# 交互式配置向导openclaw configure# 获取配置值openclaw config get gateway.portopenclaw config get model.default# 设置配置值openclaw config set gateway.port 19000openclaw config set model.default "gpt-4o"# 删除配置值openclaw config unset channels.discord.enabled# 指定配置部分运行向导openclaw config --section gateway --section model

# 点号语法openclaw config get gateway.port# 方括号语法（用于数组或特殊键名）openclaw config get "channels[0].name"、

# 列出所有会话openclaw sessions# 输出示例：# Session ID                    Channel    Recipient        Updated# sess_abc123...                telegram   user_001         2h ago# sess_def456...                feishu     user_002         1d ago# 仅显示最近活跃的会话openclaw sessions --active 120# 指定 Agent 查看openclaw sessions --agent work# 聚合所有 Agent 的会话openclaw sessions --all-agents# JSON 格式输出openclaw sessions --json# 运行会话存储维护openclaw sessions cleanup

# 列出已安装技能openclaw skills list# 输出示例：# Name                    Description# weather                 天气查询与预报# translator              多语言翻译# calendar                日程管理# web-search              网络搜索# 查看技能详情openclaw skills info weather# 检查技能状态openclaw skills check# 输出示例：# ✓ weather: ready# ✓ translator: ready# ✗ custom-helper: missing requirements

# 列出节点状态openclaw nodes status# 输出示例：# ID          Name          Platform    Status    Last Seen# node_001    我的手机      android     online    2m ago# node_002    工作电脑      mac         online    1h ago# 列出待审批的配对请求openclaw nodes pending# 批准配对请求openclaw nodes approve# 拒绝配对请求openclaw nodes reject# 查看节点详情openclaw nodes describe node_001# 重命名节点openclaw nodes rename node_001 --name "我的手机"

# 拍照openclaw nodes camera snap --node node_001 --facing back# 录制屏幕openclaw nodes screen record --node node_002 --duration 10# 获取位置openclaw nodes location --node node_001# 发送通知openclaw nodes notify --node node_001 --title "测试" --body "消息内容"# 在节点上执行命令（仅 Mac）openclaw nodes run --node node_002 --command "uname -a"# 调用节点命令openclaw nodes invoke --node node_001 --command

# 查看最新日志openclaw logs# 实时跟踪日志openclaw logs --follow# 限制行数openclaw logs --limit 100# JSON 格式输出openclaw logs --json# 显示本地时间openclaw logs --local-time# 禁用颜色openclaw logs --no-color# 纯文本输出openclaw logs --plain

# 运行完整诊断openclaw doctor# 输出示例：# ✓ Node.js version: v22.22.0 (supported)# ✓ OpenClaw CLI: 2026.2.26# ✓ Configuration file: valid# ✓ Gateway: running# ✓ Model API: connected# ✓ Telegram channel: configured# ✗ Discord channel: not configured# ⚠ Skills: 1 skill has errors# 自动修复问题openclaw doctor --fix# 非交互模式openclaw doctor --non-interactive# 深度扫描（检查系统服务）openclaw doctor --deep# 生成 Gateway 令牌openclaw doctor --generate-gateway-token

# 列出已配置渠道openclaw channels list# 查看渠道状态openclaw channels status --probe# 登录渠道（如 WhatsApp Web）openclaw channels login --channel whatsapp# 登出渠道openclaw channels logout --channel whatsapp# 添加渠道配置openclaw channels add --channel telegram --token# 移除渠道openclaw channels remove --channel discord# 查看渠道日志openclaw channels logs --channel telegram# 解析用户/群组 IDopenclaw channels resolve --channel telegram --query "username"

# 列出可用模型openclaw models list# 查看模型状态openclaw models status# 设置默认模型openclaw models set gpt-4o# 设置图像模型openclaw models set-image dall-e-3# 扫描 OpenRouter 免费模型openclaw models scan# 管理模型别名openclaw models aliases# 管理认证配置openclaw models auth# 管理回退模型列表openclaw models fallbacks

# 列出已配置 Agentopenclaw agents list# 添加新 Agentopenclaw agents add --id work --workspace ~/work-agent# 删除 Agentopenclaw agents delete work# 设置 Agent 身份openclaw agents set-identity work --name "工作助手" --emoji "💼"# 管理路由绑定openclaw agents bind --agent work --channel telegram --target @mygroupopenclaw agents unbind --agent work --channel telegramopenclaw agents bindings

# 初始化配置和工作区openclaw setup# 交互式引导向导openclaw onboard# 非交互模式openclaw setup --non-interactive# 远程模式openclaw setup --mode remote --remote-url wss://gateway.example.com

#!/bin/bashOpenClaw 快速部署脚本# 1. 安装 OpenClawnpm install -g @openclaw/cli# 2. 初始化配置openclaw setup --mode local# 3. 配置模型 APIopenclaw config set model.default "gpt-4o-mini"openclaw config set model.apiKey "${OPENAI_API_KEY}"# 4. 配置 Telegram 渠道openclaw channels add --channel telegram --token "${TELEGRAM_BOT_TOKEN}"# 5. 安装 Gateway 服务openclaw gateway install# 6. 启动服务openclaw gateway start# 7. 验证状态openclaw status --all# 8. 运行诊断openclaw doctor

#!/bin/bash# OpenClaw 健康检查脚本# 检查 Gateway 是否运行GATEWAY_STATUS=$(openclaw gateway status --json 2>/dev/null | jq -r '.status')if [ "$GATEWAY_STATUS" != "running" ]; then    echo "Gateway not running, attempting to start..."    openclaw gateway start    sleep 5    # 再次检查    GATEWAY_STATUS=$(openclaw gateway status --json 2>/dev/null | jq -r '.status')    if [ "$GATEWAY_STATUS" != "running" ]; then        echo "Failed to start Gateway"        # 发送告警通知        openclaw nodes notify --node node_001 --title "OpenClaw Alert" --body "Gateway 启动失败"        exit 1    fifi# 检查渠道状态CHANNEL_ERRORS=$(openclaw status --deep --json 2>/dev/null | jq '[.channels[] | select(.status != "ok")] | length')if [ "$CHANNEL_ERRORS" -gt 0 ]; then    echo "Channel errors detected: $CHANNEL_ERRORS"    openclaw nodes notify --node node_001 --title "OpenClaw Alert" --body "检测到 $CHANNEL_ERRORS 个渠道异常"fi# 检查错误日志ERROR_COUNT=$(openclaw logs --level error --limit 1000 2>/dev/null | grep -c "error")if [ "$ERROR_COUNT" -gt 10 ]; then    echo "High error rate: $ERROR_COUNT errors"fi# 清理过期会话openclaw sessions cleanupecho "Health check completed at $(date)"

# 开发环境openclaw --profile dev config set gateway.port 19001openclaw --profile dev config set model.default "gpt-4o-mini"openclaw --profile dev gateway run# 生产环境openclaw --profile prod config set gateway.port 18789openclaw --profile prod config set model.default "gpt-4o"openclaw --profile prod gateway start# 测试环境openclaw --profile test config set gateway.port 19002openclaw --profile test gateway run

# 1. 检查端口是否被占用lsof -i :18789# 2. 运行诊断openclaw doctor# 3. 查看详细错误openclaw gateway run --verbose# 4. 强制启动openclaw gateway run --force

# 检查 API 配置openclaw config get model# 测试网络连接curl -I https://api.openai.com# 检查诊断结果openclaw doctor --check network

# 查看技能状态openclaw skills check# 查看相关日志openclaw logs --grep "skill"

# 深度检查渠道状态openclaw status --deep# 查看渠道日志openclaw channels logs --channel telegram# 重新登录渠道openclaw channels login --channel whatsapp