OpenClaw完整部署指南：从安装到实战配置
🦞 OpenClaw完整部署指南
从安装到实战配置，打造你的AI私人助理
作者：功哥 | 更新时间：2026年2月28日 | 阅读时长：约25分钟
1. OpenClaw简介
🦞 OpenClaw
开源AI助手平台 · 多通道 · 可扩展
50+
内置工具
10+
支持通道
100%
开源免费
OpenClaw是一个强大的开源AI助手平台，支持多通道接入（飞书、钉钉、Discord等），提供丰富的工具集成和灵活的定制能力。无论你是开发者、产品经理还是内容创作者，OpenClaw都能成为你的得力助手。
OpenClaw基础框架
🏗️ 架构组件
- Gateway（网关）：核心服务，处理所有通道连接和消息路由
- Agent（代理）：AI助手实例，处理用户对话和任务执行
- Skills（技能）：扩展功能模块，提供特定能力（如文档处理、数据分析）
- Channels（通道）：多平台接入（飞书、钉钉、Discord等）
- Tools（工具）：底层能力（文件操作、网络请求、代码执行）
- MCP Server：标准化协议扩展，连接外部服务
🔄 工作流程
用户消息 → Gateway → Agent → AI模型 → 工具调用 → 响应生成 → Gateway → 用户
📁 目录结构
~/.openclaw/
├── workspace/ # 工作空间
│ ├── config.yaml # 主配置
│ ├── MEMORY.md # 长期记忆
│ ├── USER.md # 用户信息
│ ├── SOUL.md # AI人设
│ └── channels/ # 通道配置
├── skills/ # 自定义技能
├── cache/ # 缓存数据
└── logs/ # 日志文件
核心特性
🔌 多通道Gateway
单个Gateway进程连接飞书、钉钉、Discord、Telegram、WhatsApp、iMessage等
🎯 Skill技能系统
强大的技能扩展能力，支持自定义技能和50+内置工具（文档处理、数据分析、网络搜索等）
🤖 多智能体路由
按智能体、工作区或发送者隔离会话，支持多个AI助手协同工作
⏰ 定时任务
支持Cron表达式定时任务，自动执行周期性工作
🌐 Web控制界面
浏览器仪表板，管理聊天、配置、会话和节点
📱 移动节点
配对iOS和Android节点，支持Canvas功能
💡 为什么选择OpenClaw？
- 开源免费：完全开源，无需付费
- 本地部署：数据隐私有保障
- 高度可定制：支持自定义技能和工具
- 活跃社区：持续更新，社区支持
2. 环境准备与安装
2.1 系统要求
- 操作系统：macOS、Linux、Windows（WSL2）
- Node.js：v18.0.0 或更高版本
- 内存：至少4GB RAM
- 存储：至少2GB可用空间
2.2 安装步骤
- 安装Node.js
推荐使用nvm管理Node.js版本：# 安装nvm curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash # 安装Node.js nvm install 18 nvm use 18 - 安装OpenClaw CLI
npm install -g openclaw@latest - 运行新手引导
# 引导式设置并安装服务 openclaw onboard --install-daemon - 启动Gateway服务
# 启动Gateway（默认端口18789） openclaw gateway --port 18789 # 或作为守护进程 openclaw gateway start # 查看状态 openclaw gateway status
⚠️ 注意事项
- 确保网络畅通，能够访问npm仓库
- macOS用户可能需要安装Xcode Command Line Tools
- Windows用户建议使用WSL2以获得最佳体验
3. 基础配置
3.1 配置文件结构
OpenClaw的配置文件位于 ~/.openclaw/workspace/ 目录下：
~/.openclaw/workspace/
├── config.yaml # 主配置文件
├── MEMORY.md # 长期记忆
├── USER.md # 用户信息
├── SOUL.md # AI人设
├── channels/ # 通道配置
│ ├── feishu.yaml
│ └── dingtalk.yaml
└── skills/ # 自定义技能
└── custom-skill/
3.2 主配置文件
# config.yaml示例
agent:
name: "锋子"
model: "zai/glm-5"
thinking: "low"
gateway:
port: 18789
host: "localhost"
channels:
- feishu
- dingtalk
tools:
- read
- write
- exec
- web_search
- web_fetch
3.3 配置AI模型
OpenClaw支持多种AI模型，包括：
- 推荐 智谱GLM-5：zai/glm-5
- 推荐 Claude 3.5：anthropic/claude-3.5-sonnet
- Beta GPT-4：openai/gpt-4
- New DeepSeek：deepseek/deepseek-chat
# 配置API密钥
openclaw configure --section llm
# 或手动编辑config.yaml
llm:
provider: "zhipu"
model: "glm-5"
api_key: "your-api-key-here"
⚠️ GLM接入重要说明
智谱GLM-5有两个API端点，请根据你的套餐类型正确配置：
# 通用API端点（默认）
https://open.bigmodel.cn/api/paas/v4
# GLM编码套餐专用端点（仅限编码场景）
https://open.bigmodel.cn/api/coding/paas/v4
注意：
- 使用GLM编码套餐时，必须配置专属的Coding端点
- Coding端点仅限编码场景，不适用于通用API场景
- 通用场景请使用通用端点
- API密钥获取：API Keys页面
配置示例：
# 通用套餐
llm:
provider: "zhipu"
model: "glm-5"
api_key: "your-api-key"
base_url: "https://open.bigmodel.cn/api/paas/v4"
# 编码套餐
llm:
provider: "zhipu"
model: "glm-5"
api_key: "your-api-key"
base_url: "https://open.bigmodel.cn/api/coding/paas/v4"
💡 模型选择建议
- 中文场景：推荐智谱GLM-5或DeepSeek
- 代码任务：推荐Claude 3.5或GPT-4
- 成本考虑：推荐DeepSeek或GLM-5
4. 飞书通道配置
飞书机器人集成
4.1 创建飞书应用
- 访问飞书开放平台
打开 https://open.feishu.cn，登录并创建企业自建应用 - 配置应用权限
在"权限管理"中添加以下权限：- 获取用户基本信息
- 获取与发送单聊、群聊消息
- 读取、修改知识库文档
- 获取应用凭证
在"凭证与基础信息"页面获取：- App ID
- App Secret
4.2 配置OpenClaw
# 运行配置向导
openclaw configure --section channels
# 选择feishu通道
? 选择要配置的通道: feishu
? 输入App ID: cli_xxxxxxxxxxxxx
? 输入App Secret: xxxxxxxxxxxxxxxxxxxxxxxx
? 启用加密? (y/N): y
? 输入Encrypt Key: (可选)
? 启用验证? (y/N): y
? 输入Verification Token: (可选)
4.3 配置事件订阅
在飞书应用后台配置事件订阅：
请求地址：
http://your-server:18789/webhook/feishu
事件订阅：
✅ im.message.receive_v1 (接收消息)
✅ contact.user.updated_v3 (用户信息变更)
4.4 测试连接
# 启动Gateway
openclaw gateway restart
# 查看日志
openclaw gateway logs
# 测试发送消息
在飞书中找到你的机器人，发送"你好"
💡 飞书配置技巧
- 使用内网穿透工具（如ngrok）进行本地测试
- 生产环境建议配置域名和SSL证书
- 定期检查事件订阅状态
5. 钉钉通道配置
5.1 创建钉钉应用
- 访问钉钉开放平台
打开 https://open.dingtalk.com，创建企业内部应用 - 配置应用能力
开通以下能力：- 机器人能力
- 消息推送
- 通讯录管理
- 获取应用凭证
记录以下信息：- Client ID
- Client Secret
5.2 配置OpenClaw
# 配置钉钉通道
openclaw configure --section channels
# 选择dingtalk通道
? 选择要配置的通道: dingtalk
? 输入Client ID: dingxxxxxxxxxxxxxxx
? 输入Client Secret: xxxxxxxxxxxxxxxxxxxxxxxx
? 输入Agent ID: 123456789
? 启用Stream模式? (y/N): y
5.3 配置Stream模式
钉钉推荐使用Stream模式（WebSocket）接收消息，无需配置公网地址：
# config.yaml
channels:
dingtalk:
enabled: true
client_id: "dingxxxxxxxxxxxxxxx"
client_secret: "xxxxxxxxxxxxxxxxxxxxxxxx"
agent_id: "123456789"
stream_mode: true # 启用Stream模式
⚠️ 钉钉配置注意事项
- Stream模式需要保持Gateway持续运行
- 企业内部应用需要管理员权限
- 消息频率有限制，避免发送过快
6. 定时任务配置
6.1 创建定时任务
OpenClaw支持Cron表达式定时任务，可以自动执行周期性工作：
# 创建定时任务
openclaw cron create
# 交互式配置
? 任务名称: AI每日早报
? 执行时间 (Cron表达式): 0 8 * * *
? 任务类型: isolated (独立运行)
? 目标Agent: main
? 任务内容:
每天早上8点生成AI行业早报
包含：技术突破、产品发布、投融资动态
推送到飞书知识库
6.2 Cron表达式说明
Cron表达式格式：秒 分 时 日 月 周
示例：
0 8 * * * # 每天早上8:00
0 9 * * 1-5 # 周一到周五早上9:00
0 0 * * 0 # 每周日0:00
0 30 7 * * * # 每天7:30
6.3 任务类型
| 类型 | 说明 | 适用场景 |
|---|---|---|
isolated |
独立运行，不阻塞主会话 | 日报生成、数据采集 |
main |
在主会话中执行 | 需要用户交互的任务 |
6.4 管理定时任务
# 查看所有任务
openclaw cron list
# 启用任务
openclaw cron enable
# 禁用任务
openclaw cron disable
# 删除任务
openclaw cron delete
# 查看任务日志
openclaw cron logs
6.5 实战案例
📝 实战案例：玄幻小说自动创作
配置7个定时任务，每天凌晨0-6点，每小时自动创作3章小说：
# 任务1：0点创作
openclaw cron create
? 任务名称: 玄幻小说-0点
? 执行时间: 0 0 * * *
? 任务类型: isolated
? 任务内容: 创作小说第X、X+1、X+2章，推送到GitHub
# 重复创建7个任务（0点-6点）
7. MCP集成
7.1 什么是MCP？
MCP（Model Context Protocol）是一个标准化的协议，用于扩展AI模型的能力。通过MCP，OpenClaw可以连接各种外部工具和服务。
7.2 安装MCP Server
# 安装MCP CLI
npm install -g @modelcontextprotocol/cli
# 安装文件系统MCP Server
npm install -g @modelcontextprotocol/server-filesystem
# 安装GitHub MCP Server
npm install -g @modelcontextprotocol/server-github
7.3 配置MCP Server
# 编辑config.yaml
mcp:
servers:
filesystem:
command: "mcp-server-filesystem"
args: ["/path/to/allowed/directory"]
github:
command: "mcp-server-github"
env:
GITHUB_TOKEN: "your-github-token"
7.4 使用MCP工具
配置完成后，OpenClaw会自动识别MCP工具：
# 用户：帮我读取文件内容
# OpenClaw会自动调用MCP的read_file工具
# 用户：提交代码到GitHub
# OpenClaw会调用MCP的GitHub工具
💡 MCP最佳实践
- 只安装可信的MCP Server
- 限制文件系统访问权限
- 定期更新MCP Server版本
8. 高级功能
8.1 Skill技能系统
OpenClaw的Skill技能系统是其核心能力之一，提供强大的扩展性：
内置技能（50+）
- 文档处理：read, write, edit（文件操作）
- 网络搜索：web_search, web_fetch（搜索和抓取）
- 代码执行：exec, process（命令执行）
- 浏览器控制：browser, canvas（UI自动化）
- 消息推送：message, tts（消息和语音）
- 飞书集成：feishu_doc, feishu_wiki, feishu_bitable（飞书文档）
- 记忆系统：memory_search, memory_get（长期记忆）
- 子代理：sessions_spawn, subagents（多Agent协作）
自定义技能
创建自定义技能，扩展AI的能力：
创建自定义技能，扩展AI的能力：
# 创建技能目录
mkdir -p ~/.openclaw/skills/my-skill
cd ~/.openclaw/skills/my-skill
# 创建SKILL.md
cat > SKILL.md << 'EOF'
# 自定义技能：天气查询
## 描述
查询指定城市的天气信息
## 使用场景
- 用户询问天气
- 需要出行建议
## 执行步骤
1. 使用weather API查询天气
2. 格式化返回结果
3. 提供穿衣建议
EOF
# 创建脚本（可选）
touch script.sh
技能市场（ClawHub）
从ClawHub发现和安装社区技能：
# 访问技能市场
https://clawhub.com
# 安装技能
openclaw skill install <skill-name>
8.2 多Agent协作
OpenClaw支持多个Agent协作完成任务：
# 配置子Agent
agents:
- name: "写作助手"
model: "zai/glm-5"
skills: ["writing", "editing"]
- name: "代码助手"
model: "anthropic/claude-3.5-sonnet"
skills: ["coding", "debugging"]
# 使用子Agent
用户：帮我写一篇技术文章
OpenClaw：我会调用"写作助手"来完成这个任务...
8.3 记忆系统
OpenClaw具有强大的记忆系统，分为三个层次：
- 长期记忆（MEMORY.md）：存储重要信息和决策
- 短期记忆（memory/YYYY-MM-DD.md）：记录日常活动
- 会话记忆：当前对话的上下文
# 手动添加记忆
用户：记住我的生日是3月15日
OpenClaw：好的，我已经记录到MEMORY.md中了
# 查询记忆
用户：我的生日是什么时候？
OpenClaw：你的生日是3月15日（来自MEMORY.md）
9. 常见问题
Q1: Gateway无法启动？
A: 检查以下几点：
- 确认Node.js版本 >= 18
- 检查端口18789是否被占用（默认端口）
- 查看日志：
openclaw gateway logs - 尝试清理缓存：
rm -rf ~/.openclaw/cache - 检查服务状态：
openclaw gateway status
Q2: 飞书机器人无响应？
A: 排查步骤：
- 检查事件订阅地址是否正确
- 确认Gateway服务正在运行
- 检查飞书应用权限配置
- 查看Gateway日志中的错误信息
Q3: 定时任务不执行？
A: 可能的原因：
- Cron表达式错误
- 任务被禁用
- Gateway服务未运行
- 时区配置不正确
Q4: 如何备份数据？
A: 备份整个工作空间：
# 备份
tar -czf openclaw-backup.tar.gz ~/.openclaw
# 恢复
tar -xzf openclaw-backup.tar.gz -C ~/
Q5: 如何升级OpenClaw？
# 升级CLI
npm update -g openclaw
# 升级配置
openclaw migrate
10. 总结
OpenClaw是一个功能强大的AI助手平台，通过本指南，你已经掌握了：
- ✅ OpenClaw的安装和基础配置
- ✅ 飞书和钉钉通道的配置
- ✅ 定时任务的创建和管理
- ✅ MCP协议的集成使用
- ✅ 高级功能和自定义技能
🚀 下一步建议
- 探索更多内置技能和工具
- 创建自定义技能满足特定需求
- 加入OpenClaw社区交流经验
- 关注GitHub仓库获取最新更新
作者：功哥 | 更新时间：2026年2月28日 | 字数：约6500字
本文首发于 AI Sense，转载请注明出处