OpenClaw Setup
Deploy OpenClaw on Linux, enable DingTalk, Feishu, Discord, or other documented channels, and verify gateway health.
Use This Workflow
Run this sequence in order:
- Prepare Linux runtime and install OpenClaw.
- Discover channels from official docs (required for new channel requests).
- Install and verify channel integrations.
- Create/merge
~/.openclaw/openclaw.json
- Configure and start gateway service.
- Run health checks and collect logs.
Prerequisites
- SSH access to target Linux host (Debian/Ubuntu preferred).
- DingTalk enterprise app credentials (, , , ) or Feishu app credentials (, ) or Discord bot token.
- DashScope API key.
Step 1: Prepare Runtime
bash
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
bash
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
If plugin dependencies are missing:
bash
cd ~/.openclaw/extensions/dingtalk
npm install dingtalk-stream axios form-data zod --save
Step 3: Auto-Discover Additional Channels from Official Docs
When user asks for any extra channel beyond current setup, do this first:
- Open
https://docs.openclaw.ai/channels/index
- Identify requested channel pages from the "Supported channels" list.
- 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.
- Apply installation/configuration on host.
- Record channel-specific notes into
~/.openclaw/openclaw.json
Use the exact workflow in references/channel-discovery.md.
Step 4: Configure
Create or update
~/.openclaw/openclaw.json
with:
- for DashScope endpoint and models.
agents.defaults.model.primary
- , , or credentials and policy.
- including installed channel plugins.
Use the full template in references/config.md.
Use DingTalk field mapping in references/dingtalk-setup.md.
Use Feishu setup and field mapping in references/feishu-setup.md.
Use Discord setup and field mapping in references/discord-setup.md.
Use channel discovery workflow in references/channel-discovery.md.
Step 5: Install and Start Gateway
bash
openclaw gateway install
openclaw gateway start
openclaw gateway status
If running with user-level systemd, reload after config changes:
bash
systemctl --user daemon-reload
systemctl --user restart openclaw-gateway
Step 6: Verify and Troubleshoot
bash
openclaw doctor
openclaw gateway status
openclaw gateway logs -f
Common failures:
- Plugin not loaded: re-run plugin install and check .
- Unknown model: check
agents.defaults.model.primary
- 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.