OpenClaw怎么用?安装、中文设置、Skills配置完整教程

OpenClaw的文档分散、社区讨论大多是英文,中文新手入门容易卡在各种奇怪的地方。这篇教程从零开始,把安装、中文设置、Skills配置讲清楚,尽量做到跟着走就能用起来。


一、环境准备

在安装OpenClaw之前,需要确保你的电脑有以下环境:

Python 3.10及以上版本
打开终端(Windows用CMD或PowerShell),运行:

python --version

如果显示 Python 3.10.x 或更高版本,说明已经满足要求。如果没有Python,去 python.org 下载安装包,安装时记得勾选「Add Python to PATH」。

Git
运行 git --version 检查。没有的话去 git-scm.com 下载安装。

Node.js(部分Skills需要)
运行 node --version,建议安装18.x以上版本。


二、安装OpenClaw

方法一:通过pip安装(推荐新手)

pip install openclaw

安装完成后,验证一下:

openclaw --version

能看到版本号说明安装成功。

方法二:从GitHub源码安装

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pip install -e .

源码安装适合想跟进最新功能、或者想自己修改代码的用户。

常见安装报错

报错:pip: command not found
说明Python没有正确添加到PATH,重新安装Python时注意勾选PATH选项。

报错:error: Microsoft Visual C++ 14.0 is required(Windows)
需要安装Visual C++ Build Tools,去微软官网搜索下载即可。

报错:SSL证书错误
可以临时用 pip install openclaw --trusted-host pypi.org --trusted-host files.pythonhosted.org 绕过,但建议检查系统网络设置。


三、配置模型后端

OpenClaw本身不带AI模型,需要你配置一个后端。最常用的是OpenAI和Claude。

配置OpenAI

在终端运行:

openclaw config set model openai
openclaw config set openai_api_key sk-你的APIKey

或者直接编辑配置文件,位置在 ~/.openclaw/config.yaml

model:
  provider: openai
  model_name: gpt-4o
  api_key: sk-你的APIKey

配置Claude(Anthropic)

model:
  provider: anthropic
  model_name: claude-opus-4-5
  api_key: sk-ant-你的APIKey

建议在 Anthropic Console 生成专用的API Key,不要把主账号的Key到处用。


四、中文界面设置

OpenClaw默认是英文界面,切换中文需要两步。

第一步:设置语言

打开配置文件 ~/.openclaw/config.yaml,添加或修改:

locale: zh_CN

保存后重启OpenClaw。

第二步:安装中文语言包

如果界面还有部分没有翻译,运行:

openclaw lang install zh_CN

社区维护的中文翻译不是100%完整,部分技术术语仍然是英文,这是正常现象。

中文输入法问题

在某些系统上,OpenClaw的文字输入框和输入法有冲突,尤其是Windows上。如果遇到中文无法输入的问题,可以尝试:

  1. 先在记事本输入好中文,复制粘贴到OpenClaw
  2. 或者在 config.yaml 中设置 input_method_compat: true

五、Skills配置

Skills是OpenClaw的插件系统,每个Skill针对特定软件或场景提供增强能力。

查看可用Skills

openclaw skills list

这会列出官方仓库里的所有可用Skills,包括名称、版本、描述。

安装Skill

以「浏览器控制」Skill为例:

openclaw skills install browser-control

安装完成后会提示是否需要额外配置(比如填写API Key或者路径)。

常用Skills推荐

browser-control:控制Chrome/Edge浏览器,访问网页、提取信息、填写表单。新手必装。

file-manager:文件批量操作,重命名、移动、整理目录结构。

office-suite:操控Word、Excel、PowerPoint,适合办公自动化。需要本地安装Office或WPS。

email-helper:支持Outlook和常见邮件客户端,自动发邮件、整理收件箱。

clipboard-manager:增强剪贴板功能,在多步骤任务中传递数据。

Skill配置示例

每个Skill有自己的配置文件,在 ~/.openclaw/skills/[skill名]/config.yaml

以 browser-control 为例:

browser: chrome
chrome_path: /usr/bin/google-chrome
headless: false  # true表示后台运行不显示浏览器窗口
screenshot_interval: 1.5  # 截图频率(秒),值越小越快但越耗资源

