OpenClaw常用命令

一、首次远程访问时必须要用的处理配对请求的命令

bash 复制代码

# 查看待处理的配对请求（会显示配对码）
openclaw pairing list telegram
# 批准配对（将 <code> 替换为实际配对码）
openclaw pairing approve telegram <code>

二、基本命令

bash 复制代码

# 1. 初始化配置文件和工作空间。首次安装后必跑。
openclaw setup   
# 2. 交互式向导，一步步引导你配置 Gateway、工作空间、Skills。新手友好，推荐使用。
openclaw onboard    
# 3.  配置凭证、设备、Agent 默认值。比如设置 API Key、默认模型等。
openclaw configure
# 4. 健康检查 + 快速修复。遇到问题先跑这个：
openclaw doctor  # 自动检查
openclaw doctor --fix  # 自动修复

三、Gateway(核心服务管理)

Gateway 是 OpenClaw 的心脏------一个 WebSocket 服务，负责接收消息、调度 Agent、管理会话。

bash 复制代码

# 查看 Gateway 状态
openclaw gateway status
# 启动服务（通过 systemd/launchd）
openclaw gateway start
# 停止服务
openclaw gateway stop
# 重启服务（改完配置后常用）
openclaw gateway restart
# 前台运行（调试时使用，可以看到实时日志）
openclaw gateway run --verbose
# 强制启动（杀掉占用端口的进程）
openclaw gateway start --force


# 指定端口
openclaw gateway --port 19000
# 绑定模式
openclaw gateway --bind loopback   # 仅本机访问（默认，最安全）
openclaw gateway --bind lan        # 局域网可访问
openclaw gateway --bind tailnet    # Tailscale 网络
# 通过 Tailscale 暴露服务
openclaw gateway --tailscale serve   # 内网暴露
openclaw gateway --tailscale funnel  # 公网暴露（需要 Tailscale 账户）

四、技能管理

1. 安装技能管理工具 clawhub

bash 复制代码

# 全局安装 clawhub
npm install -g clawhub

# 验证安装成功
clawhub --version

如果安装clawhub报错：Install failed (exit 243): npm error A complete log of this run can be found in: /home/node/.npm/_logs/2026-03-25T08_29_29_444Z-debug-0.log

这是由于nmp的权限问题导致的，运行下面命令进行权限设置解决这个问题。

解决办法：

bash 复制代码

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

2. 搜索技能

bash 复制代码

# 搜索包含"github"的技能
clawhub search github

# 查看热门技能
clawhub list --popular

# 浏览分类（如 devops、productivity）
clawhub browse devops

3. 安装技能

bash 复制代码

# 安装指定技能
clawhub install tavily-search    # 联网搜索技能
clawhub install find-skills       # 技能检索技能（自动发现缺失技能）
clawhub install proactive-agent   # 主动迭代技能（自我优化）

# 安装指定版本
clawhub install github-actions@1.2.0

# 安装来自特定发布者的技能
clawhub install @username/skill-name