环境初始化
首先克隆项目仓库并进入目录，确保 Node.js 版本不低于 22。推荐使用 pnpm 作为包管理器，安装依赖后构建 Web UI 和主程序。
git clone https://github.com/openclaw/openclaw
cd openclaw
node --version
npm install -g pnpm
pnpm install
首次执行需构建 Web UI 及主程序，完成后运行配置向导安装守护进程：
pnpm ui:build
pnpm build
pnpm openclaw onboard --install-daemon
按提示选择 Yes 完成初始化。模型提供商可根据需求选择，若使用本地模型推荐 vLLM（Linux CUDA 环境）或 Custom Provider（兼容任意 OpenAI/Anthropic 端点）。Custom Provider 支持 Ollama、LM Studio、LiteLLM 等主流本地后端。
本地模型配置与问题排查
在配置向导中选择 Custom Provider，Endpoint ID 可随意填写。若遇到 alias 被占用提示，可跳过 Model alias 或在用户隐藏目录 .openclaw/openclaw.json 中删除冲突项。
常见问题处理：
如果遇到长时间卡顿，建议新开终端查看日志：
pnpm openclaw logs --follow
OpenClaw 2026.2 版本对本地模型有硬性要求，contextWindow 必须 ≥ 16000，而向导默认仅设 4096。解决方法如下：
- 输入
/exit退出当前会话。 - 编辑用户目录下
.openclaw/openclaw.json配置文件。 - 将对应模型的
contextWindow设置为至少 16000。 - 重启网关服务：
pnpm openclaw gateway restart。
重启后可通过 pnpm openclaw tui 测试对话是否正常。
云端模型与飞书集成
若使用云端模型，需在注册页面完成账号激活，密码需包含数字及大小写字母。插件安装环节按需选择，无需对接的组件可直接跳过。
连接飞书应用
- 创建应用：登录飞书开放平台，创建企业自建应用，填写名称与描述。
- 获取凭证：在"凭证与基础信息"页复制 APP ID 和 APP Secret。
- 发布版本：创建新版本并保存确认，随后将凭证粘贴至 OpenClaw 配置中，选择中国版飞书。
- 响应策略：建议优先选择 Allowlist（指定群聊响应），避免机器人误触其他群组。
| 选项 | 效果 | 适用场景 |
|---|---|---|
| Allowlist | 只在指定群聊响应 | 推荐，安全可控 |
| Open | 所有群聊都响应（需@） | 团队小、群少 |
| Disabled | 完全不在群聊响应 | 仅私聊使用 |
- Hook 设置：自动化触发器如 boot-md、session-memory 等建议初期 Skip，熟悉后再根据需求开启。特别是 session-memory 能显著提升长期对话体验。
订阅事件与配对
在飞书应用的能力配置中，点击"添加"按钮创建版本。订阅方式选择长连接，依次添加以下四个事件：
- 用户进入与机器人的会话
- 解散群
- 机器人进群
- 接收消息
发布版本后，打开飞书应用测试。若出现配对请求，需在 OpenClaw 终端执行命令批准：
pnpm openclaw pairing approve feishu <配对码>
激活成功后，即可在对话中切换模型进行测试。也可通过浏览器访问 http://127.0.0.1:18789/chat?session=main 修改配置。
技能扩展与自动化
安装 find-skills
为了增强机器人发现能力，可全局安装 find-skills 工具：
npx skills add https://github.com/vercel-labs/skills --skill find-skills
安装时选择符号链接模式并确认。验证是否安装成功可使用 pnpm openclaw skills list。
浏览器操作与数据可视化
切换模型后，尝试让机器人自动安装浏览器操作技能（playwright-skill）并执行任务。例如查询地图数据或生成可视化图表。
若发现工具未加载，可引导模型自行分析原因并重新加载配置。Mac 系统启动前建议检查权限设置。虽然生成的地图链接可能过于简化，但可通过迭代优化或更换更智能的模型来提升结果质量。
后续直接启动可选择 pnpm openclaw dashboard --no-open 以无弹窗模式运行。