Skip to main content

Troubleshooting

This document helps you solve common issues when using OpenHuman.

Authentication Issues​

Invalid API Key​

Symptoms: Returns 401 Unauthorized when calling API

Solution:

  1. Check if API key is set correctly
  2. Confirm the key has not expired
  3. Verify environment variable configuration
echo $OPENHUMAN_API_KEY

OAuth Connection Failed​

Symptoms: Error when integrating OAuth connection

Solution:

  1. Confirm the integrated service account is not blocked
  2. Check OAuth scopes permissions
  3. Re-authorize the integration

Network Issues​

Request Timeout​

Symptoms: API request times out

Solution:

  1. Check network connection
  2. Increase timeout configuration
  3. Use retry mechanism
const client = new OpenHuman({
  apiKey: process.env.OPENHUMAN_API_KEY,
  timeout: 60000,  // 60 seconds
});

Cannot Connect to Remote Core​

Symptoms: Remote core connection fails

Solution:

  1. Confirm remote core URL is accessible
  2. Verify token correctness
  3. Check firewall settings
curl -I https://your-core.example/rpc

Memory Tree Issues​

Inaccurate Memory Retrieval​

Symptoms: recall returns irrelevant results

Solution:

  1. Use more precise query terms
  2. Specify scope to narrow the range
  3. Check if memory was stored correctly
const memories = await client.memory.recall({
  query: 'What topics is the user interested in',
  scope: 'user_preference',
  limit: 5,
});

Memory Storage Failed​

Symptoms: store operation fails

Solution:

  1. Check disk space
  2. Confirm database file is not corrupted
  3. Verify write permissions

Tool Issues​

Tool Call Failed​

Symptoms: Error during tool execution

Solution:

  1. Check if tool parameters are correct
  2. Confirm network connection is normal
  3. View specific error message
try {
  const result = await client.tools.execute('web-search', {
    query: 'test',
  });
} catch (error) {
  console.error('Tool error:', error.message);
}

Browser Control Not Responding​

Symptoms: Browser control operation has no response

Solution:

  1. Confirm CEF browser is installed
  2. Check if browser process is running
  3. Restart browser control session

Performance Issues​

Slow Response​

Symptoms: Agent response time is too long

Solution:

  1. Reduce context length
  2. Use streaming responses
  3. Consider using a lighter model

High Token Usage​

Symptoms: Token consumption exceeds expectations

Solution:

  1. Enable token compression
  2. Reduce historical messages
  3. Limit recall return count

Deployment Issues​

Docker Container Failed to Start​

Symptoms: Container cannot start

Solution:

  1. Check if port is in use
  2. Verify environment variable configuration
  3. View container logs
docker logs openhuman-container

Cloud Deployment Connection Failed​

Symptoms: Cannot connect after cloud deployment

Solution:

  1. Confirm security group rules configuration
  2. Check domain DNS resolution
  3. Verify SSL certificate

Getting Help​

If the problem is still not resolved:

  1. Check GitHub Issues
  2. Refer to Official Documentation
  3. Join community discussion