大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



OpenClaw（原 Clawdbot）是一个开源的 AI 代理框架，支持通过配置文件或 GUI 界面进行灵活配置。本文档介绍如何使用美团 LongCat 免费模型接入 OpenClaw，并配置企业微信应用实现智能对话功能。

建议可以先在：快速入门查看文档，也可查看视频

• 操作系统：Rocky Linux 9.5 / 麒麟 v10 (ARM 架构)
• Node.js 版本：推荐 22.x 或更高版本
• CMake 版本要求：≥ 3.19（重要！低版本会导致安装失败）
• OpenClaw 版本：latest
• AI 模型：美团 LongCat 系列（免费白嫖）
• 集成平台：企业微信智能机器人（长连接模式）

在开始之前，请确保准备好以下内容：

1. LongCat API 配置
   • 注册 LongCat 账号：https://longcat.chat
   • 获取 API Key：在 获取
   • 确认 Token 额度：在 确认
2. 企业微信配置
   • 企业微信管理员权限
   • 准备创建自建应用
3. Tavily Search API Key（可选）
   • 用于增强搜索能力
   • API Key:

---

2.1.1 Linux/MacOS 一键安装

说明：
– 该脚本会自动检测系统环境，安装必要的依赖
– 适用于大多数 Linux 发行版和 MacOS
– 如果遇到 CMake 版本问题，请参考下方的手动安装步骤

2.1.2 验证安装

如果安装成功，可以直接跳到「三、OpenClaw 快速启动配置向导」。

---

适用场景：
– ARM 架构服务器（如麒麟 v10、鲲鹏等）
– CMake 版本过低导致在线安装失败
– 需要离线部署的环境

步骤 1：检查 CMake 版本

如果版本低于 3.19，会导致安装失败，错误信息如下：

步骤 2：升级 CMake（Rocky Linux 9.5 / 麒麟 v10）

步骤 3：安装其他必要依赖

注意：
– ARM 架构安装时会自动编译 依赖，需要较长时间（5-10分钟）
– 如果遇到 CMake 版本错误，请返回步骤 2.1.2 升级 CMake
– 编译过程需要足够的内存（建议 ≥ 2GB）

---

在配置向导中，按照以下建议进行选择：

配置完成后，OpenClaw 会自动启动 Gateway 服务并打开 Web 控制页面，打开Web UI，在Chat页面进行交互

默认访问地址：
– Web UI: http://localhost:18789
– TUI 界面: 在终端中运行

提示：如果页面没有自动打开，可以手动在浏览器中访问上述地址。

OpenClaw 的配置文件位于：

• Windows:
• MacOS/Linux:

安装完成后，建议修改配置文件开放完整权限，以便 AI 助手能够充分发挥能力。

步骤 1：编辑配置文件

步骤 2：添加或修改以下配置

在配置文件的根级别添加以下内容：

配置说明：
– – 开放所有工具权限，允许 AI 使用完整功能
– – 禁用内置网络搜索（如果已安装 Tavily Search Skill，建议禁用内置搜索避免冲突）

步骤 4：重启服务使配置生效

权限配置选项说明

安全提示：
– OpenClaw 默认使用 权限级别，功能受限
– 会开放文件操作、命令执行等高级权限
– 生产环境请根据实际需求谨慎配置
– 建议在测试环境先验证配置的安全性

OpenClaw 的工作空间位于 ，包含以下重要文件：

各文件作用说明

自定义配置建议

你可以根据需要编辑这些文件来定制 AI 助手的行为：

1. 修改 IDENTITY.md – 自定义机器人的名称和角色

2. 编辑 SOUL.md – 调整对话风格和价值观

3. 更新 USER.md – 添加用户特定的上下文信息

提示：修改这些文件后，建议重启 Gateway 服务使配置生效：

---

官方文档参考：

美团 LongCat 不同模式每日都有不一样的测试额度，基本上够openclaw进行消耗啦。

1. 访问 LongCat 平台：https://longcat.chat
2. 注册并登录账号
3. 进入 创建 API Key
4. 复制保存 API Key（格式类似：）

步骤 1：打开配置文件

步骤 2：添加 LongCat 模型配置

