OpenClaw 核心概念关系与配置指南

文章目录️ 一、核心概念关系图 二、核心概念关系详解1. Gateway网关- 控制中枢2. Agent智能体- 执行单元3. Skills技能- 功能模块4. Tools工具- 具体能力5. Channels渠道- 交互入口6. Nodes节点- 分布式触手️ 三、针对各概念的常用指令Gateway 相关指令Agent 相关指令Skills 相关指令Channels 相关指令Nodes 相关指令通用诊断指令四、国内可用渠道配置指南1. 微信个人号2. 飞书企业版3. 钉钉企业版4. 企业微信5. Telegram需科学上网6. 邮件SMTP渠道配置对比表️ 五、常用Skills配置指南1. 浏览器控制技能2. 文件操作技能3. 定时任务技能4. 天气查询技能5. 邮件处理技能6. 数据库操作技能7. API调用技能8. 办公自动化技能Skills配置最佳实践1. 按需安装2. 权限控制3. 技能组合4. 安全配置 六、完整配置示例典型个人助理配置企业工作流配置 七、故障排查与维护常见问题解决定期维护命令 八、总结与建议核心关系回顾配置优先级建议国内用户特别建议️ 一、核心概念关系图Agent 工作区用户Channels交互渠道Gateway控制中枢Agent 1智能体Agent 2智能体Agent N智能体Skills技能模块Tools具体工具Nodes分布式节点设备1设备2大语言模型ClawHub技能社区 二、核心概念关系详解1. Gateway网关- 控制中枢角色系统的大脑和交通枢纽职责消息路由接收所有渠道消息分发给对应Agent认证授权管理用户权限和会话安全服务协调协调Agent、Skills、Nodes之间的协作位置~/.openclaw/openclaw.json配置2. Agent智能体- 执行单元角色具体的数字员工职责任务执行根据用户指令执行具体任务记忆管理维护对话历史和上下文技能调用选择合适的Skills完成任务位置~/.openclaw/agents/目录下3. Skills技能- 功能模块角色Agent的专业技能包职责功能封装将复杂操作封装为简单接口标准化提供统一的调用规范可复用跨Agent共享使用来源内置技能系统自带ClawHub社区上万种社区贡献技能自定义技能用户自己开发4. Tools工具- 具体能力角色Skills的基础工具集类型浏览器工具网页自动化执行工具系统命令执行Web工具HTTP请求自动化工具定时任务位置集成在Skills中5. Channels渠道- 交互入口角色用户的沟通窗口功能消息接收从各种平台接收用户消息格式转换统一不同平台的消息格式身份验证验证用户身份位置Gateway配置中管理6. Nodes节点- 分布式触手角色系统的延伸手臂功能设备接入将其他设备接入系统能力扩展提供设备特有功能跨设备协作协调多设备任务执行类型macOS、iOS、Android等设备节点️ 三、针对各概念的常用指令Gateway 相关指令# 启动/停止/重启openclaw gateway start# 后台启动openclaw gateway stop# 停止服务openclaw gateway restart# 重启服务配置修改后必用# 状态检查openclaw gateway status# 检查服务状态openclaw health# 健康检查# 配置管理openclaw config get gateway.port# 查看端口openclaw configsetgateway.port18789# 修改端口Agent 相关指令# Agent管理openclaw agents list# 列出所有Agentopenclaw agentsadd# 添加新Agentopenclaw agents deletename# 删除Agent# 会话管理openclaw sessions list# 查看所有会话openclaw memory search关键词# 搜索记忆Skills 相关指令# 技能管理openclaw skills list# 列出已安装技能openclaw skillsinstallname# 安装技能openclaw skillsenablename# 启用技能openclaw skills disablename# 禁用技能# ClawHub社区clawhub search关键词# 搜索技能clawhubinstallskill# 安装社区技能Channels 相关指令# 渠道管理openclaw channels list# 列出已配置渠道openclaw channelsadd# 添加新渠道openclaw channels status# 检查渠道状态openclaw channels login--channelname# 登录渠道Nodes 相关指令# 节点管理openclaw nodes# 查看所有节点openclawnodestart# 启动节点服务openclawnodestatus# 检查节点状态通用诊断指令openclaw doctor# 全面健康检查最常用openclaw doctor--fix# 自动修复问题openclaw logs--follow# 实时查看日志四、国内可用渠道配置指南1. 微信个人号配置方法# 添加微信渠道openclaw channelsadd--channelwechat# 扫码登录openclaw channels login--channelwechat注意事项需要微信个人号不支持公众号/小程序扫码登录后需在手机确认可能面临封号风险建议使用小号2. 飞书企业版配置方法# 添加飞书渠道openclaw channelsadd--channelfeishu\--app-idYOUR_APP_ID\--app-secretYOUR_APP_SECRET\--encrypt-keyYOUR_ENCRYPT_KEY\--verification-tokenYOUR_VERIFICATION_TOKEN获取凭证步骤登录飞书开放平台https://open.feishu.cn创建企业自建应用获取以下信息App IDApp SecretEncrypt KeyVerification Token配置事件订阅和权限3. 钉钉企业版配置方法# 添加钉钉渠道openclaw channelsadd--channeldingtalk\--app-keyYOUR_APP_KEY\--app-secretYOUR_APP_SECRET\--robot-codeYOUR_ROBOT_CODE获取凭证步骤登录钉钉开放平台https://open.dingtalk.com创建企业内部应用/H5微应用获取AppKey和AppSecret配置机器人权限4. 企业微信配置方法# 添加企业微信渠道openclaw channelsadd--channelwecom\--corp-idYOUR_CORP_ID\--corp-secretYOUR_CORP_SECRET\--agent-idYOUR_AGENT_ID获取凭证步骤登录企业微信管理后台创建应用获取以下信息企业IDCorpID应用Secret应用AgentId5. Telegram需科学上网配置方法# 添加Telegram渠道openclaw channelsadd--channeltelegram\--tokenYOUR_BOT_TOKEN# 获取Bot Token步骤# 1. 在Telegram中搜索 BotFather# 2. 发送 /newbot 创建新机器人# 3. 获取并保存Token6. 邮件SMTP配置方法# 添加邮件渠道openclaw channelsadd--channelemail\--smtp-hostsmtp.example.com\--smtp-port587\--smtp-usernameyour-emailexample.com\--smtp-passwordyour-password\--imap-hostimap.example.com\--imap-port993渠道配置对比表渠道类型配置复杂度稳定性适用场景微信个人社交简单中等个人使用、小团队飞书企业协作复杂高企业办公、团队协作钉钉企业协作中等高企业办公、项目管理企业微信企业通讯中等高企业内部沟通Telegram国际通讯简单高技术社区、国际团队邮件异步通讯中等高正式通知、报告推送️ 五、常用Skills配置指南1. 浏览器控制技能安装clawhubinstallbrowser-control配置// 在Agent配置中启用{skills:{browser-control:{enabled:true,config:{headless:false,// 是否无头模式timeout:30000,// 超时时间(ms)viewport:{// 视口设置width:1280,height:800}}}}}常用功能网页抓取和数据提取表单自动填写截图和PDF生成自动化测试2. 文件操作技能安装clawhubinstallfile-operations配置{skills:{file-operations:{enabled:true,config:{allowed_directories:[~/Documents,~/Downloads,/tmp],max_file_size:10485760,// 10MBallowed_extensions:[.txt,.pdf,.docx,.xlsx]}}}}常用功能文件读写和编辑批量重命名格式转换目录整理3. 定时任务技能安装clawhubinstallscheduler配置{skills:{scheduler:{enabled:true,config:{timezone:Asia/Shanghai,max_concurrent_tasks:5,retry_attempts:3}}}}常用功能定时数据备份定期报告生成网站监控自动化数据同步4. 天气查询技能安装clawhubinstallweather配置{skills:{weather:{enabled:true,config:{provider:qweather,// 和风天气api_key:YOUR_API_KEY,default_city:北京,units:metric// 公制单位}}}}获取API Key访问和风天气官网https://dev.qweather.com注册开发者账号创建应用获取Key5. 邮件处理技能安装clawhubinstallemail-handler配置{skills:{email-handler:{enabled:true,config:{imap:{host:imap.example.com,port:993,username:your-emailexample.com,password:your-password},smtp:{host:smtp.example.com,port:587,username:your-emailexample.com,password:your-password},check_interval:300,// 检查间隔(秒)auto_reply_rules:[]// 自动回复规则}}}}6. 数据库操作技能安装clawhubinstalldatabase配置{skills:{database:{enabled:true,config:{connections:{main:{type:mysql,host:localhost,port:3306,database:mydb,username:user,password:pass},cache:{type:redis,host:localhost,port:6379}},query_timeout:30,max_rows:1000}}}}7. API调用技能安装clawhubinstallapi-client配置{skills:{api-client:{enabled:true,config:{timeout:30000,retry_count:3,default_headers:{User-Agent:OpenClaw/1.0},endpoints:{github:{base_url:https://api.github.com,auth:token YOUR_GITHUB_TOKEN},openai:{base_url:https://api.openai.com/v1,auth:Bearer YOUR_OPENAI_KEY}}}}}}8. 办公自动化技能安装clawhubinstalloffice-automation功能Word文档处理Excel表格操作PDF生成和编辑幻灯片制作Skills配置最佳实践1. 按需安装# 工作场景clawhubinstallbrowser-control file-operations scheduler# 开发场景clawhubinstallapi-client database git-operations# 生活场景clawhubinstallweather news-aggregator shopping-assistant2. 权限控制{skills:{file-operations:{enabled:true,permissions:{read:[~/Documents,~/Downloads],write:[~/Documents/OpenClaw],execute:[]// 禁止执行命令}}}}3. 技能组合# 创建自动化工作流clawhubinstallweb-scraper# 网页抓取clawhubinstall># 数据处理clawhubinstallreport-generator# 报告生成# 配置技能链# 1. web-scraper抓取数据# 2.># 3. report-generator生成报告4. 安全配置{skills:{system-commands:{enabled:true,config:{allowed_commands:[ls,cat,grep,find,df,du,ps,top],blocked_commands:[rm -rf,format,dd,shutdown,reboot],require_approval:true// 危险操作需要确认}}}} 六、完整配置示例典型个人助理配置# 1. 基础安装openclaw setup openclaw onboard# 2. 配置模型智谱AIopenclaw configsetproviders.zhipu.apiKeyYOUR_ZHIPU_API_KEYopenclaw modelssetglm-4.7-flash# 3. 添加渠道微信openclaw channelsadd--channelwechat openclaw channels login--channelwechat# 4. 安装常用技能clawhubinstallbrowser-control clawhubinstallfile-operations clawhubinstallweather clawhubinstallscheduler# 5. 启动服务openclaw gateway start企业工作流配置# 1. 基础配置openclaw setup--profilework openclaw onboard# 2. 配置企业渠道飞书openclaw channelsadd--channelfeishu\--app-idYOUR_APP_ID\--app-secretYOUR_APP_SECRET# 3. 安装办公技能clawhubinstalloffice-automation clawhubinstallemail-handler clawhubinstallmeeting-scheduler clawhubinstallreport-generator# 4. 配置数据库连接openclaw configsetskills.database.connections.main.hostdb.company.com# 5. 设置定时任务openclawcronadd0 9 * * 1-5daily-report 七、故障排查与维护常见问题解决# 1. 服务无法启动openclaw doctor--fixopenclaw gateway restart# 2. 渠道连接失败openclaw channels status--probeopenclaw logs--filtererror# 3. 技能加载失败openclaw skills check clawhubsync--all# 4. 内存不足openclaw configsetgateway.memory.limit2048# 限制2GB内存定期维护命令# 每周维护openclaw update# 更新版本clawhubsync--all# 同步技能openclaw backup create# 创建备份# 每月维护openclaw security audit# 安全审计openclaw memory index# 重建记忆索引openclaw config validate# 校验配置 八、总结与建议核心关系回顾Gateway是大脑Agent是员工Skills是专业技能Tools是工具Channels是沟通方式Nodes是延伸手臂所有组件通过Gateway协调工作配置优先级建议先配置Gateway和模型- 确保核心运行再添加1-2个渠道- 建立沟通通道然后安装核心技能- 浏览器、文件、定时任务最后按需扩展- 根据实际需求添加其他技能国内用户特别建议渠道选择优先考虑飞书/钉钉/企业微信稳定性更好模型选择智谱GLM、百度文心、阿里通义等国内模型技能来源关注ClawHub上的中文技能包网络配置确保能访问必要的API服务