OpenClaw 安装配置与企业微信接入指南（基于美团 LongCat 免费模型）
郭良俊只狗
|
|
39
|
0
|
linux

5604 字
|
1.3 小时

OpenClaw 安装配置与企业微信接入指南（基于美团 LongCat 免费模型）

一、概述

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

建议可以先在：https://openclaw101.dev/zh#getting-started快速入门查看文档，也可查看视频https://www.bilibili.com/video/BV1ZiNwzPEhP/?vd_source=2e42d2362f54adc0c99da049c50a54e4

1.1 环境说明

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

1.2 使用前准备

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

  1. LongCat API 配置
  2. 企业微信配置
    • 企业微信管理员权限
    • 准备创建自建应用
  3. Tavily Search API Key（可选）
    • 用于增强搜索能力
    • API Key: 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

1.3 LongCat 支持的模型

模型名称 API 格式 描述 上下文窗口 最大输出
LongCat-Flash-Chat OpenAI/Anthropic 高性能通用对话模型 200K 8K
LongCat-Flash-Thinking OpenAI/Anthropic 深度思考模型 200K 8K
LongCat-Flash-Thinking-2601 OpenAI/Anthropic 升级版深度思考模型 200K 8K
LongCat-Flash-Lite OpenAI/Anthropic 高效轻量化 MoE 模型 200K 8K

二、OpenClaw 安装部署

2.1 快速在线部署（推荐）

2.1.1 Linux/MacOS 一键安装

# 使用官方安装脚本快速部署
curl -fsSL https://openclaw.ai/install.sh | bash

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

2.1.2 验证安装

# 检查 OpenClaw 版本
openclaw --version

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

2.2 手动安装（适用于特殊环境或在线安装失败）

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

2.2.1 前置依赖检查与升级（重要！）

步骤 1：检查 CMake 版本

# 检查当前 CMake 版本
cmake --version

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

CMake Error at CMakeLists.txt:1 (cmake_minimum_required):
  CMake 3.19 or higher is required. You are running version 3.16.5

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

# 方式一：使用 pip 安装最新版 CMake（推荐）
# 1. 安装 Python3 和 pip（如果未安装）
sudo dnf install -y python3 python3-pip

# 2. 使用 pip 安装最新版 CMake
sudo pip3 install --upgrade cmake

# 3. 验证版本
cmake --version  # 应显示 3.19 或更高版本

# 方式二：从源码编译安装（如果 pip 方式失败）
# 1. 下载 CMake 源码
wget https://github.com/Kitware/CMake/releases/download/v3.28.3/cmake-3.28.3.tar.gz

# 2. 解压并编译
tar -zxvf cmake-3.28.3.tar.gz
cd cmake-3.28.3
./bootstrap
make -j$(nproc)
sudo make install

# 3. 验证安装
cmake --version

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

# Rocky Linux 9.5 / 麒麟 v10 安装编译工具链
sudo dnf groupinstall -y "Development Tools"
sudo dnf install -y gcc gcc-c++ make git

# ARM 架构额外依赖
sudo dnf install -y libstdc++-devel

2.2.2 安装 Node.js 22.x

# 下载 Node.js 22.x ARM64 版本
wget https://nodejs.org/dist/v22.10.0/node-v22.10.0-linux-arm64.tar.xz

# 创建安装目录
sudo mkdir -p /opt/nodejs

# 解压安装
sudo tar -xJvf node-v22.10.0-linux-arm64.tar.xz -C /opt/nodejs --strip-components=1

# 创建符号链接
sudo ln -sf /opt/nodejs/bin/node /usr/local/bin/node
sudo ln -sf /opt/nodejs/bin/npm /usr/local/bin/npm
sudo ln -sf /opt/nodejs/bin/npx /usr/local/bin/npx

# 验证安装
node -v   # 应显示 v22.10.0
npm -v    # 应显示 10.x.x

2.2.3 配置 npm 国内镜像源

# 配置淘宝镜像源，加速下载
npm config set registry https://registry.npmmirror.com

2.2.4 安装 OpenClaw

