OpenClaw 是什么？
OpenClaw 是一个开源的、终端优先的个人 AI 助手框架，支持多模型接入（Claude、GPT 等）、技能扩展（联网、文件操作、提醒、Notion、GitHub 等）、多渠道聊天（WhatsApp、飞书、Telegram 等）。它不像 Cursor 是 IDE 插件，而是更像一个“AI 秘书”，可以本地运行、完全自定义、国内模型友好。
一、安装 OpenClaw（Mac 推荐方式）
步骤 1：一键安装
- 安装过程会下载最新 CLI、安装到
- 可能会提示添加 PATH，已自动加到 ~/.zshrc（如果没有，手动加）：
步骤 2：验证安装
如果 command not found → 重新 source ~/.zshrc 或重开终端。
步骤 3：第一次启动（onboarding）
- 会进入 onboarding 向导（文字交互）
- Security warning → 选 Yes（个人使用默认安全）
- Onboarding mode → 选 QuickStart（最快）
- Gateway port → 默认 18789，回车
- Model/auth provider → 选 Volcano Engine（火山引擎）
- How do you want to provide this API key? → 选 Paste API key now
- Enter Volcano Engine API key → 粘贴你的火山 Ark key（fb… 开头的完整字符串）
- Default model → 手动输入：（或 code-preview 版）
- Select channel → 可以先 Skip for now（后面再加 WhatsApp/飞书）
- Configure skills now? → 选 Yes，逐个看提示（apple-reminders、apple-notes、github 建议开，其他看需求）
- Set XXX_API_KEY for YYY? → 除了你需要的（如 Notion），其他都选 No
- Enable hooks? → 全选（boot-md、session-memory 等）
- How do you want to hatch your bot? → 选 Hatch in TUI（推荐）
完成 onboarding 后会进入 TUI 界面，如果看到模型是 ，恭喜第一步成功！
二、优化配置（避免 unknown model / timeout）
很多人在 onboarding 后会遇到 Unknown model: volcengine/… 或 timeout，原因是对内建 volcengine provider 的残留。
步骤：手动修正配置
- 打开配置文件：
- 确保 models 部分是下面这样（替换你的完整 key）：
- 删除任何残留的 相关（auth.profiles、旧 models）。
- 保存后重启：
- 进 TUI 后输入：
再问“你好，用繁体中文回我”，如果正常回复 → 配置成功！
三、安装 skills（重点：用 npx clawhub install）
OpenClaw 的技能主要通过 ClawHub 安装，命令是 （不是 openclaw skills install）。
步骤示例：安装 Tavily 搜索技能
- 确保 npx 可用（Node.js 自带）：
- 安装 tavily-search：
- 会自动下载技能到
- 如果提示权限问题，加 sudo 或检查目录权限
- 配置 Tavily API Key（最稳用 export）：
（或写进 ~/.openclaw/.env）
- 重启：
- 测试：
其他常用技能安装命令（直接复制跑）：
- 学术论文搜索（OpenAlex，无需 key）：
- arXiv 专用：
- Hugging Face 数据集/模型搜索：
- 安装后都重启 gateway + tui 测试。
四、常见问题速查
- Unknown model: volcengine/… → 删 auth.profiles.volcengine:default + doctor –fix
- LLM request timed out → 换翻墙节点（香港/台湾）+ 检查 key
- 技能没载入 → ls ~/.openclaw/workspace/skills 确认文件夹存在
- TUI 界面乱码 → 终端字体换成 Nerd Font
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容，请联系我们，一经查实，本站将立刻删除。
如需转载请保留出处：https://51itzy.com/kjqy/232596.html