OpenAi-HK

简体中文

English

简体中文

English

Appearance

OpenClaw 龙虾 ​

OpenClaw 是一款开源的个人 AI 助手，可以部署在自己的设备上，通过 WhatsApp、Telegram、Slack、Discord 等 20+ 消息渠道与你的 AI 交互。它像一个统一的 AI 入口，无论你在哪个平台，都能随时与 AI 对话。

特性 ​

  • 多渠道接入:支持 WhatsApp、Telegram、Slack、Discord 等 20+ 消息渠道
  • 自定义模型:支持 OpenAI / Claude / Gemini 等多模型切换，可接入第三方 API
  • 语音交互:macOS/iOS/Android 支持语音唤醒和持续对话
  • 浏览器控制: 内置 Chrome 控制，可浏览网页、截图、填表单
  • 工具扩展: 支持 Skills 插件系统，可扩展各种能力
  • 数据安全: 数据存储在本地，保障隐私安全

安装与配置 ​

安装前，请确保

  • 已安装 Node.js 22+
  • 获取 openai-hk 的 API Key hk-your-key

安装 OpenClaw ​

  • 使用 npm 全局安装 OpenClaw（也支持 pnpm 和 yarn）：
shell
npm install -g openclaw@latest
npm install -g openclaw@latest
  • 安装完成后验证：
shell
openclaw --version
openclaw --version

如果看到版本号输出（如 2026.2.25），说明安装成功

运行引导向导（不推荐） ​

OpenClaw 提供了一个交互式向导，适合首次安装：

shell
openclaw onboard --install-daemon
openclaw onboard --install-daemon

TIP

由于 Open-HK 是第三方代理，向导中的内置 Provider 列表不会直接包含 Open-HK。建议跳过向导的模型配置步骤，在第三步手动编辑配置文件。向导主要用于安装守护进程和配置消息渠道。

配置 HK 作为模型 Provider ​

  • 配置 Open-HK 作为模型 Provider
  • 编辑配置文件 ~/.openclaw/openclaw.json ; 配置 key 选择不同的组汇率不一，优惠程度不一
json
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "hk-claude/claude-sonnet-4-6"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "open-hk": {
        "baseUrl": "https://api.open-hk.com/v1",
        "apiKey": "hk-your-key",
        "api": "openai-completions",
        "models": [
          {
            "id": "deepseek-v3.2",
            "name": "DeepSeek-V3.2"
          }
        ]
      },
      "hk-claude": {
        "baseUrl": "https://api.open-hk.com",
        "apiKey": "hk-your-key",
        "api": "anthropic-messages",
        "models": [
          { "id": "claude-opus-4-6", "name": "Claude Opus 4.6" },
          { "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }
        ]
      }
    }
  }
}
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "hk-claude/claude-sonnet-4-6"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "open-hk": {
        "baseUrl": "https://api.open-hk.com/v1",
        "apiKey": "hk-your-key",
        "api": "openai-completions",
        "models": [
          {
            "id": "deepseek-v3.2",
            "name": "DeepSeek-V3.2"
          }
        ]
      },
      "hk-claude": {
        "baseUrl": "https://api.open-hk.com",
        "apiKey": "hk-your-key",
        "api": "anthropic-messages",
        "models": [
          { "id": "claude-opus-4-6", "name": "Claude Opus 4.6" },
          { "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }
        ]
      }
    }
  }
}

  • 文档配置说明：

    • models.providers.open-hk 为 驱动提供者名称
    • models.providers.open-hk.api 为 api 格式 主要是 openai-completions openai 对话格式 / anthropic-messages claude 消息格式
    • models.providers.open-hk.baseUrl 为 请求的基础 URL 主要是 https://api.openai.com/v1 openai 对话格式 / https://api.open-hk.com claude 消息格式
    • models.providers.open-hk.apiKey 在 openai-hk.com 申请的 apiKey
    • models.providers.open-hk.models 为该提供者的模型列表，可以在 openai-hk.com 查看，把模型 id 填入即可

  • 配置完成后，启动 Gateway：

shell
openclaw gateway --port 18789 --verbose
openclaw gateway --port 18789 --verbose

看到类似以下输出表示启动成功：

[Gateway] Listening on ws://127.0.0.1:18789
[Gateway] Provider "hk-claude" connected (model: claude-sonnet-4-6)
[Gateway] Ready.
[Gateway] Listening on ws://127.0.0.1:18789
[Gateway] Provider "hk-claude" connected (model: claude-sonnet-4-6)
[Gateway] Ready.
  • 切换模型 格式为 提供者/模型 id 比如 open-hk/deepseek-v3.2 hk-claude/claude-opus-4-6
shell
openclaw models set hk-claude/claude-sonnet-4-6
openclaw models set hk-claude/claude-opus-4-6
openclaw models set hk-claude/claude-sonnet-4-6
openclaw models set hk-claude/claude-opus-4-6

或者

shell
openclaw models set open-hk/deepseek-v3.2
openclaw models set open-hk/deepseek-v3.2
  • 查询模型
shell
openclaw models list
openclaw models list

显示如下

Model                                      Input      Ctx      Local Auth  Tags
hk-claude/claude-sonnet-4-6                text       195k     no    yes   default,configured
open-hk/deepseek-v3.2                      text       195k     no    yes   configured
hk-claude/claude-opus-4-6                  text       195k     no    yes   configured
Model                                      Input      Ctx      Local Auth  Tags
hk-claude/claude-sonnet-4-6                text       195k     no    yes   default,configured
open-hk/deepseek-v3.2                      text       195k     no    yes   configured
hk-claude/claude-opus-4-6                  text       195k     no    yes   configured