# 全局安装 OpenClaw（确保 CMake 版本 ≥ 3.19）
npm install -g openclaw@latest

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

2.2.5 验证安装

# 检查 OpenClaw 版本
openclaw --version

# 如果显示版本号，说明安装成功

三、OpenClaw 快速启动配置向导

3.1 启动配置向导

# 安装守护进程并启动配置向导
openclaw onboard --install-daemon

3.2 向导配置选项说明

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

配置步骤 选项 建议选择 说明
Risk 确认 yes/no yes 继续配置流程
Onboarding mode QuickStart/Custom QuickStart 快速完成基础配置
Model/auth provider – Skip for now 稍后手动配置 LongCat
Filter models by provider – All providers 显示所有模型提供商
Default model – Keep current 保持当前默认模型
Select channel – Skip for now 后续再配置企业微信
Configure skills yes/no Yes 启用本地实用技能
Preferred node manager npm/pnpm/yarn npm 使用 npm 管理依赖
Install missing dependencies – Skip for now 跳过自动安装
各种 API Key 设置 – No / Skip 没有的话选择跳过
Gateway service Install/Reinstall Install 安装 Gateway 服务
How to hatch your bot TUI/Web Hatch in TUI 体验交互式界面

3.3 启动后访问

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

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

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

3.4 配置文件位置

OpenClaw 的配置文件位于：

  • Windows: C:\Users\[用户名]\.openclaw\openclaw.json
  • MacOS/Linux: ~/.openclaw/openclaw.json

3.5 开放完整权限配置（重要！）

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

步骤 1：编辑配置文件

# Linux/MacOS 用户
vim ~/.openclaw/openclaw.json

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

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

{
  "tools": {
    "profile": "full",
    "web": {
      "search": {
        "enabled": false
      }
    }
  }
}

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

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

# 重启 Gateway 服务
openclaw gateway restart

# 验证服务状态
openclaw gateway status

权限配置选项说明

配置项 可选值 说明
tools.profile messaging / standard / full 工具权限级别
– messaging – 默认权限，仅消息对话功能
– standard – 标准权限，常用工具可用
– full – 完整权限，所有工具可用（推荐）
web.search.enabled true / false 是否启用内置网络搜索

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

3.6 Workspace 工作空间说明

OpenClaw 的工作空间位于 ~/.openclaw/workspace，包含以下重要文件：

[root@localhost workspace]# pwd
/root/.openclaw/workspace

[root@localhost workspace]# ls -l
总用量 32
-rw-r--r-- 1 root root 7874  3月  8 22:45 AGENTS.md
-rw-r--r-- 1 root root 1470  3月  8 22:45 BOOTSTRAP.md
-rw-r--r-- 1 root root  168  3月  8 22:45 HEARTBEAT.md
-rw-r--r-- 1 root root  487  3月  9 10:27 IDENTITY.md
drwxr-xr-x 3 root root   27  3月  9 08:23 skills
-rw-r--r-- 1 root root 1673  3月  8 22:45 SOUL.md
-rw-r--r-- 1 root root 1443  3月  9 08:24 TOOLS.md
-rw-r--r-- 1 root root  468  3月  8 23:36 USER.md

各文件作用说明

文件名 作用 说明
AGENTS.md 代理配置文件 定义 AI 代理的行为模式、能力范围和交互规则
BOOTSTRAP.md 启动引导文件 定义 OpenClaw 启动时的初始化流程和系统提示词
HEARTBEAT.md 心跳检测配置 配置服务健康检查和定期任务执行规则
IDENTITY.md 身份标识文件 定义 AI 助手的身份、名称、角色和个性特征
SOUL.md 核心灵魂文件 定义 AI 的核心价值观、行为准则和对话风格
TOOLS.md 工具配置文件 列出可用的工具、技能和 API 集成配置
USER.md 用户信息文件 存储用户偏好、历史对话上下文和个性化设置
skills/ 技能目录 存放已安装的 Skills（如 tavily-search 等）

