AIGoCode Docs
Agent工具接入

OpenClaw

使用 OpenAI、Claude 或 Gemini 模型将 OpenClaw 接入 AIGoCode

先完成安装和基础设置，再从 OpenAI、Claude、Gemini 中选择一种接入方式，即可通过 OpenClaw Dashboard 使用 AIGoCode。

1. 安装并进入配置向导

如果还没有安装 OpenClaw，根据系统运行官方安装命令。安装完成后会自动进入配置向导。

在 PowerShell 中运行：

PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex

在 Cmd 中运行：

Cmd
powershell -NoProfile -ExecutionPolicy Bypass -Command "& ([scriptblock]::Create((irm https://openclaw.ai/install.ps1)))"

在终端中运行：

Terminal
curl -fsSL https://openclaw.ai/install.sh | bash

如果已经安装 OpenClaw，运行下面的命令重新进入配置向导：

Terminal
openclaw onboard --install-daemon

2. 完成基础设置

进入配置向导后，按下面的方式选择：

  1. Continue? 选择 Yes。

确认继续

  1. Help make OpenClaw better? 选择 No thanks。

不发送使用统计

  1. Setup mode 选择 QuickStart。

选择 QuickStart

  1. Agent 名称保持默认的 main，直接按 Enter。

使用默认 Agent 名称

  1. Model/auth provider 选择 Skip for now。

暂时跳过模型配置

  1. Default model 选择 Keep current。这里显示的模型名称不同也没关系，后面会重新写入 AIGoCode 配置。

保持当前默认模型

  1. Select channel 选择 Skip for now。

暂时跳过消息频道

  1. Search provider 选择 Skip for now。

暂时跳过搜索服务

  1. Install missing skill dependencies 选择 Skip for now。这是多选页面，需要先按 Space 选中，再按 Enter 提交。

暂时跳过 Skill 依赖

其余设置保持默认，或选择 Skip for now。

AIGoCode 是自定义 Provider，因此先跳过内置模型配置，下一步再写入 AIGoCode 的 Key 和请求地址。

下面三种接入方式使用不同的 Provider 名称。你可以只配置一种，也可以继续配置其他模型；后续配置不会覆盖已经添加的模型。

3. OpenAI 接入

  1. 前往 AIGoCode API Key 页面，选择 Codex（可外接） 分组并创建 API Key。

选择 Codex（可外接）分组

  1. 根据你的系统选择对应命令，把其中的 sk-your-api-key 换成刚创建的 API Key，再将整段命令复制到终端运行。
PowerShell
@'
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "aigocode-openai/gpt-6-astra"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "aigocode-openai": {
        "baseUrl": "https://api.aigocode.app/v1",
        "apiKey": "sk-your-api-key",
        "api": "openai-responses",
        "models": [
          {
            "id": "gpt-6-astra",
            "name": "GPT-6 Astra"
          }
        ]
      }
    }
  }
}
'@ | openclaw config patch --stdin
Cmd
echo {"agents":{"defaults":{"model":{"primary":"aigocode-openai/gpt-6-astra"}}},"models":{"mode":"merge","providers":{"aigocode-openai":{"baseUrl":"https://api.aigocode.app/v1","apiKey":"sk-your-api-key","api":"openai-responses","models":[{"id":"gpt-6-astra","name":"GPT-6 Astra"}]}}}} | call openclaw config patch --stdin
Terminal
cat <<'EOF' | openclaw config patch --stdin
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "aigocode-openai/gpt-6-astra"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "aigocode-openai": {
        "baseUrl": "https://api.aigocode.app/v1",
        "apiKey": "sk-your-api-key",
        "api": "openai-responses",
        "models": [
          {
            "id": "gpt-6-astra",
            "name": "GPT-6 Astra"
          }
        ]
      }
    }
  }
}
EOF

4. Claude 接入

  1. 前往 AIGoCode API Key 页面，选择 Claude Code（可外接） 分组并创建 API Key。

选择 Claude Code（可外接）分组

  1. 根据你的系统选择对应命令，把其中的 sk-your-api-key 换成刚创建的 API Key，再将整段命令复制到终端运行。
