一、常用命令

命令	作用	备注 / 参数
npm install -g openclaw@latest --registry https://registry.npmmirror.com	安装 openclaw
openclaw onboard	安装引导
openclaw status	查看 Gateway 状态	检查网关是否可达及运行状况
openclaw health	健康检查	主要检测 core 运行和依赖情况
openclaw doctor	综合诊断与修复建议	可配合  --yes /  --non-interactive 自动执行
openclaw configure	交互式配置向导	用于设置模型、通道、凭据等
openclaw config get <path>	获取配置值	指定路径提取配置
openclaw config set <path> <value>	设置配置项	支持 JSON5/raw 文本
openclaw config unset <path>	清除配置项	移除单个键值
openclaw channels list	列出已登录通道	可观察 WhatsApp/Telegram 等登录状态
openclaw channels login	登录新的通道账号	用于扫描 / 授权链接
openclaw skills list	列出技能	查看可用 / 已安装的技能
openclaw skills info <skill>	技能详情	观察某项技能参数或版本
openclaw plugins list	列出插件	查看已安装插件
openclaw plugins install <id>	安装插件	例如 @openclaw/voice-call
openclaw plugins enable <id>	启用插件	之后通常需要重启网关
openclaw logs --follow	显示日志	--json / --plain / --limit  等组合使用
openclaw gateway	启动 Gateway 网关
openclaw gateway install	安装系统服务	根据平台注册 Gateway 守护进程
openclaw gateway start	启动 Gateway 网关	系统服务模式下启动
openclaw gateway stop	停止 Gateway 网关	同上
openclaw gateway restart	重启 Gateway 网关	适合配置变更后应用
openclaw gateway status	网关系统服务状态	不同于  openclaw status，会探测服务单元
openclaw uninstall	卸载 Gateway 服务及数据	官方推荐使用
openclaw uninstall --all --yes --non-interactive	全自动卸载	包含状态、workspace、插件等
openclaw uninstall --state	删除状态文件	不删除 workspace/CLI
openclaw uninstall --workspace	删除工作区	移除 agent/workspace 文件
openclaw uninstall --service	仅卸载服务	不删除数据
openclaw uninstall --dry-run	模拟卸载	显示结果但不实际执行

二、部署操作

1. 安装openclaw

1.1 执行脚本（含带引导）

openclaw 官网版

curl -fsSL https://openclaw.ai/install.sh | sudo bash -s -- --registry https://registry.npmmirror.com

openclaw-cn 中文社区版，适合新人伙伴使用。熟练后，使用官网版即可。他们操作的方式是一样的。

curl -fsSL https://clawd.org.cn/install.sh | sudo bash -s -- --registry https://registry.npmmirror.com

​

1.2 引导配置

注意 -cn 为中文版，如果你不是执行的 curl 一键安装版本，是采用了 安装 openclaw@latest 程序，那么需要自己执行引导配置。

sudo npm install -g openclaw@latest --registry https://registry.npmmirror.com
sudo npm install -g openclaw-cn@latest --registry https://registry.npmmirror.com

# 运行向导
sudo openclaw onboard
sudo openclaw-cn onboard

1.2.1 安全提示

1.2.2 配置方式

1.2.3 模型配置

1.2.4 通信通道（飞书）

选择渠道

安装插件

• 如果未安装过飞书插件，可以选择安装，也可以跳过后，后续在安装。
• 单独安装插件 sudo openclaw-cn plugins install @m1heng-clawd/feishu

配置凭证

1.2.5 技能配置

1.2.6 部署完成

配置完成后，要启动下网关。能看到以上信息，表示运行没问题了。

ubuntu@VM-0-2-ubuntu:~$ sudo openclaw-cn gateway

2. 配置飞书

2.1 创建飞书

飞书开发者平台

2.2 创建应用

创建应用后，你可以获得到应用凭证（appid、appsecret）这个信息是用于 openclaw 对接使用的

批量导入，权限列表

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:write",
      "contact:contact.base:readonly",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "docs:document.content:read",
      "event:ip_list",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}

2.3 事件配置（机器人）

​

2.4 发布应用

​

2.5 测试

命令 sudo openclaw-cn pairing approve feishu KF2BRAXW