九、OpenClaw 使用指南

一.下载地址

官网：https://openclaw.ai/

PythonCopyxxxxxxxxxx2 1curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash2wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

二.基于运行系统选择性安装

中文社区版（推荐安装，一键式部署）：http://clawd.org.cn/

PythonCopyxxxxxxxxxx2 1#自动安装 Node.js 和所有依赖2curl -fsSL https://clawd.org.cn/install.sh | bash

PythonCopyxxxxxxxxxx2 1# 在 PowerShell 中运行(管理员模式)2iwr -useb https://clawd.org.cn/install.ps1 | iex

PythonCopyxxxxxxxxxx4 1# 全局安装2npm install -g openclaw-cn@latest# 运行向导openclaw-cn onboard3# 运行向导4openclaw-cn onboard

三.配置说明

Windows安装

1Windows(自动安装 Node.js 和所有依赖)中文版:

2搜索PowerShell，并右键以管理员身份运行，或输入快捷键win+x呼出面板

解析：从指定网址下载 OpenClaw（原 Clawdbot）的安装脚本，并且立即执行这个脚本，完成工具的自动安装

3提示未找到node.js插件，输入Y（是）/N（否）+回车决定是/否要自动安装node.js依赖环境；

4输入Y后若自动关闭窗口，未安装可在node.js官网下载对应系统安装包：https://nodejs.org/zh-cn/download，保存到系统盘，一直点选Next完成安装，安装成功后会自动关闭窗口

5安装node.js插件后重新输入代码：iwr -useb https://clawd.org.cn/install.ps1 | iex （使其一键式自动安装执行）,接着就会显示自动安装openclaw，待其安装完毕后进入引导界面

6这个表述意味着Claw本身具备强大的操作能力，一旦被滥用会有高风险，所以官方在强调安全边界，此处我们输入Yes+回车进入下一步

7安装引导模式输入回车（选择快速开始）

8模型/认证提供商选"择自定义模型（兼容Openai/anthropic）"然后回车进入下一步

9认证方法选择默认，回车进入下一步

10Select protocol（协议）选择Openai Compatible(Default)回车进入下一步

11Provider ID（自定义命名提供商，仅支持小写字母）此处自定义即可，随后回车进入下一步

12Base Url输入 https://ai.yunsuguan.com/v1 ”，无需另外补全端点，可以联系客服获取

13Model ID（模型名称）需调用模型，模型ID由我们服务器模型广场获取，不支持自定义命名，且需输入全称

14Api key由我们服务器中自行生成，别名秘钥/令牌，填充后回车进入下一步

15按提供商筛选模型选择前面“Provider ID自定义命名的提供商”回车进入下一步

16前面已经输入过需调用的模型ID，所以此处保持当前回车进入下一步即可

17选择通道意指需与哪些外部聊天工具进行连接，此处我们选择暂时跳过，回车进入下一步

18配置技能项选择“是”，回车进入下一步，节点管理器选择“npm”，钩子选择“暂时跳过”回车进入下一步

19配置技能项选择“是”，回车进入下一步，节点管理器选择“npm”，钩子选择“暂时跳过”然后输入空格键+回车进入下一步

20由于我安装过网关服务，所以此处提示不同，首次安装选择安装后回车即可

21安装引导完成后会自动打开仪表盘网页，正常进行对话即可

22红色全选区域为需你对其身份进行定义，可不理会，直接进行对话下达直连， 将正常输出

此报错为本地网关服务没正常启动 / 端口被占用 / 配置异常，重启网关命令即可

Mac/linux安装

1Mac/linux(自动安装 Node.js 和所有依赖)中文版:

1终端输入命令+回车，自动下载安装包

1处于安装状态，等待安装插件下载完毕

1手动输入"yes"+回车确认，此处说明claw具有很大权限

1安装引导模式选择“快速开始”+回车进入下一步

模型/认证提供商选择“自定义模型（兼容 open ai/anthropic）+回车进入下一步”

回车，下一步

1选择Open Ai Compatibie(Default)+回车进入下一步

1此处描述为模型提供商命名，支持自定义，需输入小写，回车进入下一步

1url输入我们服务器完整域名+“/v1”后缀，回车进入下一步

2Model id 输入需调用的模型全称，我们模型广场中获取复制粘贴，此处命名不支持自定义，回车进入下一步

1复制我们服务器-令牌管理处-自行生成的key(别名密钥)，回车进入下一步

1选择刚刚自定义命名的模型提供商，回车进入下一步

1回车进入下一步，上述已配置默认调用模型版本，此处为确认环节