六、第一个任务:搜索并整理信息

环境配置好后,试一个简单任务感受一下:

打开终端,启动OpenClaw:

openclaw run

在提示符后输入任务描述(支持中文):

打开浏览器,搜索「2025年AI Agent趋势」,把前5个结果的标题和链接整理成一个表格,保存到桌面的result.txt

OpenClaw会开始执行,你可以在屏幕上看到它的操作过程。第一次跑可能会慢,因为它需要截图、分析、操作,每一步都要调用模型。


七、进阶使用建议

写清楚任务描述:OpenClaw对任务描述的质量很敏感。「帮我查一下」不如「打开Chrome,访问xxx网站,找到最新的价格信息,截图保存到桌面」。

用任务文件而不是手打:复杂任务建议写成 .yaml 任务文件,这样可以复用和分享:

task:
  name: 每日价格监控
  steps:
    - open_browser: https://example.com/price
    - extract: "商品价格"
    - save_to: ~/price_log.txt

控制截图频率:如果任务运行慢,适当提高 screenshot_interval(比如从1秒改到2秒),能减少模型调用次数,节省费用。

关注token消耗:Computer Use类任务每一步都要截图+分析,token消耗比普通对话高很多。建议先在小任务上测试,估算一下费用再跑批量任务。


总结

OpenClaw的核心价值在于灵活性和可定制性,但这也意味着上手有一定门槛。按照这篇教程走完一遍之后,你应该能跑起来一个基本可用的环境。

后续深入的方向:自定义Skill开发、多步骤任务编排、接入本地模型(降低API成本)。

有任何安装或配置上的具体问题,欢迎在评论里描述你的报错信息,尽量帮你解决 :point_down:

2 个赞

Windows上安装Visual C++ Build Tools这一步坑了我好久,文章提到了,但没说具体去哪下载。补充一下:搜「Microsoft C++ Build Tools」直接到微软官网下,选「桌面开发」那个工作负载就行,大概6GB左右。

2 个赞

中文输入法冲突这个问题我之前遇到过,input_method_compat: true 这个配置项没生效,最后还是靠复制粘贴解决的。不知道是不是我版本的问题。

2 个赞

教程写得很清楚,跟着做基本没卡。有一个地方要提醒:config.yaml 的缩进必须用空格,不能用Tab,我第一次用Tab缩进结果配置完全不生效,折腾了一个多小时才发现是这个问题。YAML格式对缩进很敏感,这个坑新手很容易踩。

3 个赞

请问Skills的安装有没有离线方式?我公司内网环境,openclaw skills install 命令直接超时。

2 个赞

关于token消耗这块,我跑了几个任务估算了一下。一个简单的「打开浏览器,搜索,截图,提取文字」任务,大概消耗1500-3000个token,按GPT-4o的价格大概是0.01-0.02美元一次。复杂任务(多步骤、页面元素多)可能要10000+token。批量跑的话费用会比较可观,建议先算清楚再上规模。

有个省钱技巧:把 screenshot_interval 调高(比如3秒),减少截图频率,可以降低30-40%的token消耗,但任务执行会更慢。鱼和熊掌不可兼得。

我用MoliliClaw(茉莉粒)入的坑,后来觉得不够用,按这篇教程迁移到OpenClaw。整体感受是:功能确实更强,但配置文件有点繁琐。不过照着教程走基本都能解决。现在browser-control和office-suite两个Skills每天都在用,提效很明显。

1 个赞

写任务描述的建议这块说得太对了。我一开始总是写「帮我整理一下这个网站的数据」,OpenClaw不知道从哪开始,要么乱跑,要么直接报错。后来改成「打开Chrome,访问https://xxx.com,找到表格区域,把所有行的第一列和第三列内容复制到剪贴板」这种格式,成功率大幅提升。

有个小技巧:描述任务时尽量说「做什么」而不是「怎么做」,但当某个步骤有特定要求时(比如必须用特定浏览器、必须保存到特定路径)要明确写出来。模型理解具体指令比抽象指令稳定得多。

2 个赞