OpenClaw Setup

Use This Workflow

1. Prepare Linux runtime and install OpenClaw.
2. Discover channels from official docs (required for new channel requests).
3. Install and verify channel integrations.
4. Create/merge

   ~/.openclaw/openclaw.json

   .
5. Configure and start gateway service.
6. Run health checks and collect logs.

Prerequisites

• SSH access to target Linux host (Debian/Ubuntu preferred).
• DingTalk enterprise app credentials (

  AppKey

  ,

  AppSecret

  ,

  AgentId

  ,

  CorpId

  ) or Feishu app credentials (

  App ID

  ,

  App Secret

  ) or Discord bot token.
• DashScope API key.

Step 1: Prepare Runtime

ssh root@<server>
curl -fsSL https://deb.nodesource.com/setup_20.x | bash -
apt-get install -y nodejs
node --version
npm --version

Step 2: Install OpenClaw and Channel Integrations

npm install -g openclaw@latest
openclaw --version

# DingTalk channel
openclaw plugins install @soimy/dingtalk
openclaw plugins list | grep dingtalk

# Feishu channel
openclaw plugins install @openclaw/feishu
openclaw plugins list | grep feishu

# Discord channel (built-in, no extra plugin needed)
# Configure token in Step 3 and start gateway in Step 4

cd ~/.openclaw/extensions/dingtalk
npm install dingtalk-stream axios form-data zod --save

Step 3: Auto-Discover Additional Channels from Official Docs

1. Open

   https://docs.openclaw.ai/channels/index

   .
2. Identify requested channel pages from the "Supported channels" list.
3. Open each channel page and extract:
   • Whether it is built-in or plugin-based.
   • Exact install command (do not guess package names).
   • Required credentials/tokens and config keys.
4. Apply installation/configuration on host.
5. Record channel-specific notes into

   ~/.openclaw/openclaw.json

   .

Step 4: Configure

openclaw.json

~/.openclaw/openclaw.json

• models.providers.bailian

  for DashScope endpoint and models.

• agents.defaults.model.primary

  in

  provider/model

  format.

• channels.dingtalk

  ,

  channels.feishu

  , or

  channels.discord

  credentials and policy.

• plugins.allow

  including installed channel plugins.

Step 5: Install and Start Gateway

openclaw gateway install
openclaw gateway start
openclaw gateway status

systemctl --user daemon-reload
systemctl --user restart openclaw-gateway

Step 6: Verify and Troubleshoot

openclaw doctor
openclaw gateway status
openclaw gateway logs -f

• Plugin not loaded: re-run plugin install and check

  plugins.allow

  .
• Unknown model: check

  agents.defaults.model.primary

  format (

  provider/model-id

  ).
• API key error: verify

  models.providers.bailian.apiKey

  .
• DingTalk no response: check app publish status and required permissions.
• Feishu no response: check event subscription mode is WebSocket and gateway is running.
• Discord no response: verify bot intents, token, and first-DM pairing approval.

Security Notes

• Do not hardcode real secrets in repository files.
• Keep production keys in server-local configs or secret managers.
• Redact logs before sharing in tickets or chat.