1外部第三方通道（社交媒介）配置栏，此处选择暂时跳过，回车进入下一步，后续如需连通可以通过命令呼出连通配置；

1配置技能栏回车，技能安装节点选择npm回车进入下一步

1空格+回车跳过钩子启用，进入下一步

1网关服务首次下载用户选择安装，回车进入下一步，此处忽略我操作

1在tui中孵化，回车进入下一步

1安装引导环节完结，自动弹出网页仪表盘并原终端界面亦可进行对话

1如需切换模型，可以直接在仪表盘对机器人下达更换/新增模型指令，进入模型新增引导页，然后重启网关，开启新对话，输入/model+空格+模型id（模型全称）即可切换模型

常见问题

上下文超长：

修改openclaw.json文件,两个变量名的值

"contextWindow": 64000, // 核心：设为64K/128K等

"maxTokens": 8192 // 单次回复最大token

准备工作

一个 OpenClaw 实例：确保 OpenClaw 已部署并正常运行。无论是部署在云服务器还是本地电脑，都需要保持开机和网络畅通 。 一个飞书账号：用于创建和管理机器人。

整个流程分为六步，请按顺序操作。

第一步：在飞书开放平台创建应用并获取凭证

https://open.feishu.cn/

这是为你的“小龙虾”在飞书里办一个“身份证”。

1登录并创建应用：访问飞书开放平台，登录后点击 “创建企业自建应用” 。填写应用名称（如“我的AI助手”）和描述，上传一个图标，然后点击 “创建”。

1获取核心凭证 (App ID 和 App Secret)：创建成功后，进入应用详情页。在左侧菜单栏点击 “凭证与基础信息” · 在这个页面，你可以看到 App ID (格式通常为 cli_xxxxx) 和 App Secret。 · ⚠️ 请立即复制并妥善保存这两个信息，后面配置 OpenClaw 时会用到 。

1添加机器人能力：在左侧菜单栏找到 “添加应用能力”，点击 “机器人” 并启用 。

1给机器人批量配置权限 为了让机器人能够正常收发消息、读取文件和群信息，需要给它开通必要的权限。使用批量导入的方式最快捷、最准确。

进入权限管理：在左侧菜单点击 “权限管理” 。

批量导入权限：找到并点击 “批量导入/导出权限” 按钮 。

粘贴权限 JSON：在弹出的输入框中，粘贴以下 JSON 代码 ：

1点击“下一步，确认新增权限”按钮，再点击“申请开通按钮”。

1发布应用 所有配置都完成了，现在需要把刚刚做好的机器人“发布”上线。 1. 创建版本：在左侧菜单点击 “版本管理与发布”，然后点击 “创建版本” 。 2. 填写版本信息：根据提示填写应用版本号（如 1.0.0）、更新说明（如“首次发布”）。其他信息可选填。 3. 提交审核并发布：点击 “保存” 后，再点击 “确认发布”。由于是企业自建应用，通常无需等待人工审核，会即刻生效 。

1确认开通：点击 “下一步”，系统会列出所有要新增的权限，核对后点击 “确认开通” 即可 。

第二步：在 OpenClaw 中安装飞书插件并配置核心信息

接下来，我们回到 OpenClaw 所在的电脑或服务器，通过终端命令让它“认识”飞书。

1安装飞书插件（如未预装）：在终端执行以下命令安装官方飞书通道插件。如果之前已经安装过，可以跳过此步 。

1配置 App ID 和 App Secret：将第一步保存的凭证信息填入以下命令并执行 。

1开启飞书通道并设置连接模式：执行以下命令，启用飞书功能，并强烈推荐使用更简单的“长连接”模式（WebSocket）。

1（可选）配置基础访问策略：为了更安全地使用，可以设置私聊和群聊的默认策略 。

1重启网关服务：所有配置完成后，必须重启网关使配置生效 。

第三步：在飞书后台配置事件订阅（关键步骤）

这是整个流程中最容易出错的一步，请务必在完成第二步并重启网关后，再进行此步操作 。

1选择订阅方式：回到飞书开放平台你的应用后台。在左侧菜单点击 “事件与回调”。在“事件配置”页签下，找到 “订阅方式”，选择 “使用长连接接收事件” 。

⚠️ 注意：如果此时系统提示“没有建立长连接”，不要慌。这通常是因为 OpenClaw 网关还未完全就绪或网络问题。可以等1-2分钟后再试，或者检查 OpenClaw 的运行状态 。

1添加“接收消息”事件：在同一页面，点击 “添加事件”。在搜索框中输入 im.message.receive_v1 并选中它，然后点击 “确认添加” 。这个事件是机器人能收到你消息的关键。

