Skip to content

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 和 bun):
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" }
        ]
      }
    }
  }
}
  • 配置完成后,启动 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.
  • 切换模型
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