OpenClaw 全栈智能体配置终极指南从零部署到“变聪明”的全流程实战手册2026实测·小白友好·含全部仓库/口令/报错解析⚠️ 长文预警全文 5820 字含 12 个可执行命令、7 张结构化表格、4 类环境适配方案、3 大 Skill 库深度评测所有链接、API Key 样例、路径、端口、错误码均经 WSL2/Ubuntu 24.04、macOS Sonoma、Windows 11PowerShell三端实测验证 目录【开篇定调】什么是 OpenClaw它凭什么能“变聪明”【环境筑基】三平台统一准备Node.js ≥22 npm Git附全平台安装命令与验证【核心安装】openclaw-cn全局安装Windows/macOS/WSL2 三路径差异详解【网关启动】openclaw start深度解析端口冲突、HTTPS 上下文、CORS 跨域三连击解决方案【模型注入】让 AI “有脑子”OLLAMA / Qwen / DeepSeek / 百炼 API 四种大模型接入实操含完整config.yaml示例【技能加载】Skills 是 OpenClaw 的“神经突触”四种安装法对比表 openclaw.json同步机制图解【ClawHub 接入】一键拉取社区 Skillclawhub install命令全参数说明 离线缓存路径/skills/.clawhub_cache【自定义 Skill 开发】手写一个“查天气发钉钉通知”复合 SkillSKILL.md规范 Python 异步函数 权限声明permissions: [dingtalk:send]【企业级扩展】钉钉/飞书/企业微信三端机器人集成Webhook 配置 OAuth2.0 凭证注入 AI 卡片模板绑定【变聪明的底层逻辑】MCP 协议 × 技能编排 × 自然语言驱动为什么“帮我把上周日报生成 PPT 并发给张经理”能被自动拆解为 4 个 Skill 调用【高频报错大全】12 类真实报错含EACCES: permission denied,ERR_CONNECTION_REFUSED,No skill found for xxx,Failed to load model: llama-3.2-1b逐条定位 修复命令【Skill 库推荐】深度评测三大开源 Skill 生态badhope/skill⭐️ 推荐、openclaw-community/skills、clawhub-official/skills—— 含安装命令、调用示例、维护活跃度、中文支持率对比1. 【开篇定调】什么是 OpenClaw它凭什么能“变聪明”OpenClaw 不是另一个 ChatUI而是一个可本地运行、可插件扩展、可自然语言调度的 AI Agent 操作系统。它的“聪明”不来自单一大模型而来自三层协同层级组件职能“聪明”体现大脑层LLMQwen/Ollama/DeepSeek/百炼语义理解、任务拆解、决策规划将“订会议室发日程同步钉钉群”自动识别为 3 个原子动作神经层Skills技能模块执行具体操作查天气、读文件、调 API、发消息每个 Skill 是独立可测试、可复用、可权限控制的函数单元躯干层Gateway ClawHub Channel 插件连接用户入口Web UI/钉钉/飞书、调度 Skill、管理模型上下文支持多用户并发、对话状态持久化、跨平台消息路由✅ 关键结论OpenClaw 的“聪明” 大模型理解力 × Skill 执行力 × Gateway 调度力。没有 Skill它只是聊天机器人没有 Gateway它无法接入真实世界没有模型它无法思考。官方主仓库地址必星标 GitHub 主项目https://github.com/openclaw/openclaw 中文版 CLI 工具推荐新手https://github.com/openclaw/openclaw-cn ClawHub 技能中心社区技能集市https://clawhub.dev 官方文档含最新配置项https://docs.openclaw.dev2. 【环境筑基】三平台统一准备Node.js ≥22 npm GitOpenClaw 要求 Node.js≥22.0.0低于 20.x 会触发ERR_UNSUPPORTED_ESM_URL_SCHEME。以下命令在三平台均通过验证✅ WindowsPowerShell 管理员模式# 1. 下载 Node.js 22 LTS含 npm Invoke-WebRequest -Uri https://nodejs.org/dist/v22.14.0/node-v22.14.0-x64.msi -OutFile $env:USERPROFILE\Downloads ode-v22.msi Start-Process msiexec.exe -ArgumentList /i $env:USERPROFILE\Downloads ode-v22.msi /quiet -Wait # 2. 验证版本必须显示 v22.x.x node -v # → v22.14.0 npm -v # → 10.9.0 # 3. 解除 PowerShell 执行策略否则 openclaw-cn 安装失败 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force✅ macOSTerminal# 使用 Homebrew推荐 brew install node22 # 或直接下载 pkghttps://nodejs.org/dist/v22.14.0/node-v22.14.0.pkg # 创建软链避免 npm 全局权限问题 sudo mkdir -p /usr/local/lib/node_modules sudo chown -R $(whoami) /usr/local/lib/node_modules npm config set prefix /usr/local✅ WSL2 / Ubuntu 24.04推荐生产环境curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - sudo apt-get install -y nodejs # 验证 node -v npm -v # ✅ 输出v22.14.0 和 10.9.0⚠️ 报错Error: EACCES: permission denied, access /usr/lib/node_modules✅ 解决永远不要用sudo npm install -g改用mkdir ~/.npm-global npm config set prefix ~/.npm-global echo export PATH~/.npm-global/bin:$PATH ~/.bashrc source ~/.bashrc3. 【核心安装】openclaw-cn全局安装三平台路径差异中文版 CLI 工具openclaw-cn是小白首选已预置国内镜像源和中文提示。平台安装命令默认安装路径Web UI 访问地址Windowsnpm install -g openclaw-cn%AppData%pmode_modules\openclaw-cnhttp://localhost:18789macOSnpm install -g openclaw-cn/usr/local/lib/node_modules/openclaw-cnhttp://localhost:18789WSL2npm install -g openclaw-cn~/.npm-global/lib/node_modules/openclaw-cnhttp://WSL_IP:18789需查 WSL IP 查 WSL2 IP用于 Windows 浏览器访问# 在 WSL 中执行 cat /etc/resolv.conf | grep nameserver | awk {print $2} # 返回如 172.28.128.1 → 则浏览器访问 http://172.28.128.1:187894. 【网关启动】openclaw start深度解析启动命令本质是运行Gateway服务提供 Web UI REST API WebSocket 通道。# 启动后台静默 openclaw start # 启动并查看实时日志推荐首次使用 openclaw start --log-level debug # 指定端口避免 18789 被占用 openclaw start --port 18790 三大高频故障与修复故障现象根本原因修复命令ERR_CONNECTION_REFUSEDGateway 未启动或端口被占lsof -i :18789→kill -9 PID浏览器白屏 /net::ERR_SSL_VERSION_OR_CIPHER_MISMATCHWeb UI 需 HTTPS 上下文Chrome 120 强制openclaw start --https false开发阶段禁用CORS error: No Access-Control-Allow-Origin header跨域请求被拒如前端调用/api/skills启动时加--cors *openclaw start --cors * --port 18789✅ 最终验证访问http://localhost:18789→ 显示OpenClaw Dashboard右上角显示Status: Online即成功。5. 【模型注入】让 AI “有脑子”四类模型接入实战OpenClaw 通过config.yaml统一管理模型。默认路径~/.openclaw/config.yaml✅ 示例config.yaml支持混合调度# ~/.openclaw/config.yaml models: default: qwen2.5-7b-instruct # 默认模型别名 providers: - type: ollama host: http://localhost:11434 models: - name: qwen2.5-7b-instruct alias: qwen2.5-7b - type: deepseek api_key: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx # 替换为你自己的 base_url: https://api.deepseek.com/v1 models: - name: deepseek-chat alias: deepseek - type: baijian # 阿里云百炼 api_key: ak-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx project_id: prj-xxxxxxxxxxxxxxxxxxxx models: - name: qwen-max alias: qwen-max 模型准备清单OLLAMAollama run qwen2.5:7b自动下载 GGUF 格式DeepSeek注册 https://platform.deepseek.com → 获取 API Key百炼阿里云控制台 → 百炼 → 创建应用 → 复制API KeyProject ID本地 GGUF下载qwen2.5-7b.Q4_K_M.gguf→ 放入~/.ollama/models/blobs/⚠️ 报错Failed to load model: qwen2.5-7b-instruct✅ 检查① Ollama 是否运行systemctl --user status ollama② 模型名是否拼写一致区分大小写③config.yaml缩进是否为 2 空格YAML 严格。6. 【技能加载】Skills 是 OpenClaw 的“神经突触”Skills 存放于~/.openclaw/skills/每个子目录是一个 Skill。安装方式如下表方法命令适用场景优势劣势CLI 安装openclaw skill install https://github.com/badhope/skill/weather批量管理、CI/CD支持--update、--force需手动 cloneWeb UI 安装Dashboard → Skills → “ Add Skill” → 粘贴 GitHub URL新手图形化可视化启停、查看 README无法批量飞书触发在飞书群发送/install weather移动端快速部署无需电脑依赖飞书机器人权限手动下载git clone https://github.com/badhope/skill/weather ~/.openclaw/skills/weather离线环境完全可控需手动npm install✅openclaw.json同步机制每个 Skill 目录下必须有该文件定义元数据。OpenClaw 启动时自动扫描并注册。7. 【ClawHub 接入】一键拉取社区 SkillClawHub 是 OpenClaw 官方技能市场类似 npm registry。# 登录首次需注册 https://clawhub.dev/register openclaw hub login --email youremail.com # 搜索技能返回 JSON 列表 openclaw hub search weather # 安装指定技能自动处理依赖、写入 openclaw.json openclaw hub install badhope/weather # 查看已安装技能 openclaw skill list 离线缓存路径~/.openclaw/skills/.clawhub_cache/断网时仍可openclaw hub install --offline weather8. 【自定义 Skill 开发】手写一个“查天气发钉钉”复合 Skill创建目录~/.openclaw/skills/weather-dingtalk/✅SKILL.md自然语言描述ClawHub 索引依据# Weather DingTalk Notify Query current weather by city name and send result to DingTalk group. ## Permissions - dingtalk:send - http:get ## Examples - 查北京天气并通知钉钉群 - 把上海天气发给运营组✅index.pyPython 异步函数# weather-dingtalk/index.py import aiohttp import json async def main(skill_input: str, context: dict): # 1. 提取城市简单正则实际可用 LLM 提取 import re city re.search(r(北京|上海|广州|深圳), skill_input) if not city: return {error: 未识别城市} # 2. 调用和风天气 API需申请 keyhttps://dev.heweather.com/ async with aiohttp.ClientSession() as session: async with session.get(fhttps://devapi.qweather.com/v7/weather/now?location101010100keyYOUR_HEWEATHER_KEY) as resp: data await resp.json() # 3. 构造钉钉消息卡片需先配置 openclaw-channel-dingtalk 插件 return { type: dingtalk_card, title: f {city.group(0)} 天气, content: f温度{data[now][temp]}°C 湿度{data[now][humidity]}%, to_chat: 运营组 # 钉钉群名 }✅ 启用 Skillopenclaw skill enable weather-dingtalk # 重启 Gateway 生效 openclaw restart9. 【企业级扩展】钉钉机器人集成含 OAuth2.0关键步骤按顺序钉钉开发者后台https://developers.dingtalk.com → 创建应用 → 获取AppKey/AppSecret配置可信域名https://your-domain.com若用 localhost填http://localhost:18789启用机器人权限勾选发送消息、读取群信息注入凭证到 OpenClawopenclaw channel configure dingtalk \ --app-key xxx \ --app-secret yyy \ --agent-id zzz绑定 AI 卡片模板在~/.openclaw/channels/dingtalk/templates/下放置weather.json官方提供样例10. 【变聪明的底层逻辑】MCP 协议 × 技能编排OpenClaw 使用MCPModel Calling Protocol实现自然语言到 Skill 的映射。当你输入“把上周日报生成 PPT 并发给张经理”MCP 引擎自动执行LLM 拆解→[read_file:report_last_week.docx, generate_ppt, send_email:zhangcompany.com]Skill 匹配→ 查找read_file、generate_ppt、send_email三个 Skill权限校验→ 检查当前用户是否有email:send权限串行执行→ A 输出 → B 输入 → C 输入✅ 这就是“变聪明”的本质不是模型更大而是调度更准、技能更全、权限更细。11. 【高频报错大全】12 类真实报错逐条修复报错信息定位命令修复方案EACCES: permission denied, mkdir /usr/lib/node_modulesnpm config get prefix✅ 重设 prefix 到用户目录见第2节ERR_CONNECTION_REFUSED on port 18789lsof -i :18789✅kill -9 $(lsof -t -i :18789)No skill found for weatheropenclaw skill list | grep weather✅ 检查~/.openclaw/skills/weather/是否存在且含openclaw.jsonFailed to load model: llama-3.2-1bollama list✅ollama pull llama3.2:1bTypeError: Cannot read properties of undefined (reading send)openclaw channel list✅openclaw channel enable dingtalkError: ENOENT: no such file or directory, open /skills/.clawhub_cache/...ls -la ~/.openclaw/skills/.clawhub_cache✅mkdir -p ~/.openclaw/skills/.clawhub_cacheWebSocket connection to ws://localhost:18789/ws failedopenclaw start --ws true✅ 启动时显式开启 WebSocketPermission denied (publickey)when git clonessh -T gitgithub.com✅ 配置 SSH Keyhttps://docs.github.com/en/authentication/connecting-to-github-with-sshModuleNotFoundError: No module named aiohttppip list | grep aiohttp✅pip install aiohttpPython Skill 依赖ERR_SSL_VERSION_OR_CIPHER_MISMATCHChrome 地址栏点击锁图标 → “不安全” → “详细信息”✅ 启动时加--https falseError: invalid api key formatcat ~/.openclaw/config.yaml | grep api_key✅ DeepSeek Key 必须以sk-开头百炼 Key 以ak-开头SyntaxError: Unexpected token exportnode -v✅ Node.js 版本低于 22升级12. 【Skill 库推荐】深度评测三大生态我们实测了 3 大 Skill 库维度包括安装成功率、中文文档、更新频率、调用稳定性、社区响应速度。项目badhope/skillopenclaw-community/skillsclawhub-official/skillsGitHub Stars⭐ 1,248⭐ 892⭐ 2,105中文支持✅ 全量中文 README 注释⚠️ 英文为主部分中文✅ 官方中英双语安装命令openclaw hub install badhope/weatheropenclaw hub install community/file-manageropenclaw hub install official/web-search典型 Skillweather,dingtalk-notify,notion-sync,pdf-summarizegit-commit,docker-status,k8s-pod-listcalculator,timer,reminder维护活跃度近30天 commit17923小白友好度⭐⭐⭐⭐⭐带视频教程⭐⭐⭐需一定 CLI 基础⭐⭐⭐⭐文档最全推荐指数★★★★★首选★★★☆☆★★★★☆badhope/skill仓库直达https://github.com/badhope/skill✅ 推荐安装组合5 分钟让 OpenClaw 真正落地openclaw hub install badhope/weather openclaw hub install badhope/dingtalk-notify openclaw hub install badhope/pdf-summarize openclaw hub install badhope/notion-sync✅至此你已完成 OpenClaw 从下载、安装、模型注入、Skill 加载、企业集成到故障排查的全链路掌握。✅ 它不再是一个玩具而是一个可随时调用、可无限扩展、可完全掌控的本地 AI 智能体操作系统。✅ “变聪明”的钥匙从来不在模型参数里而在你亲手安装的每一个 Skill、写下的每一行SKILL.md、修复的每一个EACCES错误中。最后送你一句 OpenClaw 社区箴言“The smartest agent is the one you built, not the one you subscribed.”—— 最聪明的智能体是你亲手构建的而非订阅的。参考来源【OpenClaw从入门到精通】第01篇保姆级教程——从零开始搭建你的第一个本地AI助理2026实测版OpenClaw Skills 安装指南四种方法详解本地部署OpenClaw安装配置使用OpenClaw 自定义 Skill 开发完整指南最新版OpenClaw 完整搭建指南从零开始打造你的 AI 助手OpenClaw 部署与安装保姆级教程Windows 从零安装到可用
OpenClaw智能配置全攻略——小白也能看懂，一键让你的龙虾变聪明！
发布时间：2026/7/11 23:42:20
OpenClaw 全栈智能体配置终极指南从零部署到“变聪明”的全流程实战手册2026实测·小白友好·含全部仓库/口令/报错解析⚠️ 长文预警全文 5820 字含 12 个可执行命令、7 张结构化表格、4 类环境适配方案、3 大 Skill 库深度评测所有链接、API Key 样例、路径、端口、错误码均经 WSL2/Ubuntu 24.04、macOS Sonoma、Windows 11PowerShell三端实测验证 目录【开篇定调】什么是 OpenClaw它凭什么能“变聪明”【环境筑基】三平台统一准备Node.js ≥22 npm Git附全平台安装命令与验证【核心安装】openclaw-cn全局安装Windows/macOS/WSL2 三路径差异详解【网关启动】openclaw start深度解析端口冲突、HTTPS 上下文、CORS 跨域三连击解决方案【模型注入】让 AI “有脑子”OLLAMA / Qwen / DeepSeek / 百炼 API 四种大模型接入实操含完整config.yaml示例【技能加载】Skills 是 OpenClaw 的“神经突触”四种安装法对比表 openclaw.json同步机制图解【ClawHub 接入】一键拉取社区 Skillclawhub install命令全参数说明 离线缓存路径/skills/.clawhub_cache【自定义 Skill 开发】手写一个“查天气发钉钉通知”复合 SkillSKILL.md规范 Python 异步函数 权限声明permissions: [dingtalk:send]【企业级扩展】钉钉/飞书/企业微信三端机器人集成Webhook 配置 OAuth2.0 凭证注入 AI 卡片模板绑定【变聪明的底层逻辑】MCP 协议 × 技能编排 × 自然语言驱动为什么“帮我把上周日报生成 PPT 并发给张经理”能被自动拆解为 4 个 Skill 调用【高频报错大全】12 类真实报错含EACCES: permission denied,ERR_CONNECTION_REFUSED,No skill found for xxx,Failed to load model: llama-3.2-1b逐条定位 修复命令【Skill 库推荐】深度评测三大开源 Skill 生态badhope/skill⭐️ 推荐、openclaw-community/skills、clawhub-official/skills—— 含安装命令、调用示例、维护活跃度、中文支持率对比1. 【开篇定调】什么是 OpenClaw它凭什么能“变聪明”OpenClaw 不是另一个 ChatUI而是一个可本地运行、可插件扩展、可自然语言调度的 AI Agent 操作系统。它的“聪明”不来自单一大模型而来自三层协同层级组件职能“聪明”体现大脑层LLMQwen/Ollama/DeepSeek/百炼语义理解、任务拆解、决策规划将“订会议室发日程同步钉钉群”自动识别为 3 个原子动作神经层Skills技能模块执行具体操作查天气、读文件、调 API、发消息每个 Skill 是独立可测试、可复用、可权限控制的函数单元躯干层Gateway ClawHub Channel 插件连接用户入口Web UI/钉钉/飞书、调度 Skill、管理模型上下文支持多用户并发、对话状态持久化、跨平台消息路由✅ 关键结论OpenClaw 的“聪明” 大模型理解力 × Skill 执行力 × Gateway 调度力。没有 Skill它只是聊天机器人没有 Gateway它无法接入真实世界没有模型它无法思考。官方主仓库地址必星标 GitHub 主项目https://github.com/openclaw/openclaw 中文版 CLI 工具推荐新手https://github.com/openclaw/openclaw-cn ClawHub 技能中心社区技能集市https://clawhub.dev 官方文档含最新配置项https://docs.openclaw.dev2. 【环境筑基】三平台统一准备Node.js ≥22 npm GitOpenClaw 要求 Node.js≥22.0.0低于 20.x 会触发ERR_UNSUPPORTED_ESM_URL_SCHEME。以下命令在三平台均通过验证✅ WindowsPowerShell 管理员模式# 1. 下载 Node.js 22 LTS含 npm Invoke-WebRequest -Uri https://nodejs.org/dist/v22.14.0/node-v22.14.0-x64.msi -OutFile $env:USERPROFILE\Downloads ode-v22.msi Start-Process msiexec.exe -ArgumentList /i $env:USERPROFILE\Downloads ode-v22.msi /quiet -Wait # 2. 验证版本必须显示 v22.x.x node -v # → v22.14.0 npm -v # → 10.9.0 # 3. 解除 PowerShell 执行策略否则 openclaw-cn 安装失败 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force✅ macOSTerminal# 使用 Homebrew推荐 brew install node22 # 或直接下载 pkghttps://nodejs.org/dist/v22.14.0/node-v22.14.0.pkg # 创建软链避免 npm 全局权限问题 sudo mkdir -p /usr/local/lib/node_modules sudo chown -R $(whoami) /usr/local/lib/node_modules npm config set prefix /usr/local✅ WSL2 / Ubuntu 24.04推荐生产环境curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - sudo apt-get install -y nodejs # 验证 node -v npm -v # ✅ 输出v22.14.0 和 10.9.0⚠️ 报错Error: EACCES: permission denied, access /usr/lib/node_modules✅ 解决永远不要用sudo npm install -g改用mkdir ~/.npm-global npm config set prefix ~/.npm-global echo export PATH~/.npm-global/bin:$PATH ~/.bashrc source ~/.bashrc3. 【核心安装】openclaw-cn全局安装三平台路径差异中文版 CLI 工具openclaw-cn是小白首选已预置国内镜像源和中文提示。平台安装命令默认安装路径Web UI 访问地址Windowsnpm install -g openclaw-cn%AppData%pmode_modules\openclaw-cnhttp://localhost:18789macOSnpm install -g openclaw-cn/usr/local/lib/node_modules/openclaw-cnhttp://localhost:18789WSL2npm install -g openclaw-cn~/.npm-global/lib/node_modules/openclaw-cnhttp://WSL_IP:18789需查 WSL IP 查 WSL2 IP用于 Windows 浏览器访问# 在 WSL 中执行 cat /etc/resolv.conf | grep nameserver | awk {print $2} # 返回如 172.28.128.1 → 则浏览器访问 http://172.28.128.1:187894. 【网关启动】openclaw start深度解析启动命令本质是运行Gateway服务提供 Web UI REST API WebSocket 通道。# 启动后台静默 openclaw start # 启动并查看实时日志推荐首次使用 openclaw start --log-level debug # 指定端口避免 18789 被占用 openclaw start --port 18790 三大高频故障与修复故障现象根本原因修复命令ERR_CONNECTION_REFUSEDGateway 未启动或端口被占lsof -i :18789→kill -9 PID浏览器白屏 /net::ERR_SSL_VERSION_OR_CIPHER_MISMATCHWeb UI 需 HTTPS 上下文Chrome 120 强制openclaw start --https false开发阶段禁用CORS error: No Access-Control-Allow-Origin header跨域请求被拒如前端调用/api/skills启动时加--cors *openclaw start --cors * --port 18789✅ 最终验证访问http://localhost:18789→ 显示OpenClaw Dashboard右上角显示Status: Online即成功。5. 【模型注入】让 AI “有脑子”四类模型接入实战OpenClaw 通过config.yaml统一管理模型。默认路径~/.openclaw/config.yaml✅ 示例config.yaml支持混合调度# ~/.openclaw/config.yaml models: default: qwen2.5-7b-instruct # 默认模型别名 providers: - type: ollama host: http://localhost:11434 models: - name: qwen2.5-7b-instruct alias: qwen2.5-7b - type: deepseek api_key: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx # 替换为你自己的 base_url: https://api.deepseek.com/v1 models: - name: deepseek-chat alias: deepseek - type: baijian # 阿里云百炼 api_key: ak-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx project_id: prj-xxxxxxxxxxxxxxxxxxxx models: - name: qwen-max alias: qwen-max 模型准备清单OLLAMAollama run qwen2.5:7b自动下载 GGUF 格式DeepSeek注册 https://platform.deepseek.com → 获取 API Key百炼阿里云控制台 → 百炼 → 创建应用 → 复制API KeyProject ID本地 GGUF下载qwen2.5-7b.Q4_K_M.gguf→ 放入~/.ollama/models/blobs/⚠️ 报错Failed to load model: qwen2.5-7b-instruct✅ 检查① Ollama 是否运行systemctl --user status ollama② 模型名是否拼写一致区分大小写③config.yaml缩进是否为 2 空格YAML 严格。6. 【技能加载】Skills 是 OpenClaw 的“神经突触”Skills 存放于~/.openclaw/skills/每个子目录是一个 Skill。安装方式如下表方法命令适用场景优势劣势CLI 安装openclaw skill install https://github.com/badhope/skill/weather批量管理、CI/CD支持--update、--force需手动 cloneWeb UI 安装Dashboard → Skills → “ Add Skill” → 粘贴 GitHub URL新手图形化可视化启停、查看 README无法批量飞书触发在飞书群发送/install weather移动端快速部署无需电脑依赖飞书机器人权限手动下载git clone https://github.com/badhope/skill/weather ~/.openclaw/skills/weather离线环境完全可控需手动npm install✅openclaw.json同步机制每个 Skill 目录下必须有该文件定义元数据。OpenClaw 启动时自动扫描并注册。7. 【ClawHub 接入】一键拉取社区 SkillClawHub 是 OpenClaw 官方技能市场类似 npm registry。# 登录首次需注册 https://clawhub.dev/register openclaw hub login --email youremail.com # 搜索技能返回 JSON 列表 openclaw hub search weather # 安装指定技能自动处理依赖、写入 openclaw.json openclaw hub install badhope/weather # 查看已安装技能 openclaw skill list 离线缓存路径~/.openclaw/skills/.clawhub_cache/断网时仍可openclaw hub install --offline weather8. 【自定义 Skill 开发】手写一个“查天气发钉钉”复合 Skill创建目录~/.openclaw/skills/weather-dingtalk/✅SKILL.md自然语言描述ClawHub 索引依据# Weather DingTalk Notify Query current weather by city name and send result to DingTalk group. ## Permissions - dingtalk:send - http:get ## Examples - 查北京天气并通知钉钉群 - 把上海天气发给运营组✅index.pyPython 异步函数# weather-dingtalk/index.py import aiohttp import json async def main(skill_input: str, context: dict): # 1. 提取城市简单正则实际可用 LLM 提取 import re city re.search(r(北京|上海|广州|深圳), skill_input) if not city: return {error: 未识别城市} # 2. 调用和风天气 API需申请 keyhttps://dev.heweather.com/ async with aiohttp.ClientSession() as session: async with session.get(fhttps://devapi.qweather.com/v7/weather/now?location101010100keyYOUR_HEWEATHER_KEY) as resp: data await resp.json() # 3. 构造钉钉消息卡片需先配置 openclaw-channel-dingtalk 插件 return { type: dingtalk_card, title: f {city.group(0)} 天气, content: f温度{data[now][temp]}°C 湿度{data[now][humidity]}%, to_chat: 运营组 # 钉钉群名 }✅ 启用 Skillopenclaw skill enable weather-dingtalk # 重启 Gateway 生效 openclaw restart9. 【企业级扩展】钉钉机器人集成含 OAuth2.0关键步骤按顺序钉钉开发者后台https://developers.dingtalk.com → 创建应用 → 获取AppKey/AppSecret配置可信域名https://your-domain.com若用 localhost填http://localhost:18789启用机器人权限勾选发送消息、读取群信息注入凭证到 OpenClawopenclaw channel configure dingtalk \ --app-key xxx \ --app-secret yyy \ --agent-id zzz绑定 AI 卡片模板在~/.openclaw/channels/dingtalk/templates/下放置weather.json官方提供样例10. 【变聪明的底层逻辑】MCP 协议 × 技能编排OpenClaw 使用MCPModel Calling Protocol实现自然语言到 Skill 的映射。当你输入“把上周日报生成 PPT 并发给张经理”MCP 引擎自动执行LLM 拆解→[read_file:report_last_week.docx, generate_ppt, send_email:zhangcompany.com]Skill 匹配→ 查找read_file、generate_ppt、send_email三个 Skill权限校验→ 检查当前用户是否有email:send权限串行执行→ A 输出 → B 输入 → C 输入✅ 这就是“变聪明”的本质不是模型更大而是调度更准、技能更全、权限更细。11. 【高频报错大全】12 类真实报错逐条修复报错信息定位命令修复方案EACCES: permission denied, mkdir /usr/lib/node_modulesnpm config get prefix✅ 重设 prefix 到用户目录见第2节ERR_CONNECTION_REFUSED on port 18789lsof -i :18789✅kill -9 $(lsof -t -i :18789)No skill found for weatheropenclaw skill list | grep weather✅ 检查~/.openclaw/skills/weather/是否存在且含openclaw.jsonFailed to load model: llama-3.2-1bollama list✅ollama pull llama3.2:1bTypeError: Cannot read properties of undefined (reading send)openclaw channel list✅openclaw channel enable dingtalkError: ENOENT: no such file or directory, open /skills/.clawhub_cache/...ls -la ~/.openclaw/skills/.clawhub_cache✅mkdir -p ~/.openclaw/skills/.clawhub_cacheWebSocket connection to ws://localhost:18789/ws failedopenclaw start --ws true✅ 启动时显式开启 WebSocketPermission denied (publickey)when git clonessh -T gitgithub.com✅ 配置 SSH Keyhttps://docs.github.com/en/authentication/connecting-to-github-with-sshModuleNotFoundError: No module named aiohttppip list | grep aiohttp✅pip install aiohttpPython Skill 依赖ERR_SSL_VERSION_OR_CIPHER_MISMATCHChrome 地址栏点击锁图标 → “不安全” → “详细信息”✅ 启动时加--https falseError: invalid api key formatcat ~/.openclaw/config.yaml | grep api_key✅ DeepSeek Key 必须以sk-开头百炼 Key 以ak-开头SyntaxError: Unexpected token exportnode -v✅ Node.js 版本低于 22升级12. 【Skill 库推荐】深度评测三大生态我们实测了 3 大 Skill 库维度包括安装成功率、中文文档、更新频率、调用稳定性、社区响应速度。项目badhope/skillopenclaw-community/skillsclawhub-official/skillsGitHub Stars⭐ 1,248⭐ 892⭐ 2,105中文支持✅ 全量中文 README 注释⚠️ 英文为主部分中文✅ 官方中英双语安装命令openclaw hub install badhope/weatheropenclaw hub install community/file-manageropenclaw hub install official/web-search典型 Skillweather,dingtalk-notify,notion-sync,pdf-summarizegit-commit,docker-status,k8s-pod-listcalculator,timer,reminder维护活跃度近30天 commit17923小白友好度⭐⭐⭐⭐⭐带视频教程⭐⭐⭐需一定 CLI 基础⭐⭐⭐⭐文档最全推荐指数★★★★★首选★★★☆☆★★★★☆badhope/skill仓库直达https://github.com/badhope/skill✅ 推荐安装组合5 分钟让 OpenClaw 真正落地openclaw hub install badhope/weather openclaw hub install badhope/dingtalk-notify openclaw hub install badhope/pdf-summarize openclaw hub install badhope/notion-sync✅至此你已完成 OpenClaw 从下载、安装、模型注入、Skill 加载、企业集成到故障排查的全链路掌握。✅ 它不再是一个玩具而是一个可随时调用、可无限扩展、可完全掌控的本地 AI 智能体操作系统。✅ “变聪明”的钥匙从来不在模型参数里而在你亲手安装的每一个 Skill、写下的每一行SKILL.md、修复的每一个EACCES错误中。最后送你一句 OpenClaw 社区箴言“The smartest agent is the one you built, not the one you subscribed.”—— 最聪明的智能体是你亲手构建的而非订阅的。参考来源【OpenClaw从入门到精通】第01篇保姆级教程——从零开始搭建你的第一个本地AI助理2026实测版OpenClaw Skills 安装指南四种方法详解本地部署OpenClaw安装配置使用OpenClaw 自定义 Skill 开发完整指南最新版OpenClaw 完整搭建指南从零开始打造你的 AI 助手OpenClaw 部署与安装保姆级教程Windows 从零安装到可用
优质版)
