OpenClaw安装教程,接入飞书本地部署你的AI助理平台

17 阅读5分钟

准备工作

1.安装Node.js

在安装Clawdbot前,需要先安装Node.js,版本最好是最新的。我使用的版本V22.22.1

下载地址:

https://nodejs.org/en/download/

如果你已经安装了,检查一下你的Node.js是什么版本,最好是v22以上。

打开你的终端命令窗口,查看版本,这里可以看到我安装的nodejs是v22版本

image.png

2.获取Qwen模型key

如果链接Qwen模型不需要key,需要授权下就可以了。

image.png

3.创建飞书机器人应用

[飞书官网] (open.feishu.cn/)

第一步:

image.png 第二步:

image.png

第三步:配置权限

image.png

{
  "scopes": {
    "tenant": [
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message.reactions:read",
      "im:message:readonly",
      "im:message:recall",
      "im:message:send_as_bot",
      "im:message:update",
      "im:resource"
    ],
    "user": [
      "docx:document:readonly"
    ]
  }
}

安装openClaw

安装OpenClaw一定要使用管理员权限安装,这里我们点击右键PowerShell终端命令,选择“管理员安装”。如果是非管理员,会导致OpenClaw的网关安装失败。这里注意:PowerShell版本,最好在PowerShell7以上版本

1.安装命令

打开PowerShell终端,输入以下命令:

npm install -g openclaw@latest

image.png

2.检查是否安装成功

输入以下命令:

openclaw -v

image.png

3.配置安装向导和网关

这一步我们配置一些openclaw的配置内容和网关(非常重要!)。 输入以下命令:

openclaw onboard --install-daemon

image.png

这里会弹出openclaw的安装指引,问你是否同意openclaw在你电脑上为所欲为(包括删除文件等危险操作,谨慎选择)。

这里只能选Yes(按键盘左方向←键选择),否则直接退出配置向导。

image.png

接下来就是问你配置方式,这里选默认的QuickStart就可以。

image.png

3.1 配置大模型

接下来就是配置大模型了

image.png 这里我使用的是Qwen大模型,左边有选中标识,选中回撤即可。

下面就是选择哪一项取决于你希望机器人具备什么能力以及你的应用权限配置情况,我使用的第一个。

image.png

3.2配置飞书聊天机器人

我这里选择配置的是飞书

image.png

这里飞书配置插件,我选择的第二项,根据安装路径环境进行安装插件。 image.png

这里配置飞书SecretKey 和 AppId,这SecretKey 就是在飞书应用里获取,前面有提到。

image.png

这个配置决定了你的飞书机器人在群聊中的响应策略。对于大多数开发和测试场景

Allowlist - only respond in specific groups

第一项需要配置群聊id

Open - respond in all groups (requires mention)

-   **含义**:机器人可以被拉到任何群聊中,但只有在用户  **@机器人** 时才会响应。
-   **风险**:虽然加了“@”限制,但如果你的应用发布到了整个企业,任何员工都可以把机器人拉进任意群(包括敏感群)。一旦代码有Bug,可能在全公司范围内造成影响。
-   **适用**:仅当你开发的是一个完全成熟、面向全公司公开的通用工具(如“天气查询”、“每日新闻”),且经过严格测试后才考虑此项。

image.png

安装skill配置

我这里选择 Skip for now 暂不安装,后期再配置安装

image.png

hooks 配置

最后是安装hooks,这里可以理解成安装几个配置文件

image.png

  • Skip for now跳过所有高级钩子(Hooks)配置,保持最简启动模式。
  • 🚀 boot-md:在网关启动时自动运行根目录下的 BOOT.md 文件(常用于执行初始化指令或欢迎语)。
  • 📎 bootstrap-extra-files:启动时自动加载指定路径或通配符匹配的其他配置文件,以扩展工作区设置。
  • 📝 command-logger:将所有命令操作记录到统一的审计日志文件中,便于追踪和调试。
  • 💾 session-memory:当执行 /new 或 /reset 重置会话时,将当前上下文保存到内存中以便后续恢复或参考。

到这一步就配置好了。

image.png

获取飞书配对码

连接飞书接收事件后,向飞书发送消息,第一条消息会返回配对码

openclaw pairing approver feishu [你的配对码]

创建飞书群聊

在飞书app 里创建群聊,添加全成员,把创建的claw机器人拉到群聊即可。这样就可以利用飞书聊天工具去控制电脑了。

61fc57b9cfcb8ed3ebb6342e1db7db2e.jpg

openclaw 常用命令

基础服务命令

命令说明
openclaw gateway start启动网关服务
openclaw gateway stop停止网关服务
openclaw gateway restart重启网关服务
openclaw gateway status查看网关运行状态
openclaw onboard首次使用初始化向导

配置管理命令

命令说明
openclaw config edit编辑配置文件(推荐)
openclaw config show查看当前配置信息
openclaw config validate验证配置文件格式
openclaw --version查看 OpenClaw 版本
openclaw --help查看帮助信息

渠道配对命令(飞书/钉钉等)

命令说明
openclaw pairing list feishu查看飞书配对请求列表
openclaw pairing approve feishu <配对码>批准飞书配对
openclaw pairing reject feishu <配对码>拒绝飞书配对
openclaw pairing list dingtalk查看钉钉配对请求列表
openclaw channels status查看所有渠道状态
openclaw channels enable <渠道名>启用指定渠道
openclaw channels disable <渠道名>禁用指定渠道

日志命令

命令说明
openclaw logs查看最近日志
openclaw logs --follow实时跟踪日志(类似 tail -f)
openclaw logs --level error只查看错误日志
openclaw logs --lines 100查看最近100行日志

文件速查

内容路径
配置文件~/.openclaw/openclaw.json
日志文件~/.openclaw/logs/
插件目录~/.openclaw/plugins/
缓存目录~/.openclaw/cache/