Skip to content

OpenClaw Specifics

What is OpenClaw? How to install?

OpenClaw Gateway is an AI proxy gateway that connects AI models via channels like Feishu, Telegram, and Discord. After launch, the default Web UI is at http://127.0.0.1:18789/.

bash
# Install
npm install -g openclaw@latest

# Onboarding
openclaw onboard --install-daemon

During onboarding, choose QuickStart → skip provider selection → select all models → keep the default model → choose notification channels (Feishu/TG/Discord) → configure Skills and Hooks (recommend checking session-memory).

OpenClaw returns 403 block when configuring a provider

As an external client, OpenClaw must configure each provider's group and User-Agent separately.

Claude provider

API endpoint: https://your-request-address
API protocol: Anthropic Messages
Headers:
  "Authorization": "Bearer sk-***"
  "User-Agent": "claude-cli/2.0.76 (external, cli)"

Codex provider

API endpoint: https://your-request-address/v1
API protocol: OpenAI Responses
Headers:
  "Authorization": "Bearer sk-***"
  "User-Agent": "codex_cli_rs/0.77.0 (Windows 10.0.26100; x86_64) WindowsTerminal"

Domestic model provider

Headers:
  "Authorization": "Bearer sk-***"
  "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:149.0) Gecko/20100101 Firefox/149.0"

Key reminder: don't reuse Claude's UA for a Codex provider, and don't omit the browser-type UA for a domestic-model provider.

Can one OpenClaw instance serve multiple models at once?

Yes. One OpenClaw can serve Claude and Codex simultaneously, and domestic models too. But each provider must select its own group and fill its own User-Agent — don't mix them.

OpenClaw Feishu channel setup essentials

  1. Go to open.feishu.cn, create a self-built enterprise app, and add the bot capability
  2. In permission management, filter im and select all related permissions
  3. Create and publish a version; record the App ID and App Secret
  4. Enter the App ID and App Secret in the OpenClaw onboarding UI, or via CLI:
bash
openclaw config set -- channels.feishu.appId "your-AppID"
openclaw config set -- channels.feishu.appSecret "your-AppSecret"
  1. On the Feishu open platform, go to the event configuration page and add the "Receive messages" event
  2. Create and publish a new version again (otherwise the event subscription won't take effect)
  3. Find the bot in the Feishu workspace, send a message, get the pairing code, then run:
bash
openclaw pairing approve feishu your-pairing-code

Note: OpenClaw must be running when configuring the Feishu event subscription; start it manually with openclaw gateway.

How to choose OpenClaw's group message reply policy?

  • Reply to all messages: good for a private test group
  • Reply only when @-mentioned: good for multi-person work groups (recommended)
  • Don't reply in groups: private chat only