English | 简体中文
- AICodeMirror 注册邀请链接： https://www.aicodemirror.com/register?invitecode=EZUWFL
| 对比项 | 官方文档 | 这份教程 |
|---|---|---|
| 系统覆盖 | 分散 | MacOS/Linux + Windows 一次讲清 |
| 初始化流程 | 描述较抽象 | 给出推荐选项和避坑 |
| 模型接入 | 需要自行整理 | 直接给可复制的 models 配置 |
| 验证步骤 | 需要自行摸索 | 提供最短验证命令路径 |
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemoniwr -useb https://openclaw.ai/install.ps1 | iex
openclaw onboard- OpenClaw 官网：https://openclaw.ai/
- OpenClaw 项目：https://github.com/openclaw/openclaw
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemoniwr -useb https://openclaw.ai/install.ps1 | iex
openclaw onboard执行 openclaw onboard 期间，建议按下列方式选择：
- 风险提示：
yes - 安装模式：
快速安装 - 模型配置：先
跳过 - Provider 筛选：可先选
Google - 机器人配置：先
跳过 - skills 包：
yes - skills 安装方式：
pnpm - skills 的模型 key：先全部
No
本教程里的 AICodeMirror，本质上是一个模型 API 中转层（relay/proxy），不是模型本体。
使用中转站的核心原因：
- 可用性：某些地区或网络环境下，直连原厂接口不稳定，中转层通常更稳。
- 统一接入：用一套配置同时接
Claude/GPT/Gemini，减少多供应商对接成本。 - 切换效率：从一个模型切到另一个模型，只改 provider/model，不用重写整套流程。
- 运维效率：在网关和 key 管理上更集中，便于排查问题。
你需要明确的代价/风险：
- 数据与信任边界：请求会经过第三方中转，必须确认其日志策略和隐私条款。
- 成本结构：中转服务可能有额外加价或限流策略。
- 供应商依赖：中转层故障会影响可用性，需要预案。
什么时候建议不用中转站：
- 你所在环境可以稳定直连原厂 API，且不需要多模型统一接入。
- 你的组织有严格合规要求，只允许直接对接模型厂商。
选中转站的最小检查清单：
- 是否明确声明“是否存日志、存多久、如何删除”。
- 是否支持 API Key 轮换和最小权限控制。
- 是否有可观察性（错误码、调用日志、限流提示）。
- 是否有回退方案（可快速切回直连或备用中转）。
把 config/openclaw.models.json 的内容合并到你的 openclaw.json 里 models.providers 节点。
- MacOS/Linux 路径：
~/.openclaw/openclaw.json - Windows 路径：
C:\Users\你的用户名\.openclaw\openclaw.json - 配置文件模板：
config/openclaw.models.json
请把配置中的
换成你的key改成你自己的真实 API Key。
- MacOS/Linux：
openclaw gateway restart- Windows：
openclaw gateway/models
/models aicodemirror-claude
/model aicodemirror-claude/claude-opus-4-5-20251101
你好
如果模型能正常回复，即配置成功。
- 在 Telegram 找
BotFather，执行/newbot获取 Bot Token。 - 打开本地网关
Config -> Channels -> Telegram Bot Token，填入 Token。 - 配置本地代理（示例：
http://127.0.0.1:7890）。 - 获取 Pairing code 后执行：
openclaw pairing approve telegram 你的配对code- 回到 Telegram 对话机器人，验证联通性。
- 已提供可直接使用的中英文推广文案：
docs/launch-copy.md - 覆盖平台：
X、Reddit、Hacker News
- 检查
openclaw.json结构是否正确（尤其是models.providers层级）。 - 检查
apiKey是否已替换。 - 检查是否重启网关。
- 检查网络代理配置。
- 检查 provider 的
api字段是否与模板一致。 - 检查模型 id 是否拼写正确。
- 确认在
PowerShell中执行，而不是 CMD。 - 尝试使用管理员权限重新执行。
- MacOS/Linux： https://furbox.yuque.com/org-wiki-furbox-spmbkw/oishf7/lpqfodgg3qwhxbsa
- Windows： https://furbox.yuque.com/org-wiki-furbox-spmbkw/oishf7/lzsgqkrtgit6eo17
如果这份教程对你有帮助，欢迎点个 Star： https://github.com/AIPMAndy/openclaw-install-guide