在配置文件中添加或修改以下内容：

重要提示：
– 将 替换为你的实际 API Key
– 配置保存后立即生效，无需重启服务
– 测试了几个模型，建议选择吧速度最快，准确率可以但思考占太长时间！

步骤 3：验证配置

1. 访问 Web UI：http://localhost:18789
2. 进入 Config → Models → Providers
3. 点击 Add Provider 添加新的模型提供商
4. 填写以下配置：

5. 在 Models 部分添加模型：

6. 保存配置并设置为默认模型

在 TUI 或 Web UI 的 Chat 页面输入测试消息：

如果配置正确，你将收到来自 LongCat 模型的回复。

---

Skills 是 OpenClaw 的扩展插件，可以为 AI 助手增加各种专业能力，如网络搜索、数据处理、API 集成等。

5.2.1 ClawHub – 官方 Skills 市场

• 网址：https://clawhub.ai/
• 特点：
  • 官方维护的 Skills 市场
  • 提供 Skills 下载量、评分、使用说明
  • 支持在线浏览和搜索
  • 可按下载量、更新时间排序

推荐浏览方式：

5.2.2 Awesome OpenClaw Skills – 社区精选集合

• 网址：https://github.com/VoltAgent/awesome-openclaw-skills
• 特点：
  • 社区维护的精选 Skills 集合
  • 包含各类优质第三方 Skills
  • 提供详细的使用说明和示例
  • 持续更新和社区贡献

使用场景：
– 寻找特定功能的 Skills
– 了解社区开发的优质 Skills
– 参考 Skills 的**实践
– 贡献自己开发的 Skills

以下以热门的 Tavily Search Skill 为例，演示如何安装和使用 Skills。

5.3.1 Skill 介绍

• Skill 地址：https://clawhub.ai/arun-8687/tavily-search
• 功能说明：集成 Tavily 搜索引擎，为 AI 提供实时网络搜索能力
• API Key：

5.3.2 通过 ClawHub 安装

5.3.3 验证 Skill 安装

安全提示：API Key 属于敏感信息，请勿将其提交到公共代码仓库或分享给他人。

访问 ClawHub 市场可以发现更多实用的 Skills：

提示：访问 https://clawhub.ai/skills?sort=downloads 查看最受欢迎的 Skills

---

重要说明：OpenClaw 接入企业微信使用的是「智能机器人」功能，而非传统的「自建应用」方式。智能机器人支持长连接模式，可以主动向用户发送消息。

官网文档参考：

在将 OpenClaw 接入企业微信之前，请确认：

1. 已安装企业微信最新版本客户端
2. 已完成 OpenClaw 的安装和 LongCat 模型配置
3. 具有企业微信管理员权限（用于创建智能机器人）

步骤 1：进入智能机器人创建页面

1. 打开企业微信客户端
2. 进入「工作台」
3. 找到并点击「智能机器人」
4. 点击「创建机器人」

步骤 2：选择 API 模式创建

1. 在创建页面选择「API 模式」
2. 选择以「长连接」方式创建
3. 填写机器人基本信息：
   • 机器人名称：OpenClaw AI 助手（可自定义）
   • 机器人头像：上传头像图片
   • 机器人简介：基于 LongCat 的智能对话助手

步骤 3：获取 Bot ID 和 Secret

创建后，系统会生成以下凭证（请妥善保存）：

重要提示：
– 暂时不要点击「保存并创建」，等配置完 OpenClaw 后再保存
– Secret 是敏感信息，请妥善保管

安装成功后，会显示类似以下提示：

步骤 1：重启 OpenClaw Gateway

步骤 2：添加企业微信渠道

步骤 3：按照提示完成配置

在交互式配置过程中，按照以下步骤操作：

1. Select channel：选择「企业微信」（WeWork）
2. 输入 Bot ID：输入前面获取的 Bot ID
3. 输入 Secret：输入前面获取的 Secret
4. 选择配对方式：选择「Pairing」（配对模式）
5. 完成配置：按提示完成后续配置

配置成功后，会显示：

步骤 1：保存企业微信机器人

回到企业微信机器人创建页面，点击「保存并创建」按钮。

步骤 2：获取配对密钥

