OpenClaw 的安装和配置

OpenClaw 的安装和配置

image

2026 年初 IT 圈很火的一个词 “养龙虾”,因为&nbspopenclaw 安装;OpenClaw 的 logo 为龙虾,即 “养” 一只属于自己的 “AI 智能体宠物”

OpenClaw(曾用名 Clawdbot、Moltbot)是一个开源的、可本地部署的个人 AI 智能体框架,由程序员 Peter Steinberger 创建,目前已移交基金会维护。它的核心设计理念是让 AI 从 “只会聊天” 升级为 “能够执行操作”

核心特性:

  • 本地部署,数据私有:OpenClaw 运行在你自己的服务器或电脑上,所有数据都在本地,不用担心隐私泄露问题
  • 跨平台交互:它就像一个 “网关” ,可以接入飞书、钉钉、企业微信、Telegram、WhatsApp 等主流聊天软件。你只需要在这些 APP 上跟它对话,就能下达指令
  • 强大的执行能力:获得授权后,OpenClaw 可以直接操作你的系统,比如读写文件、执行 Shell 命令、浏览网页、管理日程等
  • 持久化记忆:它能记住你的偏好和上下文信息,在不同会话中保持连贯,成为真正了解你的 AI 助手
  • 插件化扩展:通过安装社区贡献的 “技能插件”(Skills),OpenClaw 的功能可以无限扩展。目前社区已有超过 5700 种技能

截止 2026-03 月初,OpenClaw 已有 250k Star,在 2026-03-02 当天已经超越了所有 GitHub 开源软件项目的星标数(Star),正式加冕史上最受欢迎开源项目!

OpenClaw 官方文档:OpenClaw – OpenClaw

image

image

powershell (管理员身份运行):& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -Tag beta

Node.js(Node.js 配置命令可参考:Linux 安装配置 Node.js 和 npm)

# 第一步:安装 Node.js

访问 https://nodejs.org/

建议下载 v24.14.0 或更高 LTS 版本

运行安装程序,一路点击 Next

打开 PowerShell,验证安装:

# 验证 Node.js 版本:

node -v 

# 验证 npm 版本:

npm -v

# 或使用 Chocolatey 安装 Node.js 更方便(Chocolatey 配置命令可参考: Windows 的包管理工具(Chocolatey))

image

# 如下已成功安装 Node.js

image

# 第二步:npm 源设置为淘宝镜像源(推荐国内使用)

npm config set registry https://registry.npmmirror.com

# 显示当前在用的 registry

npm config get registry

# 第三步:安装 OpenClaw

# 安装最新版本

npm install -g openclaw@latest

# 验证安装

openclaw –version

# 第四步:初始化配置

# openclaw onboard

image

# 仅在本地测试使用,所以 Onboarding mode 选择 QuickStart(只监听本地环回地址:127.0.0.1)

image

# Moel/auth provider 建议选择国内服务商,阿里云百炼(通义千问)、DeepSeek、智谱 AI (GLM)、Minimax、百度文心一言、腾讯混元等,以避免地区限制

# 服务商以阿里云千问为例

image

# 选择接入的 channel,在此处先不配置,后续配置

image

# skills 也后续配置

image

# 下图中的 Health check failed 是因为 gateway 之前已安装(不算是报错)

image

image

image

image

# web UI 

image

# CLI health and gateway status check

image

# 接入飞书到 openclaw channel

# 查看 openclaw 支持的 plugin

image

# 安装飞书插件

openclaw plugins install @openclaw/feishu

# 添加飞书 channel,选择 Feishu

openclaw channels add

image

image

image

# 在飞书开发者后台(https://open.feishu.cn/app/cli_)生成 App ID 和 App Secret

image

image

# 创建自建应用后显示为 “待上线” 状态,需点击 “创建版本” 或在左侧栏点击 “版本管理与发布”

image

# 可在部分成员 “编辑” 添加对应的成员

image

# 保存后点击 “确认发布”

image

# 发布后状态已变为 “已启用” ,点击 “权限管理”,添加基础权限

image

 # 在权限列表中找到并开启以下权限(至少):

  • im:message:发送消息
  • im:chat:获取群组信息
  • contact:user.base:readonly:读取用户基本信息
  • 其他根据 OpenClaw 需求开启的权限(可选)

# 权限开通后如下所示

image

# 添加机器人

image

# 添加机器人后需发布新版本生效