第四步：验证与使用

恭喜！你的“小龙虾”已经成功接入飞书。

1找到你的机器人：打开飞书客户端，在搜索框中输入你创建的应用名称（如“我的AI助手”），找到它并进入对话窗口 。

2发送第一条消息：给机器人发送任意消息（如“你好”）。

3完成配对（首次私聊）：由于我们在第二步设置了 dmPolicy 为 pairing，机器人会回复一个配对码 。

4在 OpenClaw 中确认配对：打开 OpenClaw 的 WebUI 控制台（通常是 http://localhost:18789），在对话框中输入 openclaw pairing approve feishu [你收到的配对码] 并发送，即可完成绑定 。

5开始对话：绑定成功后，你就可以在飞书里和“小龙虾”自由对话了！你也可以把它拉进群聊，在群里 @ 它，它就会响应你的指令 。

前期准备

当前，可用企业微信智能机器人接入OpenClaw。 在将OpenClaw接入企业微信之前，请确认已经完成以下准备工作：

1已安装企业微信最新版本客户端；

2在本地设备安装OpenClaw，或在腾讯云轻量应用服务器 Lighthouse（及其他云厂商服务）实例中完成了OpenClaw的部署。

第一步：以长连接方式创建智能机器人，获取Bot ID和Secret

通过长连接方式创建的智能机器人，支持主动向用户发送消息。

1可在客户端-工作台，点击-智能机器人-创建机器人，选择API模式创建。

2.选择以「长连接」方式创建，并获取Bot ID 和 Secret。

第二步：关联企微机器人与OpenClaw

1在本地终端部署OpenClaw并关联机器人

2安装成功提示如图。

3在select channel步骤，选择 channel 为企业微信。

4输入企业微信机器人Bot ID、Secret。

5选择 finish。

6选择配对方式，选择 Pairing。

7完成后续配置，并可看到配置渠道成功。

8在企业微信中，保存机器人，并跟他发消息。会收到一个配置密钥。

9复制此信息最后一行，并输入在终端中，完成配对。

10此时可在企业微信中正常对话。

前提条件

请选择您有开发者权限的组织，或者选择某个组织后获取开发者权限。

第一步：一键创建OpenClaw机器人

1登录开发者后台。

2在应用开发下，点击立即创建，可一键创建OpenClaw机器人。

3在创建OpenClaw界面，填写机器人基本信息（包括机器人名称、机器人简介和机器人图标），也可直接使用默认的机器人信息，直接点击确定即可。

4OpenClaw创建成功后，会自动展示应用的Client ID和Client Secret，请保存好Client ID和Client Secret用于后续使用。※说明：Client ID和Client Secret是应用的关键信息，也是操作应用数据的核心参数，请妥善保管，切勿轻易提供给他人使用。

5当OpenClaw创建成功后，会自动创建一个酷应用，如下图所示：

※重要：自动创建的OpenClaw会默认开通Card.Streaming.Write、Card.Instance.Write和qyapi_robot_sendmsg权限，开发者无需再手动申请。

6在应用的凭证与基础信息中，也可以获取到应用的Client ID和Client Secret，如下图示：

第二步：部署 OpenClaw，与钉钉机器人打通

※重要：如已经完成了上方的基础配置流程，接下来需要选择下方的部署方式，完成OpenClaw 的部署。

OpenClaw 支持全场景灵活部署，无论您选择阿里云 ECS 、阿里云轻量服务器或本地服务器，均可快速搭建专属 AI 网关。只需简单几步适配不同云厂商环境，即可将大模型能力安全接入钉钉。

以下是三种部署OpenClaw 的方式，可根据实际需求进行选择：

ECS服务器部署：请参考阿里云ECS服务器部署

阿里云轻量服务器：请参考阿里云轻量服务器部署

本地安装OpenClaw：请参考本地安装OpenClaw

1开打终端输入：

2进入通道配置：在控制台中找到“通道配置”（Channels）或类似的菜单，选择“钉钉”（DingTalk）。

3填入凭证并应用：a将刚刚在钉钉开发者后台复制的 Client ID 和 Client Secret 粘贴到对应的输入框中。

  这个 "Direct message policy" 是在问：哪些钉钉用户可以单独给你的机器人发私聊消息？

暂时无法在飞书文档外展示此内容

  接着往下走

  把你自己的钉钉User ID填进去就行

  直接留空，啥都别填，直接按回车跳过！