PowerShell
@'
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "aigocode-claude/claude-sonnet-5"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "aigocode-claude": {
        "baseUrl": "https://api.aigocode.app",
        "apiKey": "sk-your-api-key",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-sonnet-5",
            "name": "Claude Sonnet 5"
          }
        ]
      }
    }
  }
}
'@ | openclaw config patch --stdin
Cmd
echo {"agents":{"defaults":{"model":{"primary":"aigocode-claude/claude-sonnet-5"}}},"models":{"mode":"merge","providers":{"aigocode-claude":{"baseUrl":"https://api.aigocode.app","apiKey":"sk-your-api-key","api":"anthropic-messages","models":[{"id":"claude-sonnet-5","name":"Claude Sonnet 5"}]}}}} | call openclaw config patch --stdin
Terminal
cat <<'EOF' | openclaw config patch --stdin
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "aigocode-claude/claude-sonnet-5"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "aigocode-claude": {
        "baseUrl": "https://api.aigocode.app",
        "apiKey": "sk-your-api-key",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-sonnet-5",
            "name": "Claude Sonnet 5"
          }
        ]
      }
    }
  }
}
EOF

5. Gemini 接入

  1. 前往 AIGoCode API Key 页面，选择 Gemini 分组并创建 API Key。

选择 Gemini 分组

  1. 根据你的系统选择对应命令，把其中的 sk-your-api-key 换成刚创建的 API Key，再将整段命令复制到终端运行。
PowerShell
@'
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "aigocode-gemini/gemini-3.8-flash"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "aigocode-gemini": {
        "baseUrl": "https://api.aigocode.app/v1beta",
        "apiKey": "sk-your-api-key",
        "api": "google-generative-ai",
        "models": [
          {
            "id": "gemini-3.8-flash",
            "name": "Gemini 3.8 Flash"
          }
        ]
      }
    }
  }
}
'@ | openclaw config patch --stdin
Cmd
echo {"agents":{"defaults":{"model":{"primary":"aigocode-gemini/gemini-3.8-flash"}}},"models":{"mode":"merge","providers":{"aigocode-gemini":{"baseUrl":"https://api.aigocode.app/v1beta","apiKey":"sk-your-api-key","api":"google-generative-ai","models":[{"id":"gemini-3.8-flash","name":"Gemini 3.8 Flash"}]}}}} | call openclaw config patch --stdin
Terminal
cat <<'EOF' | openclaw config patch --stdin
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "aigocode-gemini/gemini-3.8-flash"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "aigocode-gemini": {
        "baseUrl": "https://api.aigocode.app/v1beta",
        "apiKey": "sk-your-api-key",
        "api": "google-generative-ai",
        "models": [
          {
            "id": "gemini-3.8-flash",
            "name": "Gemini 3.8 Flash"
          }
        ]
      }
    }
  }
}
EOF

6. 检查配置

完成任意一种接入配置后，运行下面的命令检查配置：

Terminal
openclaw config validate
openclaw config get agents.defaults.model.primary

看到 Config valid，并且第二条命令显示刚配置的模型，即表示配置已经写入：

  • OpenAI：aigocode-openai/gpt-6-astra
  • Claude：aigocode-claude/claude-sonnet-5
  • Gemini：aigocode-gemini/gemini-3.8-flash

配置格式验证成功

7. 打开 Dashboard 验证

重新启动 Gateway，再打开 Dashboard：

Terminal
openclaw gateway restart
openclaw dashboard

浏览器打开后：

  1. 新建一个会话。
  2. 点击输入框下方的模型名称，选择刚配置的模型。
  3. 发送一条消息。

最后配置的模型会成为新会话的默认模型；已有会话可能继续使用此前选中的模型，因此验证时需要新建会话或手动切换。

在 Dashboard 选择模型并验证回复

OpenClaw 能正常回复，并且 AIGoCode 的用量记录中出现了对应模型的请求，即表示接入成功。

OpenClaw 成功回复消息

如果请求返回 401、403、429，请查看 错误码。如果模型不可用，请确认 API Key 来自对应分组，并检查 Key 和请求地址。

OpenCode

通过全局配置文件将 OpenCode 接入 AIGoCode

Hermes

安装 Hermes，配置 AIGoCode API Key，并发送第一条消息

On this page

1. 安装并进入配置向导2. 完成基础设置3. OpenAI 接入4. Claude 接入5. Gemini 接入6. 检查配置7. 打开 Dashboard 验证