安装步骤

Windows

1.安装Lm Studio。

2.安装node.js。

3.安装git。

#验证
node -v
npm -v

3.联网机器上安装汉化版OpenClaw。

mkdir openclaw-offline
cd openclaw-offline
npm init -y
npm install @qingchencloud/openclaw-zh@latest --registry=https://registry.npmmirror.com --ignore-scripts

4.将openclaw-offline整个文件夹打包压缩。

5.拷贝至离线机器。

6.把./openclaw-offline/node_modules/.bin添加至环境变量。

path
C:\Users\Administrator.DESKTOP-GIFE9FH\Desktop\openclaw-offline\node_modules\.bin

注：如果有残留，直接去另一个残留目录删除openclaw相关文件即可。

7.测试安装成功。

openclaw --version

Ubuntu

1.安装node.js。

2.安装git。

#验证
node -v
npm -v

3.联网机器上安装汉化版OpenClaw。

mkdir openclaw-offline
cd openclaw-offline
npm init -y
npm install @qingchencloud/openclaw-zh@latest --registry=https://registry.npmmirror.com --ignore-scripts

4.将openclaw-offline整个文件夹打包压缩。

tar -zcvf openclaw.tar.gz /home/user/桌面/openclaw-offline

5.拷贝至离线机器。

6.把./openclaw-offline/node_modules/.bin添加至环境变量。

echo 'export PATH="/home/user/桌面/openclaw-offline/node_modules/.bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
nano ~/.bashrc

注：如果有残留，直接去另一个残留目录删除openclaw相关文件即可。

7.测试安装成功。

openclaw --version

初次配置

1.初始化引导设置，配置网关时选择局域网，认证方式为token。

openclaw onboard --install-daemon

2.打开web后台。进行以下配置。

配置—>网关—>控制面板允许来源—>填入局域网IP

配置—>网关—>✔Insecure 控制面板 Auth Toggle

配置—>网关—>✔Dangerously Allow Host-Header Origin Fallback

配置—>网关—>✔Dangerously Disable 控制面板 设备 Auth

配置—>网关—>✔控制面板启用

配置—>浏览器—>✔启用浏览器自动化

代理—>main—>工具—>✔选择FULL

节点—>执行审批—>安全—>完全允许

节点—>执行审批—>安全—>自动允许技能 CLI

openclaw dashboard

3.列出当前有哪些已安装的工具，在代理—>main—>工具—>启用。

注：只能启用有效工具，否则会报错。

openclaw tools list

4.在终端将网址+token复制，可以使用局域网内其它设备打开web后台。

接入飞书

1.进入飞书。

2.openclaw安装飞书插件。直接安装或安装下载好的插件。

openclaw plugins install ./feishu-0.1.3.tgz

3.飞书开放平台创建自建应用并根据openclaw提示绑定。

4.在飞书开放平台权限管理中一键导入权限。

{
  "scopes": {
    "tenant": [
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:read",
      "cardkit:card:write",
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "contact:user.employee_id:readonly",
      "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.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": [
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}

4.进入飞书配置事件订阅，添加事件后选择长连接接收事件。

#需添加的事件
im.message.receive_v1
im.chat.access_event.bot_p2p_chat_entered_v1
im.chat.member.bot.added_v1
im.chat.member.bot.deleted_v1
im.message.message_read_v1

5.在飞书APP上随便发送一个消息，机器人回返回配对码。格式如下。

OpenClaw: access not configured. 
Your Feishu user id: 你的ID
Pairing code:配对码,记下来
......

6.将配对码记录下来后，在openclaw服务端控制台进行配对。

openclaw pairing approve feishu 配对码
openclaw doctor --fix

注：如果是linux端，不会看到服务端，可输入openclaw pairing approve feishu 配对码 进行配对。

7.授权成功后openclaw 的WebUI会话内会可选2个会话，1个是本地会话，1个是飞书会话。在频道中将群策略设置为open。

常用指令

打开配置

openclaw configure

打开控制台

openclaw dashboard

后台运行服务

openclaw gateway

重启网关

openclaw gateway restart

配置飞书

openclaw channels add

列出当前有哪些已安装的工具

openclaw tools list

查看日志

openclaw logs --follow

自动修复

openclaw doctor --fix