点击“应用”或“保存”按钮。等待几十秒，当看到钉钉通道的状态显示为 “运行中”，就说明配置成功

第三步：使用钉钉机器人

场景一：单聊中使用机器人

1在顶部搜索框中搜索已创建机器人名称直接使用。

2通过发送消息，实现机器人单聊回复

至此，恭喜您已经完成了基于 OpenClaw 构建钉钉AI 员工的所有操作。

场景二：群聊中使用机器人

1打开钉钉客户端，进入任意群聊。a如果是已有群聊，需要确保群归属组织与创建机器人时的组织相同。

b创建新的群聊，请确保创建时候选择的归属组织与创建机器人时的组织相同。

2单击群设置（右上角），进入群设置，然后选择机器人。

3在机器人管理模块下，选择添加机器人。

4在添加机器人界面，通过搜索已经创建并发布的机器人，点击机器人进行添加即可。

※说明：请确保需要添加的机器人已经发布，且已经完成了本文步骤四：应用部署步骤。搜索机器人时只能搜索已经发布的机器人。

5机器人添加成功后，通过@机器人，实现自动回复。

至此，恭喜您已经完成了基于 OpenClaw 构建钉钉AI 员工的所有操作。

接入QQ是让OpenClaw从“本地工具”变成“随时待命私人助理”的关键一步。

整个过程分为三步：先准备好OpenClaw环境，再去QQ开放平台创建机器人获取“钥匙”，最后把“钥匙”配置进OpenClaw里就行。

“喂饭级”教程，跟着一步步操作即可：

第一步：在QQ开放平台创建机器人

指路：https://q.qq.com/qqbot/openclaw/index.html

1访问官网并登录：浏览器打开 QQ开放平台，点击右上角登录。强烈建议使用手机QQ扫码登录，这是最快捷的方式。如果是首次使用，根据提示完成开发者注册或实名认证。

2一键创建机器人：登录后，在控制台或首页找到醒目的 “创建机器人” 按钮，点击即可自动生成。一个QQ号最多可以创建5个机器人。你可以随后设置它的头像和昵称。

3获取核心凭证：机器人创建成功后，页面会直接显示接入OpenClaw所需的三条核心指令，以及关键的 AppID 和 AppSecret。

· 请注意：这三条指令和你的专属 AppID:AppSecret（令牌）是后续步骤的“钥匙”，建议先保留此页面不要关闭。

第二步：在OpenClaw环境中配置接入

无论你的OpenClaw是部署在云服务器还是本地电脑，操作逻辑完全相同：打开终端或者Powershell（命令行界面），执行QQ开放平台提供的那三条指令。

连接到你的OpenClaw环境：

· 云服务器用户：使用SSH工具（如FinalShell）连接到你的服务器。

· 本地电脑用户：直接在电脑上打开终端（Windows用户推荐使用PowerShell或WSL Ubuntu）。

1执行三条核心指令：在终端中，依次复制并粘贴QQ开放平台提供给你的那三条指令，每粘贴一条就按一次回车执行(如果已经安装了QQ插件就不需要执行第一条命令)。

2启动OpenClaw核心服务（如果你的OpenClaw还未启动或未配置）：

· 如果你是新安装的环境，需要运行配置向导：

  · 如果服务未运行，启动网关：

第三步：验证与测试

1找到你的机器人：在手机QQ或电脑QQ的联系人中，搜索你在第一步创建的机器人账号，或者使用创建成功后页面提供的“扫码聊天”功能将其添加到好友列表。

2开始对话：像跟好友聊天一样，给你的QQ机器人发送一条消息，比如“你好，小龙虾！”或者“现在几点了？”。

3观察回应：如果机器人能够正常回复你，那么恭喜你，接入大功告成！

可以向自己发送文件或转发消息

1. mac一键清除所有 OpenClaw 安装文件、配置、应用程序等所有相关数据，适合想彻底清理后重新安装的场景：

如何执行脚本

1打开 macOS 终端（Terminal/iTerm）；

2复制对应版本的脚本，直接粘贴到终端并回车；

3若执行版本 2 时提示输入密码（sudo），输入你的电脑登录密码即可（输入时无显示，正常输入后回车）。

4重装一键代码（中文版）：

2. Windows一键清除所有 OpenClaw 安装文件、配置、应用程序等所有相关数据

其实只需要执行一行命令，就能卸载 OpenClaw 了：

但是要注意观察执行命令后的输出结果，有些内容可能不会自动删除：

如果你想确保卸载得干干净净，直接复制下面对应你操作系统的所有命令，一把执行即可。

Windows 用户（在 PowerShell 中执行）：