openclaw-zh部署

发表于 分类于
openclaw-zh部署

前言

之前安装的openclaw-zh，但是它更新的较慢，openclaw-zh更新的较快，这里就使用openclaw-zh。

https://www.npmjs.com/package/@jerryan999/openclaw-zh

环境要求

OpenClaw CN 引入了最新的底层安全机制与构建工具，请确保环境满足以下要求：

安装步骤

安装与启动

安装

1
npm install -g @jerryan999/openclaw-zh@latest

初始化

1
openclaw onboard --install-daemon

配置过程中不要安装飞书插件与相关配置。

启动网关

1
openclaw gateway

打开控制台

1
openclaw dashboard

飞书设置

先诊断与修复，看看有没有错误的配置，如果有的话可以手动删除

1
openclaw doctor --fix

这是配置文件路径

1
open ~/.openclaw/openclaw.json

安装插件

1
openclaw plugins install @m1heng-clawd/feishu

重启

1
openclaw gateway restart

修改配置

1
openclaw config

查看飞书配置

1
openclaw config get channels.feishu

飞书中打开机器人对话

按照提示输入配对码

1
openclaw pairing approve feishu MNB2G4CX

查看状态，查看飞书通道是否正常

1
openclaw status

从 OpenClaw 发消息到飞书（测试出站）

这个不用启动openclaw也能测试

1
openclaw message send --channel feishu --target 飞书机器人的ID --message "测试"

常用命令

常用命令

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
openclaw                    # 启动 OpenClaw
openclaw onboard            # 初始化向导
openclaw dashboard          # 打开网页控制台
openclaw config             # 查看/修改配置
openclaw skills             # 管理技能
openclaw --help             # 查看帮助

# 网关管理
openclaw gateway run        # 前台运行（挂终端，用于调试）
openclaw gateway start      # 后台守护进程（不挂终端，推荐！）
openclaw gateway stop       # 停止网关
openclaw gateway restart    # 重启网关
openclaw gateway status     # 查看网关状态
openclaw gateway install    # 安装为系统服务（开机自启）

# 常用操作
openclaw update             # 检查并更新 CLI
openclaw doctor             # 诊断问题（自动修复）

状态与重启

查看状态

1
openclaw status

重启方式

1
2
3
4
5
6
7
8
9
10
11
12
# 方式 1：使用 gateway 子命令（推荐）
openclaw gateway restart

# 方式 2：先停止再启动
openclaw gateway stop
openclaw gateway start

# 方式 3：守护进程模式（后台运行，不挂终端）
openclaw daemon start       # 启动后台守护
openclaw daemon stop        # 停止守护
openclaw daemon restart    # 重启守护
openclaw daemon status     # 查看状态

运行后可访问

http://127.0.0.1:18789/

查看实时消息

1
openclaw logs --follow

查看网关

1
openclaw gateway status

卸载教程

CLI 卸载

1
2
3
4
5
# 卸载汉化版
npm uninstall -g @jerryan999/openclaw-zh

# 如果之前安装过原版，也一并卸载
npm uninstall -g openclaw

数据清理（可选）

1
2
# 删除配置和缓存（不可恢复！）
rm -rf ~/.openclaw

守护进程卸载

macOS

1
2
launchctl unload ~/Library/LaunchAgents/com.openclaw.plist
rm ~/Library/LaunchAgents/com.openclaw.plist

Linux (systemd)

1
2
3
4
sudo systemctl stop openclaw
sudo systemctl disable openclaw
sudo rm /etc/systemd/system/openclaw.service
sudo systemctl daemon-reload

更新升级

1
npm update -g @jerryan999/openclaw-zh

查看当前版本：

1
openclaw --version

飞书

飞书开放平台

创建应用

  1. 访问 飞书开放平台 并登录你的企业账号。
  2. 点击右上角的 “创建应用”。
  3. 选择 “企业自建应用”。
  4. 填写应用名称（例如 OpenClaw）和描述，点击创建。

添加机器人能力

  1. 进入刚创建的应用管理页面。
  2. 在左侧导航栏找到 “添加应用能力”。
  3. 在右侧列表中选择 “机器人” 并点击添加。

批量导入权限

这是你询问的核心部分。为了避免手动逐个勾选权限出错，推荐使用 JSON 批量导入。

  1. 在应用管理页面左侧导航栏，点击 “权限管理”。
  2. 找到 “批量导入” 按钮（通常在权限列表上方）。
  3. 复制以下官方推荐的权限配置 JSON 代码：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
{
  "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"]
  }
}

如图

image-20260304001144670

配置事件订阅

为了让 OpenClaw 能接收飞书消息：

  1. 在左侧导航栏点击 “事件订阅”。
  2. 开启 “启用事件订阅”，使用长连接接收事件。
  3. 在 “订阅事件” 区域，点击 “添加事件”。
  4. 搜索并添加 im.message.receive_v1 (接收消息)。

发布应用

  1. 在左侧导航栏点击 “版本管理与发布”。
  2. 点击 “创建版本”，填写版本号（如 1.0.0）和更新日志。
  3. 点击 “提交审核” 或 “发布”（企业自建应用通常无需严格审核，直接发布即可）。
  4. 发布成功后，去 “凭证与基础信息” 页面，获取 App ID 和 App Secret。