环境初始化
首先克隆项目仓库并进入目录，确保 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 能显著提升长期对话体验。
