执行git clone https://github.com/openclaw/openclaw克隆项目,执行cd openclaw进入项目

执行node --version看看node的版本是否大于等于22(没有node.js需自行安装),再执行npm install -g pnpm安装作为包管理器,并执行pnpm install安装依赖


首次执行pnpm ui:build构建 Web UI(会先安装 ui/ 目录的依赖)

执行pnpm build构建主程序


执行pnpm openclaw onboard --install-daemon运行配置向导(安装守护进程),完成初始化


按键盘右箭头选择Yes,同样Yes

任选一个模型提供商都行,没有对应的提供商的密钥可以跳过,如果是本地模型选vLLM(需用vLLM框架启动模型,有性能优势,但原生vLLM仅完全支持Linux的cuda)、Custom Provider(**可以连接任何 OpenAI 或 Anthropic 兼容的端点,包括托管提供商和自托管端点)**和 LiteLLM (最通用,能通过中间层转换支持任意后端,既支持云端也支持本地模型,也包括Ollama、vLLM、LM Studio、llama.cpp 等本地后端)
Custom Provider最方便,适合日常使用,支持范围:
-
✅ Ollama(自动检测,无需配置)
-
✅ vLLM(
localhost:8000/v1) -
✅ LM Studio(
localhost:1234/v1) -
✅ llama.cpp(
localhost:8080/v1,需启动./llama-server) -
✅ 自封装 API:任何你自己用 Python + Transformers 封装的 OpenAI-compatible 服务
-
✅ LiteLLM 代理
-
✅ Text Generation WebUI
a)使用本地模型及报错处理
Endpoint ID随便填

如果提示alias被占用可以不填Model alias或可到用户目录的隐藏目录.openclaw的openclaw.json删除类似红色框的部分

卡了很久,疑似报错

新开终端,在openclaw项目文件夹位置输入pnpm openclaw logs --follow,可发现关键报错原因是上下文窗口太小(这是 OpenClaw 2026.2 版本的硬性要求:contextWindow 必须 ≥ 16000,但 onboard 向导默认只设 4096)

先输入/exit退出

到用户目录的隐藏目录.openclaw的openclaw.json对本地模型的contextWindow设置至少16000

输入pnpm openclaw gateway restart重启

终端执行pnpm openclaw tui,输入问题,成功回答

b)使用云端模型


没有账号的话进行注册,密码需要数字和英文大小写

验证激活

按需安装对接软件的插件,不需要这些就选skip跳过

c)连接飞书
如果需要飞书,可以下载插件


打开https://open.feishu.cn/app,登录后点击创建企业自建应用

简单填写你的应用名称和应用描述,点击创建

点击凭证与基础信息,复制你的APP ID和APP Secret

点击创建版本,简单填写应用版本号和更新说明,点击保存及确认发布



忘记复制的话,回到凭证与基础信息,把你的APP ID和APP Secret粘贴到openclaw

选择中国版飞书

按需选择群聊响应策略

| 选项 | 效果 | 适用场景 |
|---|---|---|
| Allowlist | 只在指定群聊响应 | 推荐,安全可控,避免机器人到处乱回 |
| Open | 所有群聊都响应(需@) | 团队小、群少,希望机器人随时待命 |
| Disabled | 完全不在群聊响应 | 仅私聊使用 |
如果担心机器人乱回答选 Allowlist,后续在配置文件中指定允许响应的群 ID,防止误触。

按需安装skills,需要的话选择安装方式,不需要就skip for now

Hooks 是可选的自动化触发器,建议先 Skip,后续按需开启

| Hook | 作用 | 适用场景 |
|---|---|---|
| boot-md | 启动时自动加载指定 Markdown 文件作为系统提示 | 每次启动都要加载固定指令集 |
| bootstrap-extra-files | 启动时预加载额外文件到上下文 | 需要预置知识库文件 |
| command-logger | 自动记录所有命令到日志 | 需要审计追踪操作历史 |
| session-memory | 切换会话时自动保存/恢复上下文 | 需要持久化记忆,重启后记得之前聊过什么 |
建议: 刚入门先 Skip for now,不影响核心功能。等熟悉后再根据实际需求开启,尤其是 session-memory 对长期对话体验提升明显。
Skip for now跳过多个步骤后

选择tui

选择tui

也可以打开http://127.0.0.1:18789/chat?session=main,更方便修改配置

后续直接启动可以选择pnpm openclaw dashboard --no-open
回到飞书,点击应用能力,再点击机器人中的"添加"按钮



点击创建版本

点击订阅方式的编辑按钮,选择长连接,然后点击添加事件

依次搜索四个事件并添加:1)用户进入与机器人的会话 2)解散群 3)机器人进群 4)接收消息

点击创建版本

简单填写你的应用版本号、更新说明和应用能力,点击发布

打开飞书,点击应用

打开测试,如果出现以下情况,到openclaw项目的终端执行pnpm openclaw pairing approve feishu 对应的配对码


激活完成后,继续测试飞书对话

在对话中切换模型

d)安装能发现skills的skills
执行npx skills add https://github.com/vercel-labs/skills --skill find-skills

选择openclaw

全局安装,采用符号链接,选择yes

继续yes

可以打开网站或命令行pnpm openclaw skills list验证find-skills是否安装



Mac启动前最好设置权限
执行调查任务,发现似乎没加载find-skills工具

让它自己分析找不到找不到的原因并自行加载find-skills


e)自动安装浏览器操作、数据可视化、高德地图的skills
切换模型


自动安装skills并执行playwright-skill打开浏览器

成功获取数据


创建访问链接成功

查看链接以及下载csv,看起来地图过于简化了

让它继续优化



打开下载文件和地图链接,看起来有所进步,但仍有不足,如果需要更准更美观的话建议换更智能的ai模型或或继续提要求或换工具

创作不易,禁止抄袭,转载请附上原文链接及标题