OpenClaw是一个开源的AI智能体框架，支持接入企业微信、钉钉等平台。本文详细介绍如何从零开始部署OpenClaw并接入企业微信。
附《OpenClaw使用手册》

---

一、OpenClaw是什么？

OpenClaw是一个开源AI Agent框架，核心特点：

特性	说明
开源	MIT协议，GitHub可获取源码
多模型支持	OpenAI、Claude、DeepSeek、Kimi等
多平台接入	企业微信、钉钉、Discord、Telegram等
Skills生态	可扩展能力模块，类似插件系统
本地部署	数据本地存储，隐私安全

GitHub地址：https://github.com/openclaw/openclaw

---

二、环境准备

2.1 系统要求

系统	最低配置	推荐配置
Windows	Win10 64位, 4GB内存	Win11, 8GB内存
macOS	macOS 12+	macOS 14+
Linux	Ubuntu 20.04+	Ubuntu 22.04+

2.2 软件依赖

• Node.js：v18.x 或更高版本
• npm：v9.x 或更高版本
• Git：用于克隆项目

2.3 检查环境

# 检查Node.js版本
node -v
# 应输出 v18.x.x 或更高

# 检查npm版本
npm -v
# 应输出 9.x.x 或更高

# 检查Git
git --version

---

三、安装部署

3.1 克隆项目

# 克隆OpenClaw仓库
git clone https://github.com/openclaw/openclaw.git

# 进入项目目录
cd openclaw

3.2 安装依赖

# 安装项目依赖
npm install

# 如果遇到网络问题，可以使用国内镜像
npm install --registry=https://registry.npmmirror.com

3.3 配置大模型API

OpenClaw支持多种大模型，这里以DeepSeek为例：

获取API Key：

1. 访问 DeepSeek官网：https://platform.deepseek.com/
2. 注册账号并登录
3. 创建API Key

配置文件：

创建 .env 文件：

# 模型配置（选择一个）
# OpenAI
# OPENAI_API_KEY=sk-xxx
# OPENAI_BASE_URL=https://api.openai.com/v1

# DeepSeek
DEEPSEEK_API_KEY=sk-xxx
DEEPSEEK_BASE_URL=https://api.deepseek.com

# 或者使用OpenRouter统一接入
# OPENROUTER_API_KEY=sk-xxx

3.4 启动服务

# 开发模式启动
npm run dev

# 或者生产模式
npm run build
npm start

启动成功后，终端会显示：

OpenClaw is running on http://localhost:3000

---

四、企业微信接入

4.1 创建企业微信机器人

1. 登录企业微信管理后台：https://work.weixin.qq.com/
2. 进入「应用管理」→「自建」→「创建应用」
3. 选择「机器人」类型，选择「API模式」
4. 获取 Bot ID 和 Secret

4.2 配置OpenClaw

编辑配置文件 config/channels.yaml：

channels:
  - name: wecom
    type: wecom
    enabled: true
    config:
      botId: "你的Bot ID"
      secret: "你的Secret"
      # 企业微信回调配置
      callback:
        enabled: true
        port: 3001

4.3 配置企业微信回调

1. 在企业微信机器人设置页面
2. 配置消息接收URL：

   http://你的服务器IP:3001/webhook/wecom
   

3. 如果是本地测试，可以使用内网穿透工具（ngrok、frp等）

使用ngrok示例：

# 安装ngrok
npm install -g ngrok

# 启动内网穿透
ngrok http 3001

# 获取公网地址，填入企业微信回调配置

4.4 测试对话

在企业微信中：

1. 找到刚创建的机器人
2. 发送消息：「你好」
3. 机器人应回复（根据你配置的大模型）

---

五、Skills扩展

OpenClaw的Skills类似插件系统，可以扩展AI的能力。

5.1 查看可用Skills

# 列出所有已安装Skills
openclaw skills list

# 搜索Skills
openclaw skills search <关键词>

5.2 安装Skills

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

# 例如安装联网搜索能力
openclaw skills install web-search

5.3 常用Skills推荐

Skill名称	功能	用途
web-search	联网搜索	AI可搜索实时信息
file-manager	文件管理	AI可读写本地文件
calendar	日程管理	AI可创建日程提醒
weather	天气查询	AI可查询天气

5.4 开发自定义Skill

创建 skills/my-skill/SKILL.md：

# My Skill

## Description
这是一个自定义Skill，用于...

## Tools

### my_tool
描述工具功能

**参数**：
- param1: 参数说明
- param2: 参数说明

**返回**：
- 返回值说明

---

六、常见问题

Q1：启动报错 “Cannot find module”

原因：依赖未安装完整

解决：

rm -rf node_modules
npm install

Q2：企业微信机器人不回复

排查步骤：

1. 检查Bot ID和Secret是否正确
2. 检查回调URL是否可访问
3. 查看OpenClaw日志是否有错误

# 查看日志
npm run logs

Q3：大模型API调用失败

常见原因：

• API Key错误
• 余额不足
• 网络问题（需要代理）

解决方案：

# 配置代理（如需要）
HTTP_PROXY=http://127.0.0.1:7890
HTTPS_PROXY=http://127.0.0.1:7890

Q4：如何更新OpenClaw？

# 拉取最新代码
git pull origin main

# 更新依赖
npm install

# 重新启动
npm run build && npm start

Q5：本地部署安全吗？

OpenClaw是本地部署，所有数据存储在本地：

• 聊天记录存储在本地数据库
• API Key存储在本地配置文件
• 可自行配置数据加密

---

七、进阶配置

7.1 多模型切换

配置多个模型，根据场景自动切换：

models:
  - name: gpt-4
    provider: openai
    apiKey: ${OPENAI_API_KEY}
    useFor:
      - complex_reasoning
      - code_generation

  - name: deepseek-chat
    provider: deepseek
    apiKey: ${DEEPSEEK_API_KEY}
    useFor:
      - daily_chat
      - simple_tasks

7.2 定时任务

配置AI主动推送能力：

crons:
  - name: daily_news
    schedule: "0 9 * * *"  # 每天9点
    channel: wecom
    task: "推送今日资讯摘要"

7.3 记忆持久化

OpenClaw支持长期记忆：

memory:
  enabled: true
  storage: sqlite  # 或 postgres、mongodb
  path: ./data/memory.db

---

八、总结

OpenClaw本地部署的核心步骤：

1. 环境准备：Node.js + Git
2. 克隆项目：git clone
3. 配置模型：选择大模型并配置API Key
4. 企业微信接入：创建机器人 + 配置回调
5. 扩展能力：安装Skills

相比使用SaaS产品，自建OpenClaw的优势：

• ✅ 数据完全本地存储
• ✅ 可自定义AI人格
• ✅ 可扩展能力模块
• ✅ 无使用次数限制

---

本文基于OpenClaw开源项目编写，如有问题欢迎在评论区交流。

相关链接：

• 《OpenClaw使用手册》
• OpenClaw GitHub：https://github.com/openclaw/openclaw
• 企业微信官方文档：https://open.work.weixin.qq.com/
• Node.js官网：https://nodejs.org/