1. 在企业微信中，找到刚创建的机器人
2. 向机器人发送任意消息（如：）
3. 机器人会回复一个配对密钥，格式类似：

步骤 3：在终端中完成配对

1. 复制配对密钥的最后一行（）
2. 在终端中粘贴并回车
3. 配对成功后，会显示：

1. 在企业微信中向机器人发送消息：
2. 如果配置正确，机器人会使用 LongCat 模型回复

配置完成后， 中会自动添加以下配置：

---

OpenClaw 的 Workspace 配置文件是定制 AI 助手行为的核心。通过编辑这些 Markdown 文件，你可以深度定制机器人的个性、能力和交互方式。

作用：定义 AI 助手的基本身份信息，包括名称、角色和自我介绍。

查看文件：

示例内容：

自定义建议：

作用：定义 AI 的行为准则、对话风格和核心价值观，这是影响机器人”性格”的关键文件。

查看文件：

示例内容：

自定义建议：

作用：列出可用的工具、技能和集成服务，帮助 AI 了解自己的能力边界。

查看文件：

示例内容：

自定义建议：

作用：存储用户偏好和个性化设置，让 AI 更了解用户的习惯和需求。

查看文件：

示例内容：

自定义建议：

作用：定义 AI 代理的能力范围和交互规则，控制 AI 的行为边界。

查看文件：

示例内容：

自定义建议：

作用：定义 OpenClaw 启动时的初始化流程和系统提示词。

查看文件：

自定义建议：

作用：配置服务健康检查和定期任务执行规则。

查看文件：

自定义建议：

7.9.1 备份原始文件

7.9.2 逐步修改测试

7.9.3 环境变量替换敏感信息

以下是一个企业定制的 IDENTITY.md 示例：

---

问题：npm 安装失败

问题：Windows PowerShell 执行策略限制

问题：API Key 无效

• 检查 API Key 是否正确复制（注意前后空格）
• 确认 API Key 未过期或被删除
• 访问 确认额度充足

问题：安装时提示 CMake 版本过低

解决方案：

问题：ARM 架构编译 node-llama-cpp 失败

解决方案：

1. 确保已安装完整的编译工具链

2. 确保系统内存充足（≥ 2GB）

3. 如果内存不足，可以创建 swap 分区

问题：配对密钥无法获取

可能原因及解决方案：

1. 机器人未保存
   • 确保在企业微信中点击了「保存并创建」
   • 检查机器人是否已成功创建
2. OpenClaw Gateway 未运行

3. 插件未正确安装

问题：机器人无响应

1. 检查配对状态

2. 查看日志排查

3. 重新配对

问题：Bot ID 或 Secret 错误

解决方案：

1. 返回企业微信机器人管理页面
2. 重新查看 Bot ID 和 Secret（注意复制时不要包含空格）
3. 重新配置 OpenClaw 渠道

问题：端口被占用

问题：服务无法启动

---

• OpenClaw 官方文档：https://docs.openclaw.ai/zh-CN
• openclaw101: https://openclaw101.dev/zh#getting-started
• 美团 LongCat 平台：https://longcat.chat
• LongCat OpenClaw 配置文档：https://longcat.chat/platform/docs/zh/OpenClaw.html
• ClawHub Skill 市场：https://clawhub.ai
• 企业微信开发文档：https://developer.work.weixin..com
• 企业微信自建应用指南：https://open.work.weixin..com/help2/pc/cat?doc_id=21657
• Tavily API 文档：https://tavily.com/docs

---

注意事项：

1. CMake 版本要求：ARM 架构部署时，必须确保 CMake 版本 ≥ 3.19
2. 内存要求：编译 node-llama-cpp 需要至少 2GB 内存，建议配置 swap 分区
3. 企业微信接入方式：使用「智能机器人」（长连接模式），而非传统的「自建应用」
4. 配置文件备份：定期备份
5. API Key 安全：LongCat API Key、Bot Secret 等敏感信息应妥善保管
6. 服务管理：生产环境建议使用 systemd 管理 OpenClaw Gateway 服务
7. 免费额度：LongCat 免费额度有限，请合理使用
8. 日志监控：定期查看日志排查问题：