image

image

image

# 输入 App Secret 和 App ID 

# 确保可以连接到对应的 ou

image

# Config warnings 是因为之前的配置已被覆盖(不是报错)

image

# 因为 OpenClaw 部署在本地(127.0.0.1),所以 Feishu connection mode 选择默认的 WebSocket 模式即可,如果拥有公网 IP 或可以使用内网穿透可选择使用 Webhook 模式

# Group chat policy 

1. Allowlist – 仅在白名单指定的群组中响应

含义:你需要手动配置一个允许机器人参与的群组列表(通常后续步骤会要求输入群组 ID)。机器人只会在这个列表中的群组里响应消息,其他群组中机器人保持静默

适用场景:

  • 机器人仅用于特定团队或项目群,不希望被无关群组打扰
  • 测试阶段,只开放给少量群组验证功能
  • 对安全性要求较高,避免机器人意外加入未知群组

2. Open – 在所有群组中响应(需要 @ 机器人)

含义:机器人会加入任何群组(只要有人将其拉入),但只有在消息中明确 @ 机器人 时才会回复。这样既允许广泛使用,又避免了机器人随意发言造成刷屏

适用场景:

  • 公开机器人,希望任何人都可以将其拉入群组并使用
  • 机器人功能适合群聊场景,但又不想让机器人过于主动
  • 多数通用机器人(如提醒助手、查询机器人)采用此模式

3. Disabled – 不在任何群组中响应

含义:机器人完全不参与群聊,即使被拉入群组也保持沉默。消息仅能在私聊(一对一对话)中处理

适用场景:

  • 机器人专用于个人助手,不需要群组功能
  • 避免机器人被滥用或误拉入群组
  • 初始测试阶段,简化逻辑

# Configure DM access policies now?

  • default: pairing:默认策略是 “配对模式” 。这意味着用户需要先通过某种方式(如发送特定指令、扫码或通过群组邀请)与机器人建立配对关系,才能使用私聊功能。这种模式可以防止机器人被随意骚扰,适合需要授权访问的场景
  • Yes:选择此项将立即进入 DM 策略的详细配置,你可以自定义允许哪些用户私聊(例如基于白名单、开放所有人或完全禁止)
  • No:跳过详细配置,直接使用默认的 pairing 策略。后续你仍可以通过修改配置文件或运行 openclaw config set 来调整

# Add display names for these accounts?

  • Yes:选择后会提示你为当前连接的飞书账号输入一个自定义名称(例如 “我的工作助手”、”测试机器人”)。这个名称仅用于 OpenClaw 内部显示,不会影响飞书客户端中的机器人名称
  • No:跳过此步骤,OpenClaw 会使用默认的标识(可能是 App ID 或自动生成的名字)来代表该账号

# Bind configured channel accounts to agents now?

  • Yes:如果你明确需要修改绑定地址(例如想从局域网其他电脑访问),可以进入详细配置
  • No:使用默认的绑定设置(通常是 loopback,即只允许本机访问),这是最简单、最安全的选项,适合大多数情况

# 命令行配置完成后,在飞书桌面端搜索机器人名字

image

# 发现机器人聊天界面没有聊天的按钮,所以需要开通对应权限

image

image

# 事件配置

image

image

image

# 也可以将 im 对应的所有权限都开通

image

# 发布新版本

image

image

image

# 执行 openclaw gateway restart 命令后并重启飞书客户端进行对话测试

image

image

# 配置 skills

 openclaw skills list # 列出可安装配置的 skills

 

 

# openclaw 常用命令

# openclaw 清除配置重新 onboard

openclaw gateway stop

rmdir /s /q C:Users<用户名>.openclaw

或直接执行 openclaw reset 命令

# 查看日志

openclaw logs

# 运行诊断修复

openclaw doctor –fix

# gateway 配置(配置文件位置:C:Users<用户名>.openclawopenclaw.json)

openclaw gateway start/stop/restart/status

# 检查健康状态

openclaw health

# 查看可用模型

openclaw models list

# 查看 channel 状态

openclaw channels status

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请联系我们举报,一经查实,本站将立刻删除。

发布者:Ai探索者,转载请注明出处:https://javaforall.net/254515.html原文链接:https://javaforall.net

(0)
上一篇 2026年3月13日 下午1:02
下一篇 2026年3月13日 下午1:02


相关推荐

关注全栈程序员社区公众号