<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/"><channel><title>OpenClaw on heyaohua's Blog</title><link>https://blog.heyaohua.com/tags/openclaw/</link><description>Recent content in OpenClaw on heyaohua's Blog</description><image><title>heyaohua's Blog</title><url>https://blog.heyaohua.com/og-image.png</url><link>https://blog.heyaohua.com/og-image.png</link></image><generator>Hugo</generator><language>zh-cn</language><lastBuildDate>Sun, 22 Mar 2026 10:56:00 +0800</lastBuildDate><atom:link href="https://blog.heyaohua.com/tags/openclaw/index.xml" rel="self" type="application/rss+xml"/><item><title>OpenClaw 技能插件完全指南：31个 Skill 详解与实战</title><link>https://blog.heyaohua.com/posts/2026/03/openclaw-skills-complete-guide/</link><pubDate>Sun, 22 Mar 2026 10:56:00 +0800</pubDate><guid>https://blog.heyaohua.com/posts/2026/03/openclaw-skills-complete-guide/</guid><description>OpenClaw 的 Skill 生态详解：涵盖 12 个社区插件和 19 个内置技能，每个 Skill 的功能、原理、调用方式和实战案例。</description><content:encoded><![CDATA[<h2 id="前言">前言</h2>
<p><a href="https://github.com/openclaw/openclaw">OpenClaw</a> 最强大的地方在于它的技能（Skill）生态系统。Skill 是预定义的能力模块，让 AI Agent 能够执行特定任务——从发送邮件到操作浏览器，从查询股票到管理飞书文档。</p>
<p>本文将详细介绍我的 OpenClaw 实例中安装的所有 31 个 Skill，涵盖功能、工作原理、调用方式和实际使用场景。</p>
<h2 id="skill-系统原理">Skill 系统原理</h2>
<h3 id="什么是-skill">什么是 Skill？</h3>
<p>Skill 本质上是一个包含 <code>SKILL.md</code> 指令文件的目录。当用户发送消息时，OpenClaw 的 Agent 会扫描消息内容，匹配到相关的 Skill 后加载其 <code>SKILL.md</code> 作为上下文，从而获得执行该任务所需的知识和能力。</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-text" data-lang="text"><span style="display:flex;"><span>~/.openclaw/skills/
</span></span><span style="display:flex;"><span>├── my-skill/
</span></span><span style="display:flex;"><span>│   ├── SKILL.md          # 技能定义文件（核心）
</span></span><span style="display:flex;"><span>│   ├── _meta.json        # 元数据
</span></span><span style="display:flex;"><span>│   ├── scripts/          # 脚本文件
</span></span><span style="display:flex;"><span>│   └── references/       # 参考资料
</span></span></code></pre></div><h3 id="调用流程">调用流程</h3>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-text" data-lang="text"><span style="display:flex;"><span>用户消息 → Agent 语义匹配 → 加载对应 SKILL.md → Agent 根据指令执行 → 调用脚本/工具/API
</span></span></code></pre></div><p>Agent 不需要显式调用 Skill，它会根据对话内容自动识别需要哪个 Skill。你也可以在消息中明确提到 Skill 名称来触发。</p>
<h3 id="安装方式">安装方式</h3>
<p>Skill 有三种来源：</p>
<ol>
<li><strong>内置 Skill</strong> — 随 OpenClaw 安装，开箱即用</li>
<li><strong>ClawHub 社区 Skill</strong> — 从 <a href="https://clawhub.ai">clawhub.ai</a> 下载安装</li>
<li><strong>自定义 Skill</strong> — 自己编写，放到 <code>~/.openclaw/skills/</code> 目录</li>
</ol>
<hr>
<h2 id="一社区安装的-skills12个">一、社区安装的 Skills（12个）</h2>
<h3 id="1-agent-browser--stagehand-浏览器自动化">1. agent-browser — Stagehand 浏览器自动化</h3>
<p><strong>功能</strong>：基于 Stagehand 框架的浏览器自动化工具，可以操控网页、填写表单、点击按钮、提取数据等。</p>
<p><strong>原理</strong>：Stagehand 是一个 AI 驱动的浏览器自动化库，通过自然语言描述来控制浏览器，不需要写传统的 CSS 选择器。</p>
<p><strong>安装来源</strong>：<a href="https://clawhub.ai/MaTriXy/agent-browser-clawdbot">ClawHub - agent-browser</a></p>
<p><strong>使用场景</strong>：</p>
<ul>
<li>自动登录网站并抓取数据</li>
<li>填写和提交在线表单</li>
<li>网页截图和数据提取</li>
</ul>
<hr>
<h3 id="2-auto-updater--系统包自动更新">2. auto-updater — 系统包自动更新</h3>
<p><strong>功能</strong>：检查并更新系统软件包，支持 apt、npm、pip 等包管理器。</p>
<p><strong>原理</strong>：通过执行系统命令检查可更新的包，并按照安全策略执行更新。</p>
<p><strong>安装来源</strong>：<a href="https://clawhub.ai/maximeprades/auto-updater">ClawHub - auto-updater</a></p>
<p><strong>使用场景</strong>：</p>
<ul>
<li>定期检查服务器安全更新</li>
<li>批量更新 npm/pip 依赖</li>
<li>生成更新报告</li>
</ul>
<hr>
<h3 id="3-automation-workflows--自动化工作流">3. automation-workflows — 自动化工作流</h3>
<p><strong>功能</strong>：定义和管理自动化工作流，将多个步骤串联成可重复执行的流程。</p>
<p><strong>原理</strong>：通过声明式配置定义工作流的步骤、条件和触发器，Agent 按顺序执行。</p>
<p><strong>安装来源</strong>：<a href="https://clawhub.ai/JK-0001/automation-workflows">ClawHub - automation-workflows</a></p>
<p><strong>使用场景</strong>：</p>
<ul>
<li>定义「收到邮件 → 分析内容 → 回复」的自动化流程</li>
<li>定时任务编排</li>
<li>多步骤数据处理管道</li>
</ul>
<hr>
<h3 id="4-browser-use--ai-浏览器操作">4. browser-use — AI 浏览器操作</h3>
<p><strong>功能</strong>：另一个 AI 驱动的浏览器自动化工具，基于 Python 的 <code>browser-use</code> 库。</p>
<p><strong>原理</strong>：使用 Playwright 作为浏览器引擎，配合 LLM 理解网页内容并执行操作。与 agent-browser 的区别在于技术栈不同（Python vs Node.js）。</p>
<p><strong>安装方式</strong>：</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>uv tool install <span style="color:#f1fa8c">&#34;browser-use[cli]&#34;</span>
</span></span></code></pre></div><p><strong>使用场景</strong>：</p>
<ul>
<li>复杂的网页交互（多步骤操作）</li>
<li>需要登录状态的网站操作</li>
<li>网页数据批量采集</li>
</ul>
<p><strong>注意事项</strong>：如果服务器配置了 socks5 代理，可能需要 patch 启动脚本清除 <code>all_proxy</code> 环境变量。</p>
<hr>
<h3 id="5-clawddocs--openclaw-文档专家">5. clawddocs — OpenClaw 文档专家</h3>
<p><strong>功能</strong>：查询和理解 OpenClaw 官方文档，帮助排查配置问题和了解新功能。</p>
<p><strong>原理</strong>：包含 OpenClaw 文档的索引和查询脚本，Agent 可以快速定位相关文档内容。</p>
<p><strong>安装来源</strong>：<a href="https://clawhub.ai/NicholasSpisak/clawddocs">ClawHub - clawddocs</a></p>
<p><strong>使用场景</strong>：</p>
<ul>
<li>查询 OpenClaw 配置选项</li>
<li>排查部署问题</li>
<li>了解新版本特性</li>
</ul>
<hr>
<h3 id="6-evolver--ai-自我进化引擎">6. evolver — AI 自我进化引擎</h3>
<p><strong>功能</strong>：分析 Agent 的运行历史，识别改进机会，在协议约束下进行自我进化。</p>
<p><strong>原理</strong>：通过分析对话日志、任务执行记录，提取模式并生成改进建议，然后自动更新配置或创建新的技能。</p>
<p><strong>安装来源</strong>：<a href="https://clawhub.ai/autogame-17/evolver">ClawHub - evolver</a></p>
<p><strong>使用场景</strong>：</p>
<ul>
<li>自动优化 Agent 行为</li>
<li>从错误中学习并创建防护规则</li>
<li>生成新 Skill 的草稿</li>
</ul>
<hr>
<h3 id="7-imap-smtp-email--邮件收发">7. imap-smtp-email — 邮件收发</h3>
<p><strong>功能</strong>：通过 IMAP 收取邮件、通过 SMTP 发送邮件，支持多账号配置。</p>
<p><strong>原理</strong>：Node.js 脚本封装了 <code>imapflow</code> 和 <code>nodemailer</code> 库，提供命令行接口。</p>
<p><strong>核心命令</strong>：</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span><span style="color:#6272a4"># 检查邮箱</span>
</span></span><span style="display:flex;"><span>node scripts/imap.js check
</span></span><span style="display:flex;"><span>node scripts/imap.js check --account qq  <span style="color:#6272a4"># 指定账号</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#6272a4"># 搜索邮件</span>
</span></span><span style="display:flex;"><span>node scripts/imap.js search --query <span style="color:#f1fa8c">&#34;关键词&#34;</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#6272a4"># 获取邮件详情</span>
</span></span><span style="display:flex;"><span>node scripts/imap.js fetch --uid <span style="color:#bd93f9">1234</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#6272a4"># 下载附件</span>
</span></span><span style="display:flex;"><span>node scripts/imap.js download --uid <span style="color:#bd93f9">1234</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#6272a4"># 列出邮箱文件夹</span>
</span></span><span style="display:flex;"><span>node scripts/imap.js list-mailboxes
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#6272a4"># 发送邮件</span>
</span></span><span style="display:flex;"><span>node scripts/smtp.js send --to <span style="color:#f1fa8c">&#34;target@example.com&#34;</span> --subject <span style="color:#f1fa8c">&#34;主题&#34;</span> --body <span style="color:#f1fa8c">&#34;内容&#34;</span>
</span></span></code></pre></div><p><strong>配置方式</strong>：在 <code>~/.config/imap-smtp-email/.env</code> 中配置邮箱账号：</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-text" data-lang="text"><span style="display:flex;"><span>IMAP_HOST=imap.163.com
</span></span><span style="display:flex;"><span>IMAP_PORT=993
</span></span><span style="display:flex;"><span>IMAP_USER=your@email.com
</span></span><span style="display:flex;"><span>IMAP_PASS=your_password
</span></span><span style="display:flex;"><span>IMAP_TLS=true
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>SMTP_HOST=smtp.163.com
</span></span><span style="display:flex;"><span>SMTP_PORT=465
</span></span><span style="display:flex;"><span>SMTP_USER=your@email.com
</span></span><span style="display:flex;"><span>SMTP_PASS=your_password
</span></span><span style="display:flex;"><span>SMTP_TLS=true
</span></span></code></pre></div><p><strong>支持的邮箱</strong>：Gmail、Outlook、163、QQ、iCloud 等所有支持 IMAP/SMTP 的邮箱。</p>
<hr>
<h3 id="8-nano-banana-pro--gemini-pdf-工具">8. nano-banana-pro — Gemini PDF 工具</h3>
<p><strong>功能</strong>：使用 Google Gemini 模型处理和分析 PDF 文件。</p>
<p><strong>原理</strong>：调用 Gemini API 的多模态能力，将 PDF 内容（包括图表、图片）发送给 Gemini 进行分析。</p>
<p><strong>安装来源</strong>：<a href="https://clawhub.ai/hanzoskill/nano-banana-pro">ClawHub - nano-banana-pro</a></p>
<p><strong>前置条件</strong>：需要配置 Gemini API Key。</p>
<hr>
<h3 id="9-polymarket-trade--polymarket-预测市场">9. polymarket-trade — Polymarket 预测市场</h3>
<p><strong>功能</strong>：查询 Polymarket 预测市场数据，包括热门事件、赔率、价格趋势等。</p>
<p><strong>原理</strong>：通过 Polymarket 的公开 API 获取市场数据，不需要 API Key。</p>
<p><strong>核心命令</strong>：</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span><span style="color:#6272a4"># 查看热门市场</span>
</span></span><span style="display:flex;"><span>python3 scripts/polymarket.py trending
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#6272a4"># 搜索特定事件</span>
</span></span><span style="display:flex;"><span>python3 scripts/polymarket.py search --query <span style="color:#f1fa8c">&#34;election&#34;</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#6272a4"># 查看市场详情</span>
</span></span><span style="display:flex;"><span>python3 scripts/polymarket.py market --id <span style="color:#f1fa8c">&#34;市场ID&#34;</span>
</span></span></code></pre></div><p><strong>使用场景</strong>：</p>
<ul>
<li>跟踪大选、科技发布等事件预测</li>
<li>查看市场趋势和交易量</li>
<li>设置价格提醒</li>
</ul>
<hr>
<h3 id="10-self-improving-agent--ai-自我学习">10. self-improving-agent — AI 自我学习</h3>
<p><strong>功能</strong>：让 Agent 具备自我反思和改进的能力，从执行结果中学习。</p>
<p><strong>原理</strong>：记录每次任务执行的过程和结果，定期分析成功/失败模式，更新行为策略。</p>
<p><strong>安装来源</strong>：<a href="https://clawhub.ai/hanzoskill/self-improving-agent">ClawHub - self-improving-agent</a></p>
<p><strong>使用场景</strong>：</p>
<ul>
<li>代码生成后自动测试并改进</li>
<li>从用户反馈中学习偏好</li>
<li>优化常用任务的执行策略</li>
</ul>
<hr>
<h3 id="11-stock-analysis--股票分析">11. stock-analysis — 股票分析</h3>
<p><strong>功能</strong>：通过 yfinance 获取股票实时行情、历史数据、财务报表等。</p>
<p><strong>原理</strong>：基于 Python 的 <code>yfinance</code> 库，调用 Yahoo Finance API 获取股票数据。</p>
<p><strong>核心功能</strong>：</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span><span style="color:#6272a4"># 查看股票价格</span>
</span></span><span style="display:flex;"><span>python3 scripts/stock_analysis.py price --ticker AAPL
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#6272a4"># 查看财务数据</span>
</span></span><span style="display:flex;"><span>python3 scripts/stock_analysis.py financials --ticker AAPL
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#6272a4"># 管理自选股</span>
</span></span><span style="display:flex;"><span>python3 scripts/watchlist.py add AAPL
</span></span><span style="display:flex;"><span>python3 scripts/watchlist.py list
</span></span></code></pre></div><p><strong>使用场景</strong>：</p>
<ul>
<li>快速查看股票行情</li>
<li>对比分析多只股票</li>
<li>管理个人自选股列表</li>
</ul>
<hr>
<h3 id="12-youtube-watcher--youtube-字幕获取">12. youtube-watcher — YouTube 字幕获取</h3>
<p><strong>功能</strong>：获取 YouTube 视频的字幕/转录文本，支持多语言字幕。</p>
<p><strong>原理</strong>：使用 <code>youtube-transcript-api</code> 库，通过视频 ID 获取 YouTube 的隐藏字幕数据。</p>
<p><strong>核心命令</strong>：</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span><span style="color:#6272a4"># 获取字幕</span>
</span></span><span style="display:flex;"><span>python3 scripts/get_transcript.py --url <span style="color:#f1fa8c">&#34;https://youtube.com/watch?v=VIDEO_ID&#34;</span>
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#6272a4"># 指定语言</span>
</span></span><span style="display:flex;"><span>python3 scripts/get_transcript.py --url <span style="color:#f1fa8c">&#34;视频URL&#34;</span> --lang zh
</span></span></code></pre></div><p><strong>使用场景</strong>：</p>
<ul>
<li>快速提取视频内容要点</li>
<li>生成视频摘要</li>
<li>获取外语视频的中文字幕</li>
</ul>
<hr>
<h2 id="二内置-skills19个">二、内置 Skills（19个）</h2>
<h3 id="13-discord--discord-操作">13. discord — Discord 操作</h3>
<p><strong>功能</strong>：通过 Discord API 发送消息、管理频道、创建线程等。</p>
<p><strong>原理</strong>：封装 Discord Bot API，支持消息收发、频道管理、表情反应等操作。</p>
<p><strong>使用场景</strong>：</p>
<ul>
<li>在 Discord 频道自动发消息</li>
<li>管理服务器和频道</li>
<li>监控 Discord 消息</li>
</ul>
<hr>
<h3 id="14-gh-issues--github-issue-自动处理">14. gh-issues — GitHub Issue 自动处理</h3>
<p><strong>功能</strong>：自动处理 GitHub Issues——获取、分析、创建 PR 修复、监控 Review 评论。</p>
<p><strong>原理</strong>：结合 <code>gh</code> CLI 和 AI 分析能力，自动读取 Issue、生成修复代码、提交 PR。</p>
<p><strong>使用方式</strong>：</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-text" data-lang="text"><span style="display:flex;"><span>/gh-issues owner/repo --label bug --limit 5
</span></span></code></pre></div><p><strong>使用场景</strong>：</p>
<ul>
<li>自动修复标记为 bug 的 Issue</li>
<li>批量处理社区贡献</li>
<li>定时检查新 Issue</li>
</ul>
<hr>
<h3 id="15-github--github-操作">15. github — GitHub 操作</h3>
<p><strong>功能</strong>：全面的 GitHub 操作能力，包括 Issues、PR、CI、代码审查等。</p>
<p><strong>原理</strong>：封装 <code>gh</code> CLI 工具，提供结构化的 GitHub 操作接口。</p>
<p><strong>使用场景</strong>：</p>
<ul>
<li>查看 PR 状态和 CI 运行结果</li>
<li>创建和管理 Issue</li>
<li>代码审查和评论</li>
</ul>
<hr>
<h3 id="16-healthcheck--主机安全检查">16. healthcheck — 主机安全检查</h3>
<p><strong>功能</strong>：检查服务器的安全配置、系统更新状态、防火墙规则等。</p>
<p><strong>原理</strong>：执行一系列安全检查命令（ufw 状态、SSH 配置、系统更新等），生成安全报告。</p>
<p><strong>使用场景</strong>：</p>
<ul>
<li>定期安全审计</li>
<li>新服务器安全加固</li>
<li>检查暴露风险</li>
</ul>
<hr>
<h3 id="17-nano-pdf--pdf-编辑">17. nano-pdf — PDF 编辑</h3>
<p><strong>功能</strong>：使用自然语言指令编辑 PDF 文件——合并、拆分、旋转、加水印等。</p>
<p><strong>原理</strong>：通过 <code>nano-pdf</code> CLI 工具，将自然语言指令转换为 PDF 操作命令。</p>
<p><strong>使用场景</strong>：</p>
<ul>
<li>合并多个 PDF 文件</li>
<li>提取 PDF 特定页面</li>
<li>添加水印或页码</li>
</ul>
<hr>
<h3 id="18-node-connect--设备连接诊断">18. node-connect — 设备连接诊断</h3>
<p><strong>功能</strong>：诊断 OpenClaw Node（手机/电脑客户端）的连接和配对问题。</p>
<p><strong>原理</strong>：检查网络配置、Tailscale 连接、Gateway 绑定等，定位连接失败原因。</p>
<p><strong>使用场景</strong>：</p>
<ul>
<li>手机 App 无法连接服务器</li>
<li>Tailscale 组网问题</li>
<li>QR 码配对失败</li>
</ul>
<hr>
<h3 id="19-skill-creator--skill-创建工具">19. skill-creator — Skill 创建工具</h3>
<p><strong>功能</strong>：帮助创建、编辑、审计和优化 Skill。</p>
<p><strong>原理</strong>：提供 Skill 开发的最佳实践模板和规范检查，确保新 Skill 符合 OpenClaw 规范。</p>
<p><strong>使用场景</strong>：</p>
<ul>
<li>从零创建新 Skill</li>
<li>优化现有 Skill</li>
<li>审计 Skill 安全性</li>
</ul>
<hr>
<h3 id="20-tmux--终端会话管理">20. tmux — 终端会话管理</h3>
<p><strong>功能</strong>：远程控制 tmux 会话，发送按键和读取面板输出。</p>
<p><strong>原理</strong>：通过 tmux 的控制模式，实现对交互式 CLI 工具的自动化操作。</p>
<p><strong>使用场景</strong>：</p>
<ul>
<li>自动化交互式 CLI 操作</li>
<li>在后台运行长时间命令</li>
<li>管理多个终端会话</li>
</ul>
<hr>
<h3 id="21-video-frames--视频抽帧">21. video-frames — 视频抽帧</h3>
<p><strong>功能</strong>：从视频中提取帧图片或短视频片段。</p>
<p><strong>原理</strong>：使用 ffmpeg 进行视频处理，支持按时间、按帧率、按场景变化提取。</p>
<p><strong>使用场景</strong>：</p>
<ul>
<li>视频内容分析</li>
<li>提取关键帧制作缩略图</li>
<li>视频片段裁剪</li>
</ul>
<hr>
<h3 id="22-weather--天气查询">22. weather — 天气查询</h3>
<p><strong>功能</strong>：查询全球各地的天气和预报。</p>
<p><strong>原理</strong>：通过 <code>wttr.in</code> 或 <code>Open-Meteo</code> API 获取天气数据，无需 API Key。</p>
<p><strong>使用场景</strong>：</p>
<ul>
<li>查看当前天气</li>
<li>获取未来几天预报</li>
<li>计划出行</li>
</ul>
<hr>
<h3 id="23-xurl--x-twitter-api-工具">23. xurl — X (Twitter) API 工具</h3>
<p><strong>功能</strong>：全面的 X (Twitter) 操作——发推、回复、搜索、管理粉丝、发送 DM、上传媒体等。</p>
<p><strong>原理</strong>：封装 X API v2 的所有端点，通过 CLI 命令调用。</p>
<p><strong>使用场景</strong>：</p>
<ul>
<li>自动发推和互动</li>
<li>搜索热门话题</li>
<li>管理 Twitter 账号</li>
</ul>
<hr>
<h3 id="24-31-飞书系列-skills">24-31. 飞书系列 Skills</h3>
<p>OpenClaw 内置了完整的飞书集成，提供 8 个飞书相关 Skill：</p>
<h4 id="feishu-bitable--多维表格">feishu-bitable — 多维表格</h4>
<p>管理飞书多维表格：创建、查询、编辑记录，管理字段、视图、数据表。</p>
<p><strong>使用场景</strong>：</p>
<ul>
<li>自动填写多维表格</li>
<li>批量导入数据</li>
<li>创建自动化报表</li>
</ul>
<h4 id="feishu-calendar--日历与日程">feishu-calendar — 日历与日程</h4>
<p>管理飞书日历：创建日程、查询忙闲、管理参会人。</p>
<h4 id="feishu-channel-rules--飞书频道规则">feishu-channel-rules — 飞书频道规则</h4>
<p>控制飞书消息的输出格式和行为，确保消息在飞书环境正确显示。</p>
<h4 id="feishu-create-doc--创建云文档">feishu-create-doc — 创建云文档</h4>
<p>从 Markdown 内容创建飞书云文档，支持指定位置。</p>
<h4 id="feishu-fetch-doc--获取云文档">feishu-fetch-doc — 获取云文档</h4>
<p>读取飞书云文档内容，转为 Markdown 格式。</p>
<h4 id="feishu-im-read--im-消息读取">feishu-im-read — IM 消息读取</h4>
<p>获取群聊/单聊历史消息、话题回复、跨会话搜索、下载图片文件。</p>
<h4 id="feishu-task--任务管理">feishu-task — 任务管理</h4>
<p>创建、查询、更新任务和清单。</p>
<h4 id="feishu-troubleshoot--问题排查">feishu-troubleshoot — 问题排查</h4>
<p>飞书插件故障诊断，包含常见问题 FAQ 和深度诊断命令。</p>
<h4 id="feishu-update-doc--更新云文档">feishu-update-doc — 更新云文档</h4>
<p>支持追加、覆盖、定位替换等多种更新模式。</p>
<hr>
<h2 id="三如何管理-skills">三、如何管理 Skills</h2>
<h3 id="查看已安装-skills">查看已安装 Skills</h3>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-text" data-lang="text"><span style="display:flex;"><span>openclaw skills check
</span></span></code></pre></div><h3 id="从-clawhub-安装">从 ClawHub 安装</h3>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span><span style="color:#6272a4"># 通用方式</span>
</span></span><span style="display:flex;"><span>curl -L -o /tmp/skill.zip <span style="color:#f1fa8c">&#34;https://wry-manatee-359.convex.site/api/v1/download?slug=技能名&#34;</span>
</span></span><span style="display:flex;"><span>unzip -o /tmp/skill.zip -d ~/.openclaw/skills/技能名/
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#6272a4"># 如果有 npm 依赖</span>
</span></span><span style="display:flex;"><span><span style="color:#8be9fd;font-style:italic">cd</span> ~/.openclaw/skills/技能名 <span style="color:#ff79c6">&amp;&amp;</span> npm install
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#6272a4"># 如果有 Python 依赖</span>
</span></span><span style="display:flex;"><span>pip3 install 依赖包名
</span></span></code></pre></div><h3 id="卸载-skill">卸载 Skill</h3>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-text" data-lang="text"><span style="display:flex;"><span>rm -rf ~/.openclaw/skills/技能名
</span></span><span style="display:flex;"><span>openclaw gateway restart
</span></span></code></pre></div><h3 id="创建自定义-skill">创建自定义 Skill</h3>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-text" data-lang="text"><span style="display:flex;"><span>mkdir -p ~/.openclaw/skills/my-skill/{scripts,references}
</span></span></code></pre></div><p>然后编写 <code>SKILL.md</code> 文件，定义技能的功能和使用说明。</p>
<hr>
<h2 id="四最佳实践">四、最佳实践</h2>
<ol>
<li><strong>按需安装</strong>：只安装你实际会用到的 Skill，减少不必要的依赖</li>
<li><strong>定期更新</strong>：定期从 ClawHub 检查 Skill 更新</li>
<li><strong>注意权限</strong>：安装前审查 Skill 的权限需求</li>
<li><strong>配置安全</strong>：API Key 等敏感信息使用环境变量，不要硬编码</li>
<li><strong>利用内置</strong>：优先使用内置 Skill，它们经过更好的测试</li>
</ol>
<hr>
<h2 id="总结">总结</h2>
<p>OpenClaw 的 Skill 系统让 AI Agent 的能力可以无限扩展。从邮件管理到浏览器自动化，从股票分析到飞书办公，31 个 Skill 覆盖了日常开发和生活的方方面面。</p>
<p>最重要的是，Skill 的设计理念是「自然语言驱动」——你不需要记住任何命令，只需要用自然语言描述你的需求，Agent 会自动选择合适的 Skill 来完成任务。</p>
<hr>
<p><em>相关链接：</em></p>
<ul>
<li><em><a href="https://clawhub.ai">ClawHub 技能市场</a></em></li>
<li><em><a href="https://github.com/openclaw/openclaw">OpenClaw GitHub</a></em></li>
<li><em><a href="https://docs.openclaw.ai">OpenClaw 文档</a></em></li>
<li><em><a href="https://discord.com/invite/clawd">OpenClaw Discord 社区</a></em></li>
</ul>
]]></content:encoded></item><item><title>Ubuntu 服务器部署 OpenClaw 完整指南</title><link>https://blog.heyaohua.com/posts/2026/03/ubuntu-openclaw-deploy-guide/</link><pubDate>Sat, 21 Mar 2026 21:46:00 +0800</pubDate><guid>https://blog.heyaohua.com/posts/2026/03/ubuntu-openclaw-deploy-guide/</guid><description>手把手教你在 Ubuntu 服务器上部署 OpenClaw，从安装配置到连接飞书、安装 ClawHub 技能插件的全流程。</description><content:encoded><![CDATA[<h2 id="前言">前言</h2>
<p><a href="https://github.com/openclaw/openclaw">OpenClaw</a> 是一个开源的 AI Agent 平台，可以连接各种 LLM（大语言模型）并提供丰富的技能生态系统。部署在 Ubuntu 服务器上后，你可以通过飞书、Discord、WhatsApp 等渠道与 AI 助手对话，还能安装 ClawHub 上的各种技能插件，让它帮你管理邮件、查询股票、操作浏览器等等。</p>
<p>本文记录了我在 Ubuntu 服务器上部署 OpenClaw 的完整过程，希望对你有帮助。</p>
<h2 id="环境准备">环境准备</h2>
<h3 id="服务器要求">服务器要求</h3>
<ul>
<li><strong>操作系统</strong>：Ubuntu 22.04+（推荐 24.04 LTS）</li>
<li><strong>内存</strong>：至少 1GB，推荐 2GB+</li>
<li><strong>存储</strong>：10GB+</li>
<li><strong>网络</strong>：能访问 GitHub 和飞书 API</li>
</ul>
<h3 id="基础依赖">基础依赖</h3>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span><span style="color:#6272a4"># 更新系统</span>
</span></span><span style="display:flex;"><span>sudo apt update <span style="color:#ff79c6">&amp;&amp;</span> sudo apt upgrade -y
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#6272a4"># 安装必要工具</span>
</span></span><span style="display:flex;"><span>sudo apt install -y git curl build-essential
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#6272a4"># 安装 Node.js（OpenClaw 需要 Node 22+）</span>
</span></span><span style="display:flex;"><span>curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
</span></span><span style="display:flex;"><span>sudo apt install -y nodejs
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#6272a4"># 验证</span>
</span></span><span style="display:flex;"><span>node -v  <span style="color:#6272a4"># v22.x+</span>
</span></span><span style="display:flex;"><span>npm -v
</span></span></code></pre></div><h2 id="安装-openclaw">安装 OpenClaw</h2>
<p>OpenClaw 提供了一键安装脚本，非常方便：</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>curl -fsSL --proto <span style="color:#f1fa8c">&#39;=https&#39;</span> --tlsv1.2 https://openclaw.ai/install.sh | bash
</span></span></code></pre></div><p>安装完成后验证：</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-text" data-lang="text"><span style="display:flex;"><span>openclaw --version
</span></span><span style="display:flex;"><span># OpenClaw 2026.x.x
</span></span></code></pre></div><blockquote>
<p><strong>提示</strong>：如果安装脚本因为网络问题失败，也可以通过 npm 手动安装：
<code>bash npm install -g openclaw</code></p>
</blockquote>
<h2 id="配置-gateway">配置 Gateway</h2>
<p>OpenClaw 的核心是 Gateway 服务，负责管理会话、连接渠道和技能。</p>
<h3 id="初始化配置">初始化配置</h3>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-text" data-lang="text"><span style="display:flex;"><span># 启动 Gateway（首次会引导你配置）
</span></span><span style="display:flex;"><span>openclaw gateway start
</span></span></code></pre></div><h3 id="配置-llm-提供商">配置 LLM 提供商</h3>
<p>OpenClaw 支持多种 LLM 提供商。以智谱（GLM）为例：</p>
<p>编辑配置文件（通常在 <code>~/.openclaw/agents/main/agent/</code> 目录下），添加模型配置：</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-text" data-lang="text"><span style="display:flex;"><span># 查看当前配置
</span></span><span style="display:flex;"><span>openclaw status
</span></span></code></pre></div><p>OpenClaw 会通过 Web 界面或 CLI 引导你配置 API Key。</p>
<h3 id="常用-gateway-命令">常用 Gateway 命令</h3>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-text" data-lang="text"><span style="display:flex;"><span>openclaw gateway start    # 启动
</span></span><span style="display:flex;"><span>openclaw gateway stop     # 停止
</span></span><span style="display:flex;"><span>openclaw gateway restart  # 重启
</span></span><span style="display:flex;"><span>openclaw gateway status   # 状态检查
</span></span></code></pre></div><h2 id="连接飞书">连接飞书</h2>
<p>飞书是国内最常用的协作平台，OpenClaw 提供了飞书插件，支持消息收发、日历管理、多维表格操作等。</p>
<h3 id="安装飞书插件">安装飞书插件</h3>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span><span style="color:#6272a4"># 克隆飞书扩展</span>
</span></span><span style="display:flex;"><span>git clone https://github.com/openclaw-lark/openclaw-lark.git ~/.openclaw/extensions/openclaw-lark
</span></span><span style="display:flex;"><span><span style="color:#8be9fd;font-style:italic">cd</span> ~/.openclaw/extensions/openclaw-lark
</span></span><span style="display:flex;"><span>npm install
</span></span></code></pre></div><h3 id="配置飞书应用">配置飞书应用</h3>
<ol>
<li>在 <a href="https://open.feishu.cn/">飞书开放平台</a> 创建一个应用</li>
<li>获取 App ID 和 App Secret</li>
<li>配置事件订阅（消息接收地址）</li>
<li>配置权限（消息发送、日历、多维表格等）</li>
</ol>
<h3 id="验证连接">验证连接</h3>
<p>配置完成后，在飞书里给应用发消息测试。如果能正常回复，说明连接成功。</p>
<h2 id="安装-clawhub-技能插件">安装 ClawHub 技能插件</h2>
<p>ClawHub 是 OpenClaw 的技能市场（<a href="https://clawhub.ai">clawhub.ai</a>），有大量社区贡献的技能。</p>
<h3 id="安装方式">安装方式</h3>
<p>大多数技能可以通过下载 zip 直接安装：</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span><span style="color:#6272a4"># 通用安装方式</span>
</span></span><span style="display:flex;"><span>curl -L -o /tmp/skill.zip <span style="color:#f1fa8c">&#34;https://wry-manatee-359.convex.site/api/v1/download?slug=技能名&#34;</span>
</span></span><span style="display:flex;"><span>unzip -o /tmp/skill.zip -d ~/.openclaw/skills/技能名/
</span></span><span style="display:flex;"><span><span style="color:#8be9fd;font-style:italic">cd</span> ~/.openclaw/skills/技能名 <span style="color:#ff79c6">&amp;&amp;</span> npm install  <span style="color:#6272a4"># 如果需要</span>
</span></span></code></pre></div><h3 id="推荐技能">推荐技能</h3>
<p>以下是我在实际使用中安装的技能，按用途分类：</p>
<h4 id="-邮件管理">📧 邮件管理</h4>
<p><strong>imap-smtp-email</strong> — 通过 IMAP/SMTP 收发邮件</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span><span style="color:#6272a4"># 安装</span>
</span></span><span style="display:flex;"><span>curl -L -o /tmp/imap-smtp-email.zip <span style="color:#f1fa8c">&#34;https://wry-manatee-359.convex.site/api/v1/download?slug=imap-smtp-email&#34;</span>
</span></span><span style="display:flex;"><span>unzip -o /tmp/imap-smtp-email.zip -d ~/.openclaw/skills/imap-smtp-email
</span></span><span style="display:flex;"><span><span style="color:#8be9fd;font-style:italic">cd</span> ~/.openclaw/skills/imap-smtp-email <span style="color:#ff79c6">&amp;&amp;</span> npm install
</span></span></code></pre></div><p>配置邮箱账号（创建 <code>~/.config/imap-smtp-email/.env</code>）：</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-text" data-lang="text"><span style="display:flex;"><span>IMAP_HOST=imap.163.com
</span></span><span style="display:flex;"><span>IMAP_PORT=993
</span></span><span style="display:flex;"><span>IMAP_USER=your@email.com
</span></span><span style="display:flex;"><span>IMAP_PASS=your_password
</span></span><span style="display:flex;"><span>IMAP_TLS=true
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span>SMTP_HOST=smtp.163.com
</span></span><span style="display:flex;"><span>SMTP_PORT=465
</span></span><span style="display:flex;"><span>SMTP_USER=your@email.com
</span></span><span style="display:flex;"><span>SMTP_PASS=your_password
</span></span><span style="display:flex;"><span>SMTP_TLS=true
</span></span></code></pre></div><p>支持多账号配置，比如同时配置 163 邮箱和 QQ 邮箱。</p>
<h4 id="-预测市场">📊 预测市场</h4>
<p><strong>polymarket-trade</strong> — 查询 Polymarket 预测市场数据</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-text" data-lang="text"><span style="display:flex;"><span>pip3 install requests
</span></span><span style="display:flex;"><span># 下载安装（同上方式）
</span></span></code></pre></div><p>无需 API Key，直接查询热门市场和价格趋势。</p>
<h4 id="-股票分析">📈 股票分析</h4>
<p><strong>stock-analysis</strong> — 股票数据查询和分析</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-text" data-lang="text"><span style="display:flex;"><span>pip3 install yfinance
</span></span><span style="display:flex;"><span># 下载安装
</span></span></code></pre></div><h4 id="-视频工具">🎬 视频工具</h4>
<p><strong>youtube-watcher</strong> — 获取 YouTube 视频字幕/转录</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-text" data-lang="text"><span style="display:flex;"><span>pip3 install youtube-transcript-api
</span></span></code></pre></div><p><strong>video-frames</strong> — 视频抽帧（内置技能，无需安装）</p>
<h4 id="-内容工具">📝 内容工具</h4>
<p><strong>summarize</strong> — 总结 URL、PDF、YouTube 内容</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>npm install -g @steipete/summarize
</span></span><span style="display:flex;"><span><span style="color:#6272a4"># 配置 API Key（支持智谱）</span>
</span></span><span style="display:flex;"><span><span style="color:#8be9fd;font-style:italic">export</span> <span style="color:#8be9fd;font-style:italic">Z_AI_API_KEY</span><span style="color:#ff79c6">=</span><span style="color:#f1fa8c">&#34;your_key&#34;</span>
</span></span></code></pre></div><p><strong>nano-pdf</strong> — 编辑 PDF 文件</p>
<h4 id="-浏览器自动化">🌐 浏览器自动化</h4>
<p><strong>browser-use</strong> — AI 驱动的浏览器操作</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>uv tool install browser-use
</span></span></code></pre></div><p><strong>agent-browser</strong> — Stagehand 浏览器自动化</p>
<h4 id="-自我进化">🤖 自我进化</h4>
<p><strong>self-improving-agent</strong> — AI Agent 自我学习能力</p>
<p><strong>evolver</strong> — 运行时历史分析，识别改进点</p>
<h3 id="验证已安装技能">验证已安装技能</h3>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-text" data-lang="text"><span style="display:flex;"><span>openclaw skills check
</span></span></code></pre></div><h2 id="安装-claude-code开发辅助">安装 Claude Code（开发辅助）</h2>
<p>如果你的服务器安装了 <a href="https://docs.anthropic.com/en/docs/claude-code">Claude Code</a>，OpenClaw 可以调用它来完成复杂的开发任务。</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span><span style="color:#6272a4"># 安装 Claude Code</span>
</span></span><span style="display:flex;"><span>npm install -g @anthropic-ai/claude-code
</span></span><span style="display:flex;"><span>
</span></span><span style="display:flex;"><span><span style="color:#6272a4"># 验证</span>
</span></span><span style="display:flex;"><span>claude --version
</span></span></code></pre></div><p>使用时可以通过 <code>--dangerously-skip-permissions</code> 参数跳过权限确认：</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-text" data-lang="text"><span style="display:flex;"><span>claude --dangerously-skip-permissions -p &#34;你的指令&#34;
</span></span></code></pre></div><p>这样 OpenClaw 调用 Claude Code 时就不会卡在权限确认上了。</p>
<h2 id="性能优化">性能优化</h2>
<p>如果你的服务器配置较低（1GB 内存或 ARM 设备），可以进行以下优化：</p>
<h3 id="nodejs-编译缓存">Node.js 编译缓存</h3>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-text" data-lang="text"><span style="display:flex;"><span>echo &#39;export NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache&#39; &gt;&gt; ~/.bashrc
</span></span><span style="display:flex;"><span>echo &#39;mkdir -p /var/tmp/openclaw-compile-cache&#39; &gt;&gt; ~/.bashrc
</span></span><span style="display:flex;"><span>source ~/.bashrc
</span></span></code></pre></div><h3 id="systemd-服务优化">systemd 服务优化</h3>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>sudo systemctl edit openclaw
</span></span></code></pre></div><p>添加以下配置：</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-json" data-lang="json"><span style="display:flex;"><span>[Service]
</span></span><span style="display:flex;"><span>Environment=OPENCLAW_NO_RESPAWN=<span style="color:#bd93f9">1</span>
</span></span><span style="display:flex;"><span>Environment=NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
</span></span><span style="display:flex;"><span>Restart=always
</span></span><span style="display:flex;"><span>RestartSec=<span style="color:#bd93f9">2</span>
</span></span><span style="display:flex;"><span>TimeoutStartSec=<span style="color:#bd93f9">90</span>
</span></span></code></pre></div><h2 id="常见问题">常见问题</h2>
<h3 id="q-安装时报-github-限流">Q: 安装时报 GitHub 限流？</h3>
<p>A: 配置 GitHub Token：</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-text" data-lang="text"><span style="display:flex;"><span>gh auth login
</span></span></code></pre></div><p>或者设置环境变量：</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span><span style="color:#8be9fd;font-style:italic">export</span> <span style="color:#8be9fd;font-style:italic">GITHUB_TOKEN</span><span style="color:#ff79c6">=</span><span style="color:#f1fa8c">&#34;your_token&#34;</span>
</span></span></code></pre></div><h3 id="q-浏览器技能报-socksio-错误">Q: 浏览器技能报 socksio 错误？</h3>
<p>A: 这是因为服务器配置了 socks5 代理。可以在 skill 的启动脚本中清除 <code>all_proxy</code> 环境变量，或者将代理改为 http 协议。</p>
<h3 id="q-mysql-80-连接报-2002-错误">Q: MySQL 8.0 连接报 2002 错误？</h3>
<p>A: 通常是 MySQL 8.0 默认使用 <code>caching_sha2_password</code> 认证，旧客户端不兼容。可以改为 <code>mysql_native_password</code>：</p>
<div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#282a36;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-sql" data-lang="sql"><span style="display:flex;"><span><span style="color:#ff79c6">ALTER</span> <span style="color:#ff79c6">USER</span> <span style="color:#f1fa8c">&#39;root&#39;</span><span style="color:#ff79c6">@</span><span style="color:#f1fa8c">&#39;%&#39;</span> IDENTIFIED <span style="color:#ff79c6">WITH</span> mysql_native_password <span style="color:#ff79c6">BY</span> <span style="color:#f1fa8c">&#39;your_password&#39;</span>;
</span></span><span style="display:flex;"><span>FLUSH <span style="color:#ff79c6">PRIVILEGES</span>;
</span></span></code></pre></div><h3 id="q-python-314-兼容性问题">Q: Python 3.14 兼容性问题？</h3>
<p>A: 一些 Python 脚本中 argparse 的 help 字符串包含 <code>%</code>，在 Python 3.14+ 中会报错。需要将 <code>%</code> 转义为 <code>%%</code>。</p>
<h2 id="总结">总结</h2>
<p>OpenClaw 部署到 Ubuntu 服务器后，配合 ClawHub 的技能生态，可以打造一个功能强大的 AI 助手。核心步骤：</p>
<ol>
<li><strong>安装 OpenClaw</strong> — 一键脚本</li>
<li><strong>配置 LLM</strong> — 选择你喜欢的模型提供商</li>
<li><strong>连接渠道</strong> — 飞书、Discord、WhatsApp 等</li>
<li><strong>安装技能</strong> — 从 ClawHub 按需安装</li>
<li><strong>性能优化</strong> — 针对低配服务器调整</li>
</ol>
<p>如果你也在搭建自己的 AI 助手，欢迎交流！</p>
<hr>
<p><em>相关链接：</em></p>
<ul>
<li><em><a href="https://github.com/openclaw/openclaw">OpenClaw GitHub</a></em></li>
<li><em><a href="https://clawhub.ai">ClawHub 技能市场</a></em></li>
<li><em><a href="https://docs.openclaw.ai">OpenClaw 文档</a></em></li>
<li><em><a href="https://discord.com/invite/clawd">OpenClaw Discord 社区</a></em></li>
</ul>
]]></content:encoded></item></channel></rss>