openclaw

OpenClaw 是一个用于本地 AI 代理生态系统的命令行工具，支持 Gateway 网关管理、聊天渠道集成、Agent 智能体交互、消息收发、定时任务、健康检查等功能。它基于 UNIX 哲学设计，让你通过终端完全掌控本地 AI 生态，数据不离开服务器，隐私与安全尽在掌握。

补充说明

openclaw命令 是一个用于管理 OpenClaw AI 代理生态系统的命令行工具，支持 Node.js 环境。它能帮助你初始化配置、启动 Gateway 服务、管理聊天渠道（WhatsApp、Telegram、Discord 等）、与 AI Agent 交互、发送消息、设置定时任务、执行健康检查等。适用于需要本地部署 AI 代理系统的开发者和运维人员。

语法

openclaw [全局选项] <命令> [子命令] [选项] [参数]

选项

全局选项：
  --dev                    开发模式：隔离状态到 ~/.openclaw-dev，默认网关端口 19001
  --log-level <level>      全局日志级别（silent|fatal|error|warn|info|debug|trace）
  --no-color               禁用 ANSI 颜色输出
  --profile <name>         使用命名配置文件（隔离 OPENCLAW_STATE_DIR/OPENCLAW_CONFIG_PATH）
  -h, --help               显示命令帮助
  -V, --version            输出版本号

常用命令选项：
  --force                  强制启动（杀掉占用端口的进程）
  --verbose                输出详细日志
  --json                   输出 JSON 格式（方便脚本处理）
  --port <port>            指定网关端口（默认 18789）
  --token <token>          设置认证 Token
  --password <password>    设置认证密码
  --bind <mode>            绑定模式（loopback|lan|tailnet|auto|custom）
  --tailscale <mode>       Tailscale 暴露模式（off|serve|funnel）
  --workspace <路径>       指定工作空间目录
  --non-interactive        非交互模式（无人值守）
  --yes                    自动确认所有提示
  --dry-run                预览模式（不实际执行）

参数

可选参数：
  [command]                要执行的命令（如 gateway, agent, message 等）
  [subcommand]             子命令（如 gateway run, message send 等）
  [options]                命令特定选项
  [args...]                传递给命令的参数

常用命令分类：
  初始化配置：
    onboard                交互式新手引导向导
    setup                  初始化本地配置和工作空间
    configure              交互式配置向导
    doctor                 健康检查 + 自动修复

  Gateway 管理：
    gateway run            前台启动 Gateway
    gateway start          启动 Gateway 后台服务
    gateway stop           停止 Gateway 服务
    gateway restart        重启 Gateway 服务
    gateway status         查看 Gateway 状态
    gateway install        安装 Gateway 系统服务
    gateway uninstall      卸载 Gateway 服务

  Agent 交互：
    agent                  运行一次 Agent 对话
    agents list            列出所有 Agent
    tui                    打开终端交互界面
    sessions               列出对话会话

  消息管理：
    message send           发送消息
    message read           读取消息历史
    message edit           编辑消息
    message delete         删除消息
    message broadcast      群发消息

  渠道管理：
    channels list          列出聊天渠道
    channels add           添加聊天渠道
    channels remove        移除聊天渠道

  其他工具：
    skills list            列出可用技能
    plugins list           列出插件
    cron add               添加定时任务
    backup create          创建备份
    reset                  重置本地配置
    uninstall              卸载服务和数据
    update                 更新 OpenClaw
    dashboard              打开 Web 控制台
    docs                   搜索官方文档