自定义配置建议

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

  1. 修改 IDENTITY.md – 自定义机器人的名称和角色 
    vim ~/.openclaw/workspace/IDENTITY.md
  2. 编辑 SOUL.md – 调整对话风格和价值观 
    vim ~/.openclaw/workspace/SOUL.md
  3. 更新 USER.md – 添加用户特定的上下文信息 
    vim ~/.openclaw/workspace/USER.md

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

openclaw gateway restart

四、配置美团 LongCat 免费模型

官方文档参考：https://longcat.chat/platform/docs/zh/OpenClaw.html

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

image-20260310222959786

4.1 获取 LongCat API Key

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

4.2 配置方式一：修改配置文件（推荐）

步骤 1：打开配置文件

# Windows 用户
notepad %USERPROFILE%\.openclaw\openclaw.json

# MacOS/Linux 用户
vim ~/.openclaw/openclaw.json

步骤 2：添加 LongCat 模型配置

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

{
  "models": {
    "mode": "merge",
    "providers": {
      "longCat": {
        "baseUrl": "https://api.longcat.chat/openai",
        "apiKey": "YOUR_LONGCAT_API_KEY",
        "auth": "api-key",
        "api": "openai-completions",
        "authHeader": true,
        "models": [
          {
            "id": "LongCat-Flash-Thinking-2601",
            "name": "LongCat-Flash-Thinking-2601",
            "api": "openai-completions",
            "reasoning": false,
            "input": [
              "text"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 8192,
            "compat": {
              "maxTokensField": "max_tokens"
            }
          },
          {
            "id": "LongCat-Flash-Lite",
            "name": "LongCat-Flash-Lite",
            "api": "openai-completions",
            "reasoning": false,
            "input": [
              "text"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 300000,
            "maxTokens": 8192,
            "compat": {
              "maxTokensField": "max_tokens"
            }
          },
          {
            "id": "LongCat-Flash-Chat",
            "name": "LongCat-Flash-Chat",
            "api": "openai-completions",
            "reasoning": false,
            "input": [
              "text"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 200000,
            "maxTokens": 8192,
            "compat": {
              "maxTokensField": "max_tokens"
            }
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "longCat/LongCat-Flash-Lite"
      }
    }
  }
}

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

步骤 3：验证配置

# 检查 Gateway 服务状态
openclaw gateway status

# 如果服务未运行，启动服务
openclaw gateway restart

4.3 配置方式二：通过 Web GUI 配置

  1. 访问 Web UI：http://localhost:18789
  2. 进入 Config → Models → Providers
  3. 点击 Add Provider 添加新的模型提供商
  4. 填写以下配置：
配置项 值
Provider Name longCat
API openai-completions
Base URL https://api.longcat.chat/openai
API Key 你的 LongCat API Key
Auth Header true
  1. 在 Models 部分添加模型：
配置项 值
Model ID LongCat-Flash-Thinking-2601
Model Name LongCat-Flash-Thinking-2601
Context Window 200000
Max Tokens 8192
  1. 保存配置并设置为默认模型

4.4 测试 LongCat 模型

# 打开 TUI 界面进行测试
openclaw tui

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

你好，请介绍一下自己

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

image-20260310221745429

五、安装 Skills 扩展能力

5.1 Skills 简介

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

5.2 官方 Skills 资源

5.2.1 ClawHub – 官方 Skills 市场

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

推荐浏览方式：

按下载量排序：https://clawhub.ai/skills?sort=downloads
按更新时间排序：https://clawhub.ai/skills?sort=updated

5.2.2 Awesome OpenClaw Skills – 社区精选集合

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

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

5.3 示例：安装 Tavily Search Skill

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

5.3.1 Skill 介绍

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

5.3.2 通过 ClawHub 安装

# 从 ClawHub 安装 Tavily Search Skill
# 在对话中傻瓜式让ai进行安装就行：
帮我安装这个skill:https://clawhub.ai/arun-8687/tavily-search，我的api key 是：tvly-dev-35X1Ch-xxx，帮我安装后下载保存到工具栏中！

5.3.3 验证 Skill 安装

# 列出已安装的 Skills
penclaw skills list
│ ✓ ready   │  tavily-search  │ 使用Tavily AI进行网络搜索和获取AI摘要

# 测试 Tavily Search 功能
/root/.openclaw/workspace/skills/tavily-search/search "OpenClaw 是什么"

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

5.4 更多 Skills 推荐

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

Skill 名称 功能说明 适用场景
tavily-search 网络搜索和 AI 摘要 实时信息查询、资料搜集
github-integration GitHub 仓库操作 代码管理、Issue 处理
database-query 数据库查询工具 数据分析、报表生成
file-processor 文件处理工具 批量文件操作、格式转换
api-tester API 测试工具 接口测试、调试

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

六、企业微信智能机器人接入配置（长连接模式）

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

官网文档参考：https://open.work.weixin.qq.com/help2/pc/cat?doc_id=21657

6.1 前期准备

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

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

6.2 创建企业微信智能机器人（长连接模式）

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

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

步骤 2：选择 API 模式创建

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

步骤 3：获取 Bot ID 和 Secret

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

参数名称 说明 示例
Bot ID 机器人唯一标识 ww1234567890abcdef
Secret 机器人密钥 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

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

6.3 安装企业微信插件

# 安装企业微信插件
openclaw plugins install @wecom/wecom-openclaw-plugin

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

✔ Successfully installed @wecom/wecom-openclaw-plugin

6.4 配置 OpenClaw 企业微信渠道

步骤 1：重启 OpenClaw Gateway

# 重启 Gateway 服务以加载插件
openclaw gateway restart

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

# 添加渠道配置
openclaw channels add

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

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

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

配置成功后，会显示：

✔ Channel configured successfully

6.5 完成企业微信机器人配对

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

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

步骤 2：获取配对密钥

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

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

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

6.6 测试机器人对话

  1. 在企业微信中向机器人发送消息：你好，请介绍一下自己
  2. 如果配置正确，机器人会使用 LongCat 模型回复

image-20260310231512543

image-20260310231628122

6.7 配置文件示例（企业微信渠道）

配置完成后，~/.openclaw/openclaw.json 中会自动添加以下配置：

{
  "channels": {
    "wecom": {
      "enabled": true,
      "botId": "YOUR_BOT_ID",
      "secret": "YOUR_SECRET",
      "mode": "longConnection",
      "pairing": {
        "status": "paired",
        "pairingKey": "PAIRING_KEY_XXXXXXXXXXXXXX"
      }
    }
  }
}

七、Workspace 配置文件详解与自定义

7.1 配置文件概览

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

7.2 IDENTITY.md – 身份标识配置

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

查看文件：

cat ~/.openclaw/workspace/IDENTITY.md

示例内容：

# 身份标识

我是 OpenClaw AI 助手，基于美团 LongCat 模型。

## 基本信息
- 名称：OpenClaw
- 角色：智能对话助手
- 能力：代码分析、问题解答、任务执行

## 自我介绍
我可以帮助你完成各种任务，包括但不限于：
- 回答技术问题
- 编写和优化代码
- 搜索网络信息
- 执行自动化任务

自定义建议：

# 编辑身份文件
vim ~/.openclaw/workspace/IDENTITY.md

# 可以修改的内容：
# 1. 修改名称和角色以匹配你的使用场景
# 2. 添加特定领域的专业能力描述
# 3. 设置个性化的自我介绍
# 4. 添加企业或团队的特定信息

7.3 SOUL.md – 核心价值观配置

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

查看文件：

cat ~/.openclaw/workspace/SOUL.md

示例内容：

# 核心价值观

## 行为准则
1. 诚实可靠：提供准确的信息，不确定时明确说明
2. 尊重用户：理解用户需求，提供有价值的帮助
3. 持续学习：从对话中学习，不断改进服务质量

## 对话风格
- 友好专业：保持专业的同时展现友好态度
- 简洁明了：避免冗长，直击要点
- 主动思考：预判用户需求，提供额外建议

## 价值观
- 以用户为中心
- 追求卓越品质
- 保持谦逊态度

自定义建议：

# 编辑核心价值观文件
vim ~/.openclaw/workspace/SOUL.md

# 可以调整的内容：
# 1. 根据企业文化调整行为准则
# 2. 设置符合团队风格的对话方式
# 3. 添加特定场景的处理规则
# 4. 定义禁止或限制的行为

7.4 TOOLS.md – 工具配置

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

查看文件：

cat ~/.openclaw/workspace/TOOLS.md

示例内容：

# 可用工具

## 已安装的 Skills
- tavily-search: 网络搜索能力，可以实时搜索互联网信息
- code-analyzer: 代码分析工具，支持多种编程语言

## API 集成
- LongCat API: 主要对话模型，提供智能对话能力
- 企业微信 API: 消息推送和接收，支持企业内部通信

## 系统工具
- 文件操作：读取、写入、修改文件
- 命令执行：执行系统命令
- 数据处理：JSON、CSV 等格式处理

自定义建议：

# 编辑工具配置文件
vim ~/.openclaw/workspace/TOOLS.md

# 维护内容：
# 1. 记录已安装的 Skills 和用途
# 2. 添加自定义工具的使用说明
# 3. 维护工具版本和更新记录
# 4. 标注工具的使用限制和注意事项

7.5 USER.md – 用户信息配置

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

查看文件：

cat ~/.openclaw/workspace/USER.md

示例内容：

# 用户信息

## 用户偏好
- 语言：中文
- 时区：Asia/Shanghai
- 回复风格：简洁专业
- 代码风格：遵循 PEP8（Python）、Google Style（Java）

## 常用场景
- 技术问答
- 代码审查
- 文档编写
- 系统运维

## 背景信息
- 技术栈：Python、Java、Docker、Kubernetes
- 工作环境：Rocky Linux 9.5
- 团队规模：10-20人

## 历史上下文
（系统自动维护对话历史）

自定义建议：

# 编辑用户信息文件
vim ~/.openclaw/workspace/USER.md

# 可以添加：
# 1. 个人偏好和习惯
# 2. 常用的工作场景
# 3. 技术栈和工作环境
# 4. 特定的背景信息

7.6 AGENTS.md – 代理配置

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

查看文件：

cat ~/.openclaw/workspace/AGENTS.md

示例内容：

# 代理配置

## 能力范围
- 自然语言理解：理解用户意图和上下文
- 代码生成和分析：支持多种编程语言
- 任务规划和执行：分解复杂任务，逐步执行
- 工具调用和集成：调用外部工具和 API

## 交互规则
- 主动确认：重要操作前征求用户确认
- 错误处理：遇到问题时提供清晰的错误信息
- 进度反馈：长时间任务提供进度更新
- 安全限制：不执行危险命令，不泄露敏感信息

## 权限控制
- 文件操作：仅限工作目录
- 命令执行：需要用户确认
- 网络访问：仅限白名单 API

自定义建议：

# 编辑代理配置文件
vim ~/.openclaw/workspace/AGENTS.md

# 可以配置：
# 1. 限制或扩展 AI 的能力范围
# 2. 设置交互规则和确认机制
# 3. 配置权限和安全策略
# 4. 定义错误处理流程

7.7 BOOTSTRAP.md – 启动引导配置

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

查看文件：

cat ~/.openclaw/workspace/BOOTSTRAP.md

自定义建议：

# 编辑启动引导文件
vim ~/.openclaw/workspace/BOOTSTRAP.md

# 可以配置：
# 1. 启动时的欢迎消息
# 2. 初始化检查项
# 3. 默认加载的工具和技能
# 4. 启动后的自动任务

7.8 HEARTBEAT.md – 心跳检测配置

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

查看文件：

cat ~/.openclaw/workspace/HEARTBEAT.md

自定义建议：

# 编辑心跳检测文件
vim ~/.openclaw/workspace/HEARTBEAT.md

# 可以配置：
# 1. 健康检查频率
# 2. 定期执行的任务
# 3. 异常告警规则
# 4. 自动恢复策略

7.9 配置文件最佳实践

7.9.1 备份原始文件

# 备份整个 workspace 目录
cp -r ~/.openclaw/workspace ~/.openclaw/workspace.backup.$(date +%Y%m%d)

# 或者使用 tar 打包备份
tar -czf ~/.openclaw/workspace-backup-$(date +%Y%m%d).tar.gz ~/.openclaw/workspace

7.9.2 逐步修改测试

# 1. 修改单个文件
vim ~/.openclaw/workspace/IDENTITY.md

# 2. 重启服务测试效果
openclaw gateway restart

# 3. 测试对话，验证修改是否生效
openclaw tui

# 4. 确认无误后再继续修改其他文件

7.9.3 环境变量替换敏感信息

# 在配置文件中使用环境变量占位符
# 例如在 TOOLS.md 中：
# API Key: ${LONGCAT_API_KEY}

# 在启动前设置环境变量
export LONGCAT_API_KEY="your-actual-api-key"
openclaw gateway start

7.10 配置示例：企业定制版

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

# 企业 AI 助手身份标识

我是 [公司名称] 的智能助手，专注于为技术团队提供高效的开发支持。

## 基本信息
- 名称：[公司名称] DevBot
- 角色：企业级技术助手
- 服务对象：研发团队、运维团队、测试团队

## 核心能力
- 代码审查和优化建议
- 技术文档编写和维护
- 系统故障诊断和排查
- DevOps 流程自动化
- 技术知识库查询

## 专业领域
- 后端开发：Java、Python、Go
- 容器化：Docker、Kubernetes
- 数据库：MySQL、PostgreSQL、Redis
- 消息队列：Kafka、RabbitMQ
- 监控告警：Prometheus、Grafana

## 服务承诺
- 7x24 小时在线服务
- 响应时间 < 5 秒
- 准确率 > 95%
- 持续学习和优化

## 联系方式
- 企业微信：@DevBot
- 技术支持：tech-support@company.com

八、常见问题排查

8.1 OpenClaw 安装问题

问题：npm 安装失败

# 清除 npm 缓存
npm cache clean --force

# 配置国内镜像源
npm config set registry https://registry.npmmirror.com

# 重新安装
npm install -g openclaw@latest

问题：Windows PowerShell 执行策略限制

# 临时允许执行脚本
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

# 重新运行安装命令
iwr -useb https://openclaw.ai/install.ps1 | iex

8.2 LongCat 模型配置问题

问题：API Key 无效

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

8.3 CMake 版本问题（ARM 架构常见）

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

CMake Error at CMakeLists.txt:1 (cmake_minimum_required):
  CMake 3.19 or higher is required. You are running version 3.16.5

解决方案：

# 方式一：使用 pip 升级（推荐）
sudo pip3 install --upgrade cmake
cmake --version  # 验证版本

# 方式二：从源码编译
wget https://github.com/Kitware/CMake/releases/download/v3.28.3/cmake-3.28.3.tar.gz
tar -zxvf cmake-3.28.3.tar.gz
cd cmake-3.28.3
./bootstrap && make -j$(nproc) && sudo make install

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

解决方案：

  1. 确保已安装完整的编译工具链 
    sudo dnf groupinstall -y "Development Tools"
sudo dnf install -y gcc gcc-c++ make git libstdc++-devel
  2. 确保系统内存充足（≥ 2GB） 
    # 查看内存使用情况
free -h
  3. 如果内存不足，可以创建 swap 分区 
    # 创建 2GB swap 文件
sudo dd if=/dev/zero of=/swapfile bs=1M count=2048
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

8.4 企业微信机器人接入问题

问题：配对密钥无法获取

可能原因及解决方案：

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

# 如果未运行，启动服务
openclaw gateway start
  3. 插件未正确安装 
    # 检查已安装的插件
openclaw plugins list

# 如果未安装企业微信插件，重新安装
openclaw plugins install @wecom/wecom-openclaw-plugin

问题：机器人无响应

  1. 检查配对状态 
    # 查看渠道配置
openclaw channels list

# 确认企业微信渠道状态为 "paired"
  2. 查看日志排查 
    # 实时查看日志
openclaw gateway logs --follow
  3. 重新配对 
    # 删除现有渠道
openclaw channels remove wecom

# 重新添加渠道
openclaw channels add

问题：Bot ID 或 Secret 错误

解决方案：

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

8.4 Gateway 服务问题

问题：端口被占用

# Windows 查看端口占用
netstat -ano | findstr :18789

# 修改 Gateway 端口
openclaw config set gateway.port 18790

# 重启服务
openclaw gateway restart

问题：服务无法启动

# 查看详细错误信息
openclaw gateway logs --level error

# 重新安装 Gateway 服务
openclaw onboard --install-daemon

九、参考资料

  • 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.qq.com
  • 企业微信自建应用指南：https://open.work.weixin.qq.com/help2/pc/cat?doc_id=21657
  • Tavily API 文档：https://tavily.com/docs

附录：常用命令速查

OpenClaw 基础命令

# 查看版本
openclaw --version

# 启动配置向导
openclaw onboard

# 打开 TUI 界面
openclaw tui

# 查看帮助
openclaw --help

Gateway 服务管理

# 启动服务
openclaw gateway start

# 停止服务
openclaw gateway stop

# 重启服务
openclaw gateway restart

# 查看状态
openclaw gateway status

# 查看日志
openclaw gateway logs

# 实时查看日志
openclaw gateway logs --follow

配置管理

# 编辑配置文件
openclaw config edit

# 查看配置
openclaw config show

# 设置配置项
openclaw config set <key> <value>

# 验证配置
openclaw config validate

Skill 管理

# 列出已安装的 Skills
openclaw skills list

# 安装 Skill
openclaw skills install <skill-name>

# 卸载 Skill
openclaw skills uninstall <skill-name>

插件管理

# 列出已安装的插件
openclaw plugins list

# 安装插件
openclaw plugins install <plugin-name>

# 卸载插件
openclaw plugins uninstall <plugin-name>

渠道管理

# 列出已配置的渠道
openclaw channels list

# 添加新渠道
openclaw channels add

# 删除渠道
openclaw channels remove <channel-name>

# 查看渠道状态
openclaw channels status <channel-name>

注意事项：

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

发送评论 编辑评论 


				

			

						

				

					

						

							

								
							

							
						

					

				

				

					

						

							

								
							

							
						

					

				

				

					

						

							

								
							

							
							
													

					

				

			

			
			

				

					
				

			

				

											

							
							
						

																					

							
							
						

										
					
											
						

	

		
|´・ω・)ノ
ヾ(≧∇≦*)ゝ
(☆ω☆)
（╯‵□′）╯︵┴─┴
￣﹃￣
(/ω＼)
∠( ᐛ 」∠)＿
(๑•̀ㅁ•́ฅ)
→_→
୧(๑•̀⌄•́๑)૭
٩(ˊᗜˋ*)و
(ノ°ο°)ノ
(´இ皿இ｀)
⌇●﹏●⌇
(ฅ´ω`ฅ)
(╯°A°)╯︵○○○
φ(￣∇￣o)
ヾ(´･ ･｀｡)ノ"
( ง ᵒ̌皿ᵒ̌)ง⁼³₌₃
(ó﹏ò｡)
Σ(っ °Д °;)っ
( ,,´･ω･)ﾉ"(´っω･｀｡)
╮(╯▽╰)╭
o(*////▽////*)q
＞﹏＜
( ๑´•ω•) "(ㆆᴗㆆ)
😂
😀
😅
😊
🙂
🙃
😌
😍
😘
😜
😝
😏
😒
🙄
😳
😡
😔
😫
😱
😭
💩
👻
🙌
🖕
👍
👫
👬
👭
🌚
🌝
🙈
💊
😶
🙏
🍦
🍉
😣
Source: github.com/k4yt3x/flowerhd
	

	

		
颜文字
Emoji
小恐龙
花!
	


									

			

			
			
		